OpenCode 配置
OpenCode 是开源终端 AI 编码助手。它适合在项目目录里进行代码问答、文件修改和模型切换。新手优先走它自己的连接向导，不要一开始就手写完整 JSON。
官方信息 下载和文档以官方站点为准
这个工具是什么，用于什么
配置文件位置
| 系统 | 配置文件位置 | 说明 |
|---|---|---|
| Windows | C:\Users\你的用户名\.config\opencode\opencode.json | 没有文件就新建 |
| macOS / Linux | ~/.config/opencode/opencode.json | 没有文件就新建 |
先用连接向导
OpenCode 连接向导
cd 你的测试项目 opencode /connectOpenCode 检查模型
cd 你的测试项目 opencode /models手动配置注意什么
只有当你的服务商文档明确写了 OpenCode 的 Provider 字段、Base URL 和 Key 放在哪里，再编辑配置文件。不同版本字段会变化，不要把其他工具的 JSON 示例直接搬到 OpenCode。
| 要核对的内容 | 说明 |
|---|---|
| Provider 类型 | OpenAI、Claude、Gemini 或其他协议不能混用 |
| Base URL | 使用服务商给 OpenCode 或对应协议的完整地址 |
| Key | 使用当前 Provider 对应的 Key |
| 模型名 | 照抄服务商后台模型列表 |
保存后怎么测试
- 进入一个测试项目目录后运行
opencode。 - 先用
/models确认能看到刚配置的模型。 - 选择模型后发送“请只回复：OpenCode 配置成功”。
- 第一次不要让它修改文件，只让它解释当前目录或当前文件。
- 如果失败，先回到
/connect或服务商文档核对 Provider、Base URL、Key 和模型名。
| 现象 | 优先检查 | 处理 |
|---|---|---|
/models 里没有模型 | Provider 是否保存成功、模型列表是否能拉取 | 手动添加服务商后台模型 ID / 模型名 |
| 连接失败 | Base URL 是否属于当前 Provider 协议 | 不要把 Claude、Gemini、OpenAI 三类地址混用 |
| 配置文件无效 | JSON 格式、逗号、引号 | 优先用连接向导生成配置，再少量手改 |
OpenCode 官网 查看安装、认证和命令说明。
OpenCode 中转站配置参考 参考 opencode.json 的配置思路。