OpenCode 配置

规划中

OpenCode 是终端代码工具，可通过 OpenAI-compatible 或 Anthropic-compatible Provider 接入私库云。

官方下载与安装

OpenCode 官方文档

安装说明

OpenCode GitHub

官方安装脚本：

也可以使用 npm：

安装后运行：

配置文件

默认配置文件：

~/.config/opencode/opencode.json

Windows 通常使用用户配置目录对应位置；请以当前版本官方文档为准。

OpenAI-compatible 配置

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "私库云": {
      "npm": "@ai-sdk/openai-compatible",
      "options": {
        "baseURL": "你的 Base URL/v1",
        "apiKey": "你的 API Key"
      },
      "models": {
        "控制台中的模型名": {}
      }
    }
  }
}

保存后在 OpenCode 中选择“私库云”和对应模型。

首次测试

检查 JSON 是否能正常解析。

确认 Provider 已选择。

发送一条短消息。

查看控制台请求记录。

常见问题

JSON 报错：检查逗号、引号和配置文件路径。

401：检查 apiKey 字段和 API Key 是否有效。

404：检查 baseURL 是否重复添加 /v1。

模型找不到：models 中的名称必须与控制台一致。

配置未生效：重启 OpenCode，确认没有另一个配置文件覆盖当前配置。

完成标志

工具已经安装，配置文件或环境变量已保存，工具完成重启，并且一条短消息返回成功。

下一步

查看余额和请求记录：打开账户与用量。

仍然失败：打开常见问题，根据状态码排查。

需要更底层的接口说明：打开开发者 API。

官方下载与安装#

配置文件#

OpenAI-compatible 配置#

首次测试#

常见问题#

完成标志#