配置位置速查配置类型路径用途全局配置~/.config/opencode/opencode.json主配置权限、插件、Provider鉴权配置~/.local/share/opencode/auth.jsonAPI Keys 认证信息行为规范~/.config/opencode/AGENTS.mdAgent 行为定义插件配置~/.config/opencode/oh-my-opencode.jsonoh-my-opencode 插件配置技能定义~/.config/opencode/skills/技能脚本目录项目配置项目目录/.opencode/项目级配置1. 全局配置目录路径~/.config/opencode/目录结构.config/opencode/ ├── opencode.json # 主配置文件 ├── oh-my-opencode.json # oh-my-opencode 插件配置 ├── oh-my-opencode.jsonc # 带注释的插件配置备份 ├── AGENTS.md # Agent 行为规范 ├── package.json # 依赖声明 ├── bun.lock # 依赖锁定文件 ├── node_modules/ # 依赖包 └── skills/ # 技能目录 ├── explore/ ├── librarian/ ├── sisyphus/ ├── oracle/ ├── frontend-engineer/ ├── multimodal-looker/ ├── document-writer/ ├── pdf/ ├── ssh-lite-inspect/ ├── planning-with-files/ ├── mermaid-visualizer/ ├── excalidraw-diagram/ ├── omo-agents/ ├── long-running-agent/ ├── mcpstore-test-skill/ └── doc/1.1 opencode.json主配置文件路径:~/.config/opencode/opencode.json作用: 定义 OpenCode 的核心行为包括权限控制、插件加载、AI Provider 配置等。配置格式:{$schema:https://opencode.ai/config.json,formatter:false,permission:{*:allow,bash:{*:allow,rm *:ask,rm -r *:ask,rm -rf *:ask,rmdir *:ask,unlink *:ask},doom_loop:ask,external_directory:{*:allow},read:{*:allow,*.env:allow,*.env.*:allow}},plugin:[oh-my-opencodelatest],provider:{anthropic:{options:{baseURL:https://relay01.gaccode.com/claudecode/v1}},default:{models:{},npm:ai-sdk/anthropic,options:{apiKey:your-api-key}},openai:{options:{baseURL:https://relay01.gaccode.com/codex/v1}}}}配置项说明:字段类型说明formatterboolean是否启用代码格式化permissionobject权限控制配置permission.*string全局默认权限allow/ask/denypermission.bashobjectBash 命令权限控制permission.readobject文件读取权限控制pluginarray插件列表providerobjectAI Provider 配置provider.defaultobject默认 Provider 配置provider.name.options.baseURLstringAPI 代理地址1.2 AGENTS.md行为规范配置路径:~/.config/opencode/AGENTS.md作用: 定义 Agent 的行为规范、编程原则、危险操作确认机制等。核心内容:编程原则KISS简单至上: 追求极致简洁拒绝不必要复杂性YAGNI精益求精: 仅实现当前所需功能DRY杜绝重复: 自动识别重复模式统一实现SOLID 原则: 单一职责、开闭原则、里氏替换、接口隔离、依赖倒置危险操作确认机制文件系统删除操作Git 提交/推送操作数据库结构变更生产环境 API 调用语言偏好对话、解释、说明使用中文代码注释、文档使用中文禁止使用表情符号Python 环境规则必须使用项目根目录的uv环境安装依赖:uv sync添加包:uv add package-name运行脚本:uv run python script.py1.3 oh-my-opencode.json插件配置路径:~/.config/opencode/oh-my-opencode.json作用: 配置 oh-my-opencode 插件的 Agent 模型和任务类别模型。配置格式:{$schema:https://raw.githubusercontent.com/code-yeongyu/oh-my-opencode/master/assets/oh-my-opencode.schema.json,agents:{sisyphus:{model:anthropic/claude-opus-4-6,variant:max},oracle:{model:openai/gpt-5.2,variant:high},librarian:{model:anthropic/claude-sonnet-4-6},explore:{model:anthropic/claude-haiku-4-5},metis:{model:anthropic/claude-opus-4-6,variant:max},momus:{model:openai/gpt-5.2,variant:medium}},categories:{visual-engineering:{model:anthropic/claude-opus-4-6,variant:max},ultrabrain:{model:openai/gpt-5.3-codex,variant:xhigh},quick:{model:anthropic/claude-haiku-4-5},deep:{model:openai/gpt-5.3-codex,variant:medium}}}配置项说明:字段说明agents各专用 Agent 的模型配置agents.name.modelAgent 使用的模型agents.name.variant模型变体max/high/medium/lowcategories任务类别的模型配置categories.name.model该类别使用的默认模型2. 项目级配置路径~/.opencode/ 或 项目目录/.opencode/目录结构.opencode/ ├── .gitignore ├── bun.lock ├── node_modules/ │ └── opencode-ai/ └── package.json作用: 存放项目级插件依赖可覆盖全局配置。3. 鉴权配置路径~/.local/share/opencode/auth.json文件格式{anthropic:{type:api,key:sk-ant-oat01-...},openai:{type:api,key:sk-ant-oat01-...},zai-coding-plan:{type:api,key:77660921de...},minimax-cn-coding-plan:{type:api,key:sk-cp-eCJkl...}}配置项说明字段说明provider-nameProvider 标识名称type认证类型api/oauthkeyAPI Key 或 Token管理命令# 查看已配置的 providersopencode auth list# 登录/添加 provideropencode auth loginprovider-url# 登出opencode authlogout4. 数据存储目录路径~/.local/share/opencode/目录结构.local/share/opencode/ ├── auth.json # 鉴权配置 ├── bin/ # CLI 二进制文件 ├── log/ # 日志文件 ├── opencode.db # SQLite 数据库主数据 ├── opencode.db-shm # SQLite 共享内存 ├── opencode.db-wal # SQLite WAL 日志 ├── snapshot/ # 快照备份 ├── storage/ # 存储数据 │ ├── agent-usage-reminder/ │ ├── directory-readme/ │ ├── message/ │ ├── part/ │ ├── project/ │ ├── session/ │ ├── session_diff/ │ └── todo/ └── tool-output/ # 工具输出缓存目录说明目录/文件说明auth.jsonAPI Keys 认证信息bin/OpenCode CLI 二进制log/运行日志opencode.db主数据库会话、消息、Todo 等snapshot/状态快照storage/持久化数据存储tool-output/工具执行结果缓存5. 常用命令Auth 管理# 列出所有已配置的 providersopencode auth list# 登录/添加 API Keyopencode auth login# 登出opencode authlogout配置管理# 查看配置文件cat~/.config/opencode/opencode.json# 编辑主配置vim~/.config/opencode/opencode.json# 编辑行为规范vim~/.config/opencode/AGENTS.md# 查看鉴权配置cat~/.local/share/opencode/auth.json数据管理# 查看数据库大小du-sh~/.local/share/opencode/opencode.db# 查看日志ls~/.local/share/opencode/log/# 清理工具输出缓存rm-rf~/.local/share/opencode/tool-output/*6. 配置优先级项目级配置 用户级全局配置 默认配置优先级从高到低项目目录:项目目录/.opencode/全局配置:~/.config/opencode/默认配置: OpenCode 内置默认值