OpenCode 接入第三方模型:一把 Key 切换 Claude、GPT 与 DeepSeek

Guide OpenCode 接入第三方模型 claude-sonnet-5-5claude-haiku-5-5 Lazu

先说结论:在 ~/.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 即可自动按会话聚合花费。
相关文章
2026-11-18网关对 Claude Code 的契约:十件会让它卡住或静默出错的事 2026-10-21Claude Code 接 GPT 和 DeepSeek:Lazu 的协议层怎么转换请求 2026-09-30大模型 API 价格对比:Claude、GPT、Gemini、DeepSeek 怎么选

拿一个 Key 试试

免费开始