登录选套餐
博客 · 接入指南

如何在 OpenCode 中使用 Claude

OpenCode 2 改了自定义 provider 的写法,桌面端设置里的自定义表单也存不进去。本文用一份 opencode.jsonc 接上 CodingPass。

本文把 CodingPass 接进 OpenCode 2:一个 Key 用 Claude、GPT 和 DeepSeek、Kimi 等开源模型,终端和桌面端共用一份配置。只想照着步骤配的,看 OpenCode 接入指南 就够了;这里多了客户端介绍。

OpenCode 是什么

OpenCode 是一个开源的编程 Agent,代码在 GitHub 的 anomalyco/opencode 仓库,MIT 协议。它不绑定模型厂商:自带一批免费模型,不注册也能用;也能接 OpenAI、Anthropic、xAI 等厂商的 API,或者直接用 ChatGPT Plus / Pro、GitHub Copilot 订阅。OpenCode 本身免费,接别家 provider 的费用由那一家收。

入口有好几个:

  • 终端界面:能开在任意 shell、编辑器的内置终端或远程服务器上
  • 桌面端:支持 macOS、Windows 和 Linux,每个会话一个标签页,改动按 diff 审,自带浏览器预览
  • 其他:网页版(opencode pair)、手机 App 和 SDK

OpenCode 2 起默认跑一个共享的后台服务,这些入口都是连到它上面的客户端,所以终端里开的会话,桌面端也能接着看。截至 11 月 18 日,最新版是 v2.3.2。

接上 CodingPass 以后,模型列表里多出一组 CodingPass 的模型。11 月 18 日 GET https://codingpass.ai/v1/models 返回 26 个,覆盖 Claude(Sonnet 5.5、Opus 5.5、Fable 5.2 等)、GPT(GPT-6.2 Sol、GPT-6.1 Terra 等)、Gemini、Grok,以及 DeepSeek、Kimi、GLM、Qwen、MiniMax、MiMo、Hy4 等开源模型。你的档位能用哪些,以 模型页 为准。

接入实操

准备

  • 装好 OpenCode 2,opencode --version 输出 v2.x。
  • 在 CodingPass 控制台的 Key 页创建一个 Key,工具选 OpenCode。

1. 写配置文件

把下面这份存成 ~/.config/opencode/opencode.jsonc。Claude 和开源模型走 Anthropic 包,GPT 走 Responses 包:

~/.config/opencode/opencode.jsonc
{  "$schema": "https://opencode.ai/config.json",  "model": "codingpass/claude-sonnet-5-5",  "providers": {    "codingpass": {      "name": "CodingPass",      "env": ["CODINGPASS_API_KEY"],      "package": "@opencode/ai/providers/anthropic",      "settings": { "baseURL": "https://codingpass.ai/v1" },      "models": {        "claude-sonnet-5-5": { "name": "Claude Sonnet 5.5" },        "claude-opus-5-5": { "name": "Claude Opus 5.5" },        "deepseek-v4.1-flash": { "name": "DeepSeek V4.1 Flash" },        "kimi-k2.7-code": { "name": "Kimi K2.7 Code" }      }    },    "codingpass-openai": {      "name": "CodingPass (OpenAI)",      "env": ["CODINGPASS_API_KEY"],      "package": "@opencode/ai/providers/openai-compatible/responses",      "settings": { "baseURL": "https://codingpass.ai/v1" },      "models": {        "gpt-6.2-sol": { "name": "GPT-6.2 Sol" },        "gpt-6.1-terra": { "name": "GPT-6.1 Terra" }      }    }  }}

baseURL 要带 /v1,不带会报 404。models 按你的档位增删,模型 ID 在 模型页 查。

2. 设置 Key

Terminal
opencode service set env CODINGPASS_API_KEY cp-live-…

Key 存在 OpenCode 后台服务的环境里,终端和桌面端都读得到。

3. 选模型,发一条消息

重开 OpenCode,输入 /models,选 CodingPass 下的 Claude Sonnet 5.5,随便发一条消息,有回复就接好了。

Terminal
opencode/models
OpenCode 终端界面:发送 Say hi in five words,回复 Hello there, nice to meet you!,下方显示 Build · Claude Sonnet 5.5 CodingPass
OpenCode 2.3.2 终端界面,模型是 CodingPass 下的 Claude Sonnet 5.5。

桌面端

从 opencode.ai/desktop 下载。桌面端读同一份配置和 Key,不用再配,在输入框旁的模型选择器里选 CodingPass 的模型就行。

OpenCode 桌面端会话:发送 Say hi in five words,回复 Hello there, nice to meet you!,输入框下方的模型选择器显示 CodingPass / Claude Sonnet 5.5
桌面端不用另配,模型选择器里直接有 CodingPass。
出发

OpenCode 照用,账单按月固定。

一份 opencode.jsonc,Claude、GPT 和开源模型都在 /models 里。不会意外扣费,随时取消。

  • 每个响应都带请求 ID
  • 用量不超过 5% 可全额退款
  • 不会意外扣费
选 GoOpenCode 指南

每月 $10,直到你取消。