如果你正在国内环境里使用 OpenCode，大概率会遇到一个问题：工具本身很好用，但模型 API 的接入、网络访问、账号额度和模型切换都比较麻烦。
OpenCode 的核心价值是终端 AI 编程工具。如果再配合 QuickRouter API https://quickrouter.ai 国内直连全球AI大模型，就可以用一个 API Key 统一接入 GPT、Claude、Gemini、DeepSeek 等模型，适合开发、测试、写文档、做工作流和搭建 AI 应用。
本文用一篇教程把配置流程讲清楚。
一、怎样在国内接入 QuickRouter API？
很多 AI 工具默认只支持某一家模型服务。实际开发时，我们经常需要：
- 写代码时用 Claude
- 做通用问答时用 GPT
- 处理长文本或多模态时用 Gemini
- 做性价比任务时用 DeepSeek 或其他模型
如果每个平台都单独注册、充值、配置 Key，维护成本会比较高。
QuickRouter API 的作用就是把这些模型统一到一个入口里。你只需要记住一组核心配置：
API Key：在 QuickRouter API 控制台创建
Base URL：https://api.quickrouter.ai/v1
模型名称：按控制台实际支持的模型填写
注意：除了 Claude Code 这类特殊工具外，本文中的 OpenAI 兼容工具一般都使用带 /v1 的地址。
二、在 OpenCode 中填写接口信息
进入 OpenCode 的配置位置：
配置文件或 TUI 设置
选择接口类型：
OpenAI Compatible
然后填写：
API Key: 你的 QuickRouter API Key
Base URL: https://api.quickrouter.ai/v1
模型名称可以先选择一个常用模型，例如：
gpt-5.5
claude-opus-4-7
gemini-3.1-pro
deepseek-v4
具体模型名以 QuickRouter API 控制台展示为准。
三、测试是否配置成功
配置完成后，可以先做一个简单测试：
请分析当前项目目录并找出启动命令。
如果能正常返回内容，说明 OpenCode 已经成功通过 QuickRouter API 调用模型。
如果没有返回，先不要急着改代码，优先检查配置项。
四、常见问题排查
1. Base URL 要不要加 /v1？
OpenCode 这里使用：
https://api.quickrouter.ai/v1
这是 OpenAI 兼容接口常见写法。
特别说明：Claude Code 单独使用 https://api.quickrouter.ai，不加 /v1。不要把两类工具混在一起。
2. 提示 Unauthorized
通常是 API Key 错误、Key 前后有空格、Key 已失效，或者账户余额不足。
3. 模型不存在
检查模型名是否和控制台一致。建议直接复制模型名，不要手打。
4. 请求超时或无响应
可以换一个模型测试，也可以先用基础对话接口验证 API Key 是否可用。
五、适合的使用场景
OpenCode 接入 QuickRouter API 后，适合这些场景：
- 日常代码生成和重构
- 解释报错信息
- 编写接口文档
- 生成测试用例
- 总结长文本
- 搭建自动化 AI 工作流
- 对比不同模型的输出效果
对于经常切换工具和模型的开发者来说，统一 API 入口能减少很多重复配置。
六、总结
OpenCode 本身解决的是工具层面的效率问题，QuickRouter API 解决的是模型接入层面的稳定性和统一性问题。