第三章：中国大陆使用指南
这一章不再依赖大量旧版手写 JSON 模板，而是优先采用 2026 年官方推荐路线： 优先用内置 provider + `/connect` + `/models`，只有在需要企业网关、中转层或本地模型时，再补充配置文件。
💡 一句话建议
对大多数国内用户来说，最省心的选择是：先用 DeepSeek 或 Qwen 这类内置 provider，等你熟悉 OpenCode 之后，再考虑本地 Ollama 或企业中转网关。
1. 国内用户的四条路线
路线 A：最省心
直接使用 OpenCode Zen，优点是接入最顺、官方测试覆盖最好，适合第一次上手。
路线 B：高性价比
通过 `/connect` 接入 DeepSeek，成本更低，国内访问也更稳定。
路线 C：生态兼容
用 Qwen、Moonshot、MiniMax 等国内 provider，尤其适合已经有现成账号体系的团队。
路线 D：私有化 / 本地
使用 Ollama、LM Studio 或其他本地 OpenAI 兼容服务，优先解决隐私和内网问题。
2. 推荐接法：先用 `/connect`，不要先抄旧配置
官方 provider 目录已经内置了很多服务商。你可以直接这样操作：
opencode
/connect
/models-
运行
/connect，搜索 DeepSeek、Qwen、Moonshot 等服务商。 - 输入对应 API Key 或按网页授权。
-
再执行
/models，看当前 provider 真正支持哪些模型。 -
确认满意后，再决定是否把默认模型写入
opencode.json。
这样做的好处是：你不用提前猜模型 ID，也不会被旧文章里已经失效的 JSON 模板误导。
3. 需要走中转或企业网关时怎么配？
如果你公司统一走 OpenAI 兼容接口，或者你手里拿的是某个代理平台提供的
key，可以用 baseURL 覆盖默认地址。
{
"$schema": "https://opencode.ai/config.json",
"provider": {
"openai": {
"options": {
"baseURL": "https://your-gateway.example.com/v1"
}
}
}
}
这里最关键的一点不是 JSON 本身，而是：模型 ID 必须和你的网关真实暴露出来的模型一致。最稳妥的验证方式仍然是回到 OpenCode 里执行 /models。
4. 本地模型路线
如果你所在团队不能把代码发到公网，或者你只想在内网做原型验证，本地模型是更现实的方案。
- Ollama：适合本机或局域网运行的 OpenAI 兼容接口。
- LM Studio / 其他本地服务：适合桌面化调试和快速切换模型。
- 注意点：本地模型能不能胜任工具调用、长链路修改和大工程分析，往往比“能不能聊天”更重要。
5. 2026 年国内用户推荐组合
入门组合
- Provider：OpenCode Zen
- 特点：最省心
- 适合：第一次上手
均衡组合
- Provider：DeepSeek / Qwen
- 特点：成本更友好
- 适合：日常开发主力
私有化组合
- Provider：Ollama / 本地兼容服务
- 特点：隐私优先
- 适合：内网或敏感项目
6. 常见问题排查
- Windows 可不可以原生装？ 可以，但官方依旧推荐 WSL 作为更稳定的体验。
- 一定要海外信用卡吗？ 不一定。你完全可以直接接入国内 provider 或本地模型。
-
网络正常但模型不可用？ 先跑
/models看 provider 当前实际暴露了什么模型。 -
配置越来越乱？ 用
opencode debug config看最终合并后的真实配置。