Opencode 中转 API 配置指南

前提条件

• 已安装 Opencode（npm install -g opencode-ai 或 go install github.com/opencode-ai/opencode@latest）
• 拥有中转 API 的地址和密钥

配置文件说明

Opencode 使用两个关键配置文件：

文件	路径	用途
opencode.json	~/.config/opencode/opencode.json	Provider 和 baseURL 配置
auth.json	~/.local/share/opencode/auth.json	API 密钥存储

注意： auth.json 的路径是 ~/.local/share/opencode/，不是 ~/.config/opencode/。放错位置会导致密钥无法读取。

第一步：配置 opencode.json

macOS

mkdir -p ~/.config/opencode
nano ~/.config/opencode/opencode.json

Windows

在资源管理器中打开 C:\Users\<用户名>\.config\opencode\，如果目录不存在则手动创建，然后新建 opencode.json 文件。

配置内容

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "anthropic": {
      "options": {
        "baseURL": "https://你的中转地址/api/v1"
      }
    }
  }
}

注意事项：

• apiKey 不能放在 opencode.json 中，否则会报错 Unrecognized key: "apiKey"
• 只需配置 options.baseURL 指向中转服务地址

第二步：配置 auth.json

macOS

mkdir -p ~/.local/share/opencode
nano ~/.local/share/opencode/auth.json

Windows

在资源管理器中打开 C:\Users\<用户名>\.local\share\opencode\，如果目录不存在则手动创建，然后新建 auth.json 文件。

配置内容

{
  "anthropic": {
    "type": "api",
    "key": "你的API密钥"
  }
}

注意事项：

• type 必须是 "api"，不能填 URL

第三步：启动并验证

opencode

进入 TUI 界面后：

1. 输入 /models 选择模型（如 claude-sonnet-4-20250514）
2. 正常对话即表示配置成功

常见问题

Q: 报错 "Anthropic API key is missing"

原因： auth.json 路径不对或内容格式错误。

解决： 确认文件在 ~/.local/share/opencode/auth.json，且 type 为 "api"。

Q: 报错 "Unrecognized key: apiKey"

原因： 在 opencode.json 的 provider 中添加了 apiKey 字段。

解决： 从 opencode.json 中移除 apiKey，密钥只通过 auth.json 配置。

Q: 报错 "ConfigInvalidError"

原因： opencode.json 中包含了 schema 不支持的字段。

解决： 检查配置文件，只保留 $schema、provider、options.baseURL 等合法字段。

常用 TUI 命令

命令	说明
/help	查看所有可用命令
/models	切换模型
/connect	管理 Provider 连接
/new	新建会话
/sessions	查看/切换会话
/compact	压缩当前会话上下文
@文件名	引用文件到对话中
!命令	执行 shell 命令
/exit	退出

相关路径速查

macOS

用途	路径
全局配置	~/.config/opencode/opencode.json
密钥存储	~/.local/share/opencode/auth.json

Windows

用途	路径
全局配置	C:\Users\<用户名>\.config\opencode\opencode.json
密钥存储	C:\Users\<用户名>\.local\share\opencode\auth.json