OpenCode 自定义模型终极指南一份配置文件搞定 GPT / Claude / Gemini很多人 OpenCode 用不好不是工具不行而是模型没配对。本文将带你从 0 到 1彻底搞懂 OpenCode 如何接入自定义大模型并给出 实测可用的完整配置方案。适合人群想在 OpenCode 中接入 自建 / 代理 / 中转模型服务需要同时使用 GPT、Claude、Gemini 的开发者希望打造 多模型统一调用入口 的工程师一、为什么你配的 OpenCode 模型“用不了”在社区里关于 OpenCode 的常见问题基本集中在三点模型配置了但 列表里不显示调用时报错但 不知道错在哪API Key / baseURL 明明没错却始终请求失败 根本原因只有一个没搞清楚 provider 机制。二、OpenCode 的核心设计Provider 才是灵魂在 OpenCode 中Model ≠ APIModel ≠ SDKModel Provider SDK 配置也就是说OpenCode 并不是“直接支持某个模型”而是通过 provider模型提供方 来桥接各种 SDK。三、配置文件在哪99% 的人第一步就找错了默认配置路径~/.config/opencode/opencode.json也可以通过环境变量 自定义exportOPENCODE_CONFIG_DIR~/.opencodeexportOPENCODE_CONFIG~/.opencode/opencode.json四、实测可用的完整配置示例建议直接收藏支持 GPT / Claude / Gemini 3.5Token173中转服务通用{$schema:https://opencode.ai/config.json,theme:opencode,autoupdate:true,tools:{write:true,bash:true,read:true,edit:true,glob:true,grep:true},permission:{webfetch:allow,bash:ask,edit:ask,skill:allow},provider:{token173-openai:{npm:ai-sdk/openai-compatible,name:Token173 OpenAI,options:{baseURL:https://token173.com/v1,apiKey:{env:TOKEN173_API_KEY}},models:{gpt-5:{id:gpt-5,name:GPT-5},gpt-5.1:{id:gpt-5.1,name:GPT-5.1}}},token173-anthropic:{npm:ai-sdk/anthropic,name:Token173 Claude,options:{baseURL:https://token173.com/anthropic/v1,apiKey:{env:TOKEN173_API_KEY}},models:{claude-sonnet-4.5:{id:claude-sonnet-4.5,name:Claude Sonnet 4.5}}},token173-gemini:{npm:ai-sdk/google,name:Token173 Gemini,options:{baseURL:https://token173.com/gemini/v1beta,apiKey:{env:TOKEN173_API_KEY}},models:{gemini-3.5-flash:{id:gemini-3.5-flash,name:Gemini 3.5 Flash}}}}}五、provider 字段最容易配错的 3 个点1️⃣ npm 决定你“用哪套协议”npm:ai-sdk/openai-compatible含义接口 兼容 OpenAI不要求官方 OpenAI2️⃣ options90% 的报错来源options:{baseURL:https://token173.com/v1,apiKey:{env:TOKEN173_API_KEY}}常见错误忘记 /v1HTTPS 证书问题API Key 写死在配置中3️⃣ models ID 必须和真实模型一致models:{gpt-5:{id:gpt-5,name:GPT-5}}id真实请求模型名nameUI 显示名六、API Key 的正确管理方式exportTOKEN173_API_KEYyour_api_key_here配置中引用apiKey:{env:TOKEN173_API_KEY}优势安全可多环境切换适合版本控制七、常见问题速查表模型不显示JSON 格式错误provider 名重复models 未定义请求失败baseURL 不通API Key 未生效SDK 与接口不兼容Claude / Gemini 404baseURL 路径错误非对应路由地址八、总结OpenCode 真正强的不是支持某个模型而是支持 无限模型的统一接入。一次配置多模型共存非常适合中转 / 私有化 / 企业内部部署