OpenCode 集成

本页整理自 CodexZH「OpenCode 集成配置」教程，适合已经在使用 OpenCode 的同学直接接入 CodexZH。

1. 找到 OpenCode 配置文件

• macOS / Linux：~/.config/opencode/opencode.json
• Windows：C:\Users\你的用户名\.config\opencode\opencode.json

2. 在 provider 中添加 CodexZH

在 opencode.json 的 provider 配置项中添加（或合并）以下内容，并把 apiKey 替换为你的真实 sk- 密钥：

{
  "provider": {
    "codexzh": {
      "npm": "@ai-sdk/openai",
      "name": "codexzh",
      "options": {
        "baseURL": "https://api.codexzh.com/v1",
        "apiKey": "sk-替换成你自己的 key",
        "options": {
          "reasoningEffort": "high",
          "textVerbosity": "low",
          "reasoningSummary": "auto"
        }
      },
      "models": {
        "gpt-5.2": { "name": "gpt-5.2" },
        "gpt-5.2-codex": { "name": "gpt-5.2-codex" }
      }
    }
  }
}

3. 重启 OpenCode

CodexZH 教程提示：配置完成后需要重启 OpenCode 才能生效。

4. 常见问题

• 启动后仍旧不生效：优先检查 opencode.json 是否是合法 JSON（尤其是逗号、引号、括号）。
• 提示鉴权失败：确认 apiKey 是否复制完整，且账号已激活。