OpenCode 接入第三方模型:一把 Key 切换 Claude、GPT 与 DeepSeek
先说结论:在 ~/.config/opencode/opencode.json 里加一个 provider.lazu,baseURL 填 https://api.lazu.ai/v1,同一把 Lazu Key 就能在 OpenCode 里同时切换 Claude、GPT、Gemini、DeepSeek、Kimi、GLM 和 Qwen,主模型和轻量任务(small_model)还能分开指定。
最快的办法:一行脚本 #
在 控制台 › API Keys 里选一把 Key,点「接入」,选 OpenCode,复制一键脚本(也可以直接用下面这行):
curl -fsSL https://api.lazu.ai/setup/opencode | sh -s -- \
--model claude-sonnet-5-5 \
--light claude-haiku-5-5 \
--also gpt-6.1-sol \
--also deepseek-v4-pro
脚本会在终端提示输入 Key(不会留在命令历史里),自动合并更新 ~/.config/opencode/opencode.json,并发一次连通性请求确认可用。Windows 用户在同一弹窗里复制 PowerShell 命令即可。
手动配置 opencode.json #
如果想把 API Key 留在环境变量里、方便配置文件入库,先在 shell 启动文件(如 ~/.zshrc)里导出 LAZU_API_KEY:
export LAZU_API_KEY="sk-lazu-..."
然后编辑 ~/.config/opencode/opencode.json(若设置了 XDG_CONFIG_HOME,路径为 $XDG_CONFIG_HOME/opencode/opencode.json):
{
"$schema": "https://opencode.ai/config.json",
"model": "lazu/claude-sonnet-5-5",
"small_model": "lazu/claude-haiku-5-5",
"provider": {
"lazu": {
"npm": "@ai-sdk/openai-compatible",
"name": "Lazu",
"options": {
"baseURL": "https://api.lazu.ai/v1",
"apiKey": "{env:LAZU_API_KEY}"
},
"models": {
"claude-opus-5-5": { "name": "Claude Opus 5.5" },
"claude-sonnet-5-5": { "name": "Claude Sonnet 5.5" },
"claude-haiku-5-5": { "name": "Claude Haiku 5.5" },
"gpt-6-luna": { "name": "GPT-6 Luna" },
"deepseek-v4-pro": { "name": "DeepSeek V4 Pro" },
"deepseek-flash": { "name": "DeepSeek Flash" },
"kimi-k3": { "name": "Kimi K3" },
"glm-5.3": { "name": "GLM-5.3" },
"qwen3.8-max": { "name": "Qwen 3.8 Max" }
}
}
}
}
保存后在终端运行 opencode,输入 /models 就能在上面列出的模型之间即时切换。完整模型 ID 以模型目录为准。
为什么把 model 和 small_model 分开配 #
OpenCode 在后台高频发起两类小请求:自动生成会话标题、做轻量文件摘要或辅助判断。如果不设 small_model,这些后台请求默认跟着主模型跑——当你主模型选 claude-opus-5-5 时,起个标题也按旗舰单价计费。
把 small_model 指向 lazu/claude-haiku-5-5 或 lazu/deepseek-flash,主编码循环保留旗舰推理能力,后台杂活走低延迟小模型,两边共用同一把 Key 的美元预算与用量记录。
协议细节:哪些模型怎么注意 #
OpenCode 的 @ai-sdk/openai-compatible 默认走 /v1/chat/completions。Lazu 的协议层会在后台把这套请求无损桥接到 Claude 的 Messages 接口或 Gemini 原生接口,工具调用与流式输出照常工作(原理见协议层说明)。
只有一处模型限制需要留意:OpenAI 的纯推理型号(如 gpt-6.1-sol、gpt-6-astra)在 /v1/chat/completions 接口上不支持函数工具,必须走 /v1/responses。如果你在 @ai-sdk/openai-compatible 下主要跑工具调用,OpenAI 系列优先选支持关闭推理的 gpt-6-luna 或 gpt-6-sol;要用 gpt-6.1-sol 跑完整工具流,可以在 provider 里为它单独配 @ai-sdk/openai(Responses 模式)或直接在 Codex / Claude Code 中调用。
排查常见问题 #
- 列表里看不到新加的模型: 检查
provider.lazu.models的键名是否与 Lazu 模型目录完全一致(区分大小写,如MiniMax-M2.7)。 - 报
401鉴权错误: 若使用了"{env:LAZU_API_KEY}"语法,确认启动opencode的当前终端里echo $LAZU_API_KEY非空。 - 在控制台看不到按 OpenCode 归类的会话统计: 旧版 OpenCode 的
User-Agent格式与新版不同,Lazu 已在v0.7.260兼容新旧两种格式并识别x-opencode-session-id请求头(详见 User-Agent 对照复盘),升级到最新版 OpenCode 即可自动按会话聚合花费。