一句话：在项目根放一份 opencode.json 注册一个 OpenAI 兼容 provider，opencode 就能用 CodeGateway 的模型，一条命令运行。
准备工作
在 CodeGateway 官网 注册账号（绑定支付方式后可获得起步试用额度，具体金额以注册/定价页实时展示为准），在 Dashboard 创建 API Key（sk-cg- 开头）。
opencode 会读取项目目录的
opencode.json；密钥推荐用环境变量传入（{env:CG_KEY}语法），不要把密钥直接写进配置文件。
1. 安装 opencode
curl -fsSL https://opencode.ai/install | bash或 npm i -g opencode-ai / brew install sst/tap/opencode。安装后运行 opencode --version 确认。
2. 注册 CodeGateway provider
在项目根目录创建（或合并）opencode.json：
{
"$schema": "https://opencode.ai/config.json",
"model": "cg/deepseek-v4-pro",
"provider": {
"cg": {
"npm": "@ai-sdk/openai-compatible",
"name": "CodeGateway",
"options": {
"baseURL": "https://api.codegateway.dev/v1",
"apiKey": "{env:CG_KEY}"
},
"models": {
"deepseek-v4-pro": { "name": "DeepSeek V4 Pro" },
"kimi-k2.7-code": { "name": "Kimi K2.7 Code" }
}
}
}
}字段说明：
npm：OpenAI 兼容端点固定用@ai-sdk/openai-compatible。options.baseURL：CodeGateway OpenAI 兼容基线地址，固定https://api.codegateway.dev/v1。options.apiKey：{env:CG_KEY}引用环境变量；也可以创建后在终端运行/connect→ Other 输入 provider id 与密钥。models：登记你想用的模型 id（与 模型清单 一致），model指定默认模型（provider/model格式）。
然后导出密钥环境变量：
export CG_KEY="sk-cg-你的密钥"3. 验证
opencode run --model cg/deepseek-v4-pro "只回复两个字：你好"返回回复即接入成功。日常使用直接运行 opencode 打开交互界面，用 /models 切换已登记模型。
可用模型建议
OpenAI 兼容协议面推荐（实测可用）：
deepseek-v4-pro：代码场景主力。kimi-k2.7-code：长代码任务。glm-5.3：综合平衡。qwen3.8-27b：轻量推理。
注意：GPT 系模型受上游地区政策限制；Claude / Gemini 系不支持 OpenAI 兼容协议——需要 Claude 模型时走 Claude Code 接入。
常见问题
Q：需要把 key 写进 opencode.json 吗？ 不需要。推荐 {env:CG_KEY}；也可以 opencode auth login 走 OAuth（CodeGateway 不支持 OAuth，请用 env 或 /connect）。
Q：模型列表没显示我登记的模型？ 检查 models 字段 id 与模型清单一致、model 字段格式是 provider/model。
Q：报"provider not found"？ 确认 opencode.json 在工作目录（或家目录 ~/.config/opencode/opencode.json），provider.cg 对象语法正确。
Q：能同时用多家网关吗？ 可以。provider 对象下加第二个 id（如 cg2）即可，/models 里按 provider 分组选择。
Q：opencode 会帮我设置密钥到 auth.json 吗？ 用 /connect 时会把密钥存到本地 auth 文件；用 {env:...} 时不会落盘。两条路都合法，前者更省心，后者更干净。