OpenCode + CC Switch 使用指南
本页是 OpenCode 配合 CC Switch 使用第三方 AI 中转站的导航入口（MOC）。相关经验较多，按”先接入、后调优”的顺序拆成两篇，各自独立成文，可按需跳转。
OpenCode 是开源 CLI AI 编程 Agent，CC Switch 是它的可视化配置中枢（同时也管理 Claude Code、Codex 等工具）。用第三方中转站时，二者配合能解决 Base URL 无法填写、密钥易泄露、多设备配置难同步等痛点。
阅读顺序
1. 先接入：部署与多设备同步
OpenCode + CC Switch 协同部署：第三方中转站多设备同步方案
从零搭建环境的完整流程，适合第一次配置或换新设备时通读：
- OpenCode 与 CC Switch 的工具定位与协作关系
- 两者的安装
- 在 CC Switch 中接入第三方中转站供应商（含供应商标识必须用 models.dev 标准名这个最关键的坑）
- 通过 Cloudflare R2 实现多设备配置同步
- Skill 市场的使用
- 部署层面的注意事项
2. 后调优：模型能力深水区
OpenCode 模型精细化配置：中转站接入的 models.dev 深水区
接入成功后，若遇到多模态失效、上下文异常截断、标题不生成等问题，读这篇。核心是”models.dev 自动注入并不总可靠”，需手动补写四个字段：
limit：中转站上游云与官方不同导致上下文/输出上限错配时，手动校准variants：补齐推理强度档位（reasoningEffort），支持variant_cycle切换modalities：即使用官方标识也可能失效，手动显式声明多模态能力small_model：标题/摘要生成的隐藏依赖，且必须绕开 CC Switch 对配置文件的重写
何时读哪篇
| 你的情况 | 推荐 |
|---|---|
| 第一次配置 / 换新设备 | 先读部署篇，跑通接入与同步 |
| 图片、PDF 识别失效 | 精细化篇 §4 modalities |
| 上下文在奇怪位置被截断 | 精细化篇 §1–§2 limit |
| 想切换推理强度档位 | 精细化篇 §3 variants |
会话标题永远是 New session - <时间戳> | 精细化篇 §5 small_model |
参考资料
- OpenCode 官方文档
- OpenCode Config 配置文档 - 配置文件位置与合并优先级
- OpenCode Models 配置文档 -
limit、variants、模型选项 - CC Switch GitHub 仓库
- models.dev - 供应商标识与模型能力清单