外接

OpenCode 配置教程

关于外接兼容性

任何第三方外接客户端，与官方接口对接时存在较多兼容性差异。本教程仅演示基础接入方式，无法保证每一个模型 / 智能体都能完美运行、零报错。如遇个别模型或功能不兼容，属正常现象，可尝试更换模型或参考官方文档调整。

优先推荐在官方推出的产品中使用对应模型。

一、打开配置目录

OpenCode 的配置目录为 .config/opencode，位于用户主目录下，配置文件是 opencode.json。请根据你的系统打开它：

Windows

按下键盘 Win + R，输入以下内容后回车：

%userprofile%\.config\opencode

macOS

open ~/.config/opencode

Linux

cd ~/.config/opencode

打开后可看到目录内容。如果目录中没有 opencode.json，需要手动创建后打开。

二、编辑 opencode.json

将以下内容写入 opencode.json：

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "cctq-codex": {
      "models": {
        "gpt-5.6-sol": {
          "name": "gpt-5.6-sol",
          "options": {
            "reasoningEffort": "xhigh"
          }
        }
      },
      "npm": "@ai-sdk/openai",
      "options": {
        "apiKey": "sk-***",
        "baseURL": "https://www.cctq.ai/v1",
        "setCacheKey": true
      }
    }
  }
}

• cctq-codex：供应商标识，可自定义（只能用小写字母、数字、连字符）。
• baseURL：中转站请求地址，填 https://www.cctq.ai/v1（需以 /v1 结尾）。
• apiKey：你的令牌，把 sk-*** 换成实际的 Key。
• models：要使用的模型，键为模型 ID，name 为显示名。
• reasoningEffort：推理强度（思考深度），可选 low / medium / high / xhigh。值越高模型思考越充分、结果通常越好，但响应更慢、消耗更多；xhigh 为最高强度。
• setCacheKey：启用缓存，建议保持 true。

保存后重新打开终端，运行 opencode 即可使用。