OpenCode 接入指南
三步接入、各档位的默认模型,以及开源模型的额度。
OpenCode 2 改了自定义 provider 的写法,桌面端设置里的自定义表单也存不进去。本文用一份 opencode.jsonc 接上 CodingPass。
本文把 CodingPass 接进 OpenCode 2:一个 Key 用 Claude、GPT 和 DeepSeek、Kimi 等开源模型,终端和桌面端共用一份配置。只想照着步骤配的,看 OpenCode 接入指南 就够了;这里多了客户端介绍。
OpenCode 是一个开源的编程 Agent,代码在 GitHub 的 anomalyco/opencode 仓库,MIT 协议。它不绑定模型厂商:自带一批免费模型,不注册也能用;也能接 OpenAI、Anthropic、xAI 等厂商的 API,或者直接用 ChatGPT Plus / Pro、GitHub Copilot 订阅。OpenCode 本身免费,接别家 provider 的费用由那一家收。
入口有好几个:
opencode pair)、手机 App 和 SDKOpenCode 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 --version 输出 v2.x。把下面这份存成 ~/.config/opencode/opencode.jsonc。Claude 和开源模型走 Anthropic 包,GPT 走 Responses 包:
{ "$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 在 模型页 查。
opencode service set env CODINGPASS_API_KEY cp-live-…Key 存在 OpenCode 后台服务的环境里,终端和桌面端都读得到。
重开 OpenCode,输入 /models,选 CodingPass 下的 Claude Sonnet 5.5,随便发一条消息,有回复就接好了。
opencode/models
从 opencode.ai/desktop 下载。桌面端读同一份配置和 Key,不用再配,在输入框旁的模型选择器里选 CodingPass 的模型就行。

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