Skip to content

OpenCode

推荐说明

OpenCode 更适合喜欢在第三方工具里统一管理多模型配置的用户。
这页建议直接按后台给出的 使用 配置来操作,不要自己手写整份配置。

1. 先安装 OpenCode

如果你是第一次使用,先在终端安装:

bash
npm i -g opencode-ai

安装完成后,先运行一次:

bash
opencode

这样本地配置目录通常会先初始化出来。

2. 在后台创建密钥

  1. 进入后台
  2. 打开 API密钥
  3. 点击 创建密钥
  4. 创建完成后,点击这个密钥旁边的 使用

3. 在后台切到 OpenCode

点击 使用 后:

  1. 切到 OpenCode 这一栏
  2. 后台会给出对应的配置内容
  3. 直接复制后台给出的内容即可

TIP

这一页的核心原则只有一个:以后台 使用 API 密钥 弹窗里的 OpenCode 配置为准。

4. 打开 OpenCode 配置目录

Windows

bash
start "" "%USERPROFILE%\\.config\\opencode"

macOS

bash
open "$HOME/.config/opencode"

5. 粘贴并修改配置文件

打开配置目录后,把后台给出的配置内容复制到对应文件里。

常见情况通常是:

  • 修改 opencode.json
  • 或者把后台给出的配置文件直接替换进去

如果后台弹窗里同时给了其他配套内容,也一并按提示复制过去。

6. 保存后启动测试

保存后,在终端运行:

bash
opencode

进入后可以再执行:

text
/models

如果能正常看到模型列表,说明配置基本成功。

7. 常见提醒

重要提醒

  • 不要凭感觉手改渠道名、模型名和字段名
  • 优先以后台 OpenCode 标签页里给出的配置为准
  • 如果改完没有生效,先完全退出 OpenCode 再重新启动

Key 使用提醒

  • 不同用途的 Key 可能不通用
  • 如果你使用的是订阅或特定分组,先确认当前 Key 对应的分组没有选错

相关页面

面向 Codex、Claude Code、OpenCode 等工具的统一接入平台