很多人 OpenCode 用不好不是工具不行而是模型没配对。 本文将带你从 0 到 1彻底搞懂 OpenCode 如何接入自定义大模型并给出实测可用的完整配置方案。适合人群想在 OpenCode 中接入 自建 / 代理 / 中转模型服务 需要同时使用 GPT、Claude、Gemini 的开发者 希望打造 多模型统一调用入口 的工程师一、为什么你配的 OpenCode 模型 “用不了”在社区里关于 OpenCode 的常见问题基本集中在三点模型配置了但 列表里不显示 调用时报错但 不知道错在哪 API Key /baseURL 明明没错却始终请求失败 根本原因只有一个没搞清楚 provider 机制。二、OpenCode 的核心设计Provider 才是灵魂在 OpenCode 中Model ≠ API Model ≠ SDK Model Provider SDK 配置 也就是说OpenCode 并不是 “直接支持某个模型” 而是通过 provider模型提供方 来桥接各种 SDK。三、配置文件在哪99% 的人第一步就找错了默认配置路径bash~/.config/opencode/opencode.json也可以通过环境变量 自定义bashexport OPENCODE_CONFIG_DIR~/.opencode export OPENCODE_CONFIG~/.opencode/opencode.json四、修改后完整配置GPT 更新为 gpt5.6‑sol统一 api 地址https://api.new.biToken173 中转服务通用GPT 替换为gpt5.6‑solbaseURL 统一更新为https://api.new.bi/v1json{ $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://api.new.bi/v1, apiKey: {env:TOKEN173_API_KEY} }, models: { gpt-5.6-sol: { id: gpt5.6-sol, name: GPT‑5.6‑SOL } } }, token173-anthropic: { npm: ai-sdk/anthropic, name: Token173 Claude, options: { baseURL: https://api.new.bi/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://api.new.bi/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 决定你 “用哪套协议”jsonnpm: ai-sdk/openai-compatible含义 接口 兼容 OpenAI 不要求官方 OpenAI2️⃣ options90% 的报错来源jsonoptions: { baseURL: https://api.new.bi/v1, apiKey: {env:TOKEN173_API_KEY} }常见错误忘记后缀/v1HTTPS 证书问题 API Key 明文写死在配置中3️⃣ models ID 必须和真实模型一致jsonmodels: { gpt-5.6-sol: { id: gpt5.6-sol, name: GPT‑5.6‑SOL } }id中转接口真实调用模型名必须和服务商一致nameOpenCode UI 界面显示名称六、API Key 的正确管理方式bashexport TOKEN173_API_KEYyour_api_key_here配置中引用jsonapiKey: {env:TOKEN173_API_KEY}优势安全密钥不会明文存入配置文件 可多环境切换 适合 git 版本控制Windows PowerShell 设置环境变量powershell$env:TOKEN173_API_KEYyour_api_key_here七、常见问题速查表表格现象排查方向模型不显示JSON 格式错误provider 名称重复models 节点未定义请求失败baseURL 地址无法访问环境变量 API Key 未生效npm SDK 包和接口协议不匹配Claude / Gemini 返回 404baseURL 路径写错确认/anthropic/v1、/gemini/v1beta后缀校验 JSON 小技巧复制配置到 JSON 校验工具确认无语法错误再写入 opencode.json八、总结OpenCode 真正强的不是支持某个模型 而是支持无限模型的统一接入。一次配置多模型共存 非常适合中转 / 私有化 / 企业内部部署如果你需要我还可以帮你把这份文档输出为 Markdown 文件文本或者再增加 Ollama 本地模型的 provider 配置片段。