OpenCode 集成

⚠️ 重要：GPT 模型请使用 Responses API

OpenCode 通过 @ai-sdk/openai 接入 GPT 模型时，底层使用的是 Responses API（POST /v1/responses），这是 OpenAI 推荐的新协议。

配置时注意两点：

1. provider 必须写 openai（不能写其他名字）
2. 必须设置 "setCachekey": true，否则缓存失效、额度浪费

@ai-sdk/openai 会自动使用 Responses API 与兼容该协议的中转端点通信，你无需手动切换端点。

1. 找到 OpenCode 配置文件

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

2. 在 provider 中添加 CodexZH

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

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

3. 重启 OpenCode

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

4. 选择codexzh 中的 gpt-5.4 模型

在 OpenCode 中选择 codexzh 作为提供者，然后选择 gpt-5.4 模型即可使用。

5. 常见问题

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