OpenCode 接入

OpenCode 支持自定义 provider。对于本项目，推荐优先使用 cc-switch 配置：https://github.com/farion1231/cc-switch/releases

首选做法

优先直接用 cc-switch 完成配置。它本质上仍然是在修改 OpenCode 官方支持的配置和环境变量。

1. 安装

按 OpenCode 官方方式安装客户端。

2. 设置 API Key

如果你不用 cc-switch，再使用 OpenCode 自己的连接或鉴权方式：

bash

opencode auth login

或者在交互界面里运行 /connect，把这个服务作为自定义 provider 保存。

如果你更习惯环境变量，再让 opencode.json 读取官方通用变量名即可，例如：

bash

export OPENAI_API_KEY="codex_your_api_key"

3. 配置 `opencode.json`

在项目根目录或全局配置目录中创建 opencode.json：

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "codex_proxy": {
      "npm": "@ai-sdk/openai",
      "name": "Codex Proxy",
      "options": {
        "baseURL": "https://codex.miaomiaocode.com/v1",
        "apiKey": "{env:OPENAI_API_KEY}"
      },
      "models": {
        "gpt-5-codex-mini": {
          "name": "gpt-5-codex-mini"
        }
      }
    }
  },
  "model": "codex_proxy/gpt-5-codex-mini"
}

4. 验证

启动 OpenCode 后，执行：

text

/models

看到 codex_proxy 下的模型即可。

说明

推荐顺序：先 cc-switch，后手动配置
如果你走 /v1/responses，OpenCode 官方文档建议使用 @ai-sdk/openai
如果你的接入只支持 /v1/chat/completions，才改用 @ai-sdk/openai-compatible
不需要额外定义 CODEX_PROXY_API_KEY 这类项目私有变量

OpenCode 接入 ​

首选做法 ​

1. 安装 ​

2. 设置 API Key ​

3. 配置 opencode.json ​

4. 验证 ​