配置位置速查

配置类型 路径 用途
全局配置 ~/.config/opencode/opencode.json 主配置（权限、插件、Provider）
鉴权配置 ~/.local/share/opencode/auth.json API Keys 认证信息
行为规范 ~/.config/opencode/AGENTS.md Agent 行为定义
插件配置 ~/.config/opencode/oh-my-opencode.json oh-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-opencode@latest"
  ],
  "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"
      }
    }
  }
}

配置项说明:

字段 类型 说明
formatter boolean 是否启用代码格式化
permission object 权限控制配置
permission.* string 全局默认权限（allow/ask/deny）
permission.bash object Bash 命令权限控制
permission.read object 文件读取权限控制
plugin array 插件列表
provider object AI Provider 配置
provider.default object 默认 Provider 配置
provider.<name>.options.baseURL string API 代理地址

1.2 AGENTS.md（行为规范配置）

路径: ~/.config/opencode/AGENTS.md

作用: 定义 Agent 的行为规范、编程原则、危险操作确认机制等。

核心内容:

  1. 编程原则

    • KISS（简单至上）: 追求极致简洁，拒绝不必要复杂性
    • YAGNI（精益求精）: 仅实现当前所需功能
    • DRY（杜绝重复）: 自动识别重复模式，统一实现
    • SOLID 原则: 单一职责、开闭原则、里氏替换、接口隔离、依赖倒置

  2. 危险操作确认机制

    • 文件系统删除操作
    • Git 提交/推送操作
    • 数据库结构变更
    • 生产环境 API 调用

  3. 语言偏好

    • 对话、解释、说明使用中文
    • 代码注释、文档使用中文
    • 禁止使用表情符号

  4. Python 环境规则

    • 必须使用项目根目录的 uv 环境
    • 安装依赖: uv sync
    • 添加包: uv add <package-name>
    • 运行脚本: uv run python <script.py>

1.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>.model Agent 使用的模型
agents.<name>.variant 模型变体（max/high/medium/low）
categories 任务类别的模型配置
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-name> Provider 标识名称
type 认证类型（api/oauth）
key API Key 或 Token

管理命令

# 查看已配置的 providers
opencode auth list

# 登录/添加 provider
opencode auth login <provider-url>

# 登出
opencode auth logout

4. 数据存储目录

路径

~/.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.json API Keys 认证信息
bin/ OpenCode CLI 二进制
log/ 运行日志
opencode.db 主数据库（会话、消息、Todo 等）
snapshot/ 状态快照
storage/ 持久化数据存储
tool-output/ 工具执行结果缓存

5. 常用命令

Auth 管理

# 列出所有已配置的 providers
opencode auth list

# 登录/添加 API Key
opencode auth login

# 登出
opencode auth logout

配置管理

# 查看配置文件
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. 配置优先级

项目级配置 > 用户级全局配置 > 默认配置

优先级从高到低：

  1. 项目目录: <项目目录>/.opencode/
  2. 全局配置: ~/.config/opencode/
  3. 默认配置: OpenCode 内置默认值
文件 职责 内容
~/.config/opencode/opencode.json 配置 仅保留 provider 的 baseURL 和 npm 设置
~/.local/share/opencode/auth.json 密钥管理 包含 anthropic、openai、kimi 等所有 API 密钥
配置层级说明（根据官方文档）：
  1. auth.json 中的密钥由 /connect 命令管理，是官方推荐的密钥存储方式
  2. opencode.json 中的 provider.options 用于设置 baseURL 等连接参数
  3. opencode 启动时会自动合并这两个文件的配置
# chrome
Logo
2048 AI社区

有“AI”的1024 = 2048，欢迎大家加入2048 AI社区

更多推荐

GEO推广服务深度解读：AI搜索时代的企业流量新范式

GEO推广服务并非短期的流量手段，而是企业适应AI搜索时代的系统性能力升级。它要求企业从“建设网站”转向“构建知识体系”，从“购买流量”转向“被AI引用”。面对技术变革，企业唯有以系统化思维、专业化运营和持续迭代，才能在智能搜索时代掌握增长主动权。这不仅是营销领域的变革，更是企业数字能力的全面重塑。你，准备好了吗？

avatar 2048 AI社区
cover

GPT刚更新Claude和Gemini也在卷开发者到底该选哪个

avatar 2048 AI社区

数据驱动决策・AI 赋能增长

数据驱动决策・AI 赋能增长可以和我详聊需求

avatar 2048 AI社区