OpenCode 配置

OpenCode 是开源的终端 AI 编码工具。通过 Tokenhot 的 OpenAI 兼容接口，可以在 OpenCode 中使用支持 OpenAI Chat Completions 协议的模型。

OpenCode 可能读取、修改项目文件并执行终端命令。请先确认当前目录和权限范围；不要将 API Key 写入项目配置或提交到 Git 仓库。

前置要求

Tokenhot API Key

已安装 OpenCode

所选模型支持 OpenAI Chat Completions 协议

配置步骤

1. 安装 OpenCode

macOS / Linux：

也可以使用 npm 安装：

验证安装：

2. 配置 API Key

推荐使用环境变量保存 API Key。

macOS / Linux：

PowerShell：

$env:TOKENHOT_API_KEY = "你的 Tokenhot API Key"

环境变量仅对当前终端会话生效。不要将真实 API Key 写入 opencode.json、.env 后提交到 Git，或分享给他人。

3. 创建配置文件

全局配置文件位置：

系统	路径
Windows	`%USERPROFILE%\.config\opencode\opencode.jsonc`
macOS / Linux	`~/.config/opencode/opencode.jsonc`

也可以在项目根目录创建 opencode.jsonc，仅对当前项目生效。

写入以下内容：

{
  "$schema": "https://opencode.ai/config.json",
  "providers": {
    "tokenhot": {
      "name": "Tokenhot",
      "env": ["TOKENHOT_API_KEY"],
      "package": "@opencode-ai/ai/providers/openai-compatible",
      "settings": {
        "baseURL": "https://api.tokenhot.ai/v1"
      },
      "models": {
        "gpt-5.4": {
          "name": "GPT-5.4"
        },
        "deepseek-v4-pro": {
          "name": "DeepSeek V4 Pro"
        }
      }
    }
  }
}

其中：

配置项	说明
`tokenhot`	Provider ID，可自定义；后续模型显示为 `tokenhot/模型ID`
`TOKENHOT_API_KEY`	保存 Tokenhot API Key 的环境变量名
`baseURL`	`https://api.tokenhot.ai/v1`
`models`	仅填写已确认支持 OpenAI Chat Completions 协议的模型

上述配置使用 OpenAI Chat Completions 兼容模式。若某个模型仅支持 OpenAI Responses 协议，请不要直接复用此配置，应使用对应的 Responses Provider 配置。

4. 启动并验证

启动后，在 OpenCode 的模型选择器中选择：

tokenhot/gpt-5.4

然后发送一条简单消息，例如：

请简要说明当前项目的目录结构。

收到正常回复即表示配置成功。

可用模型

请以 Tokenhot 模型列表中明确标注支持 OpenAI Chat Completions 协议的模型为准。

不同模型支持的上下文长度、图片输入、工具调用、推理能力和参数不同。请不要假设所有模型都支持相同能力。

常见问题

提示认证失败

检查：

TOKENHOT_API_KEY 是否已在当前终端设置。

API Key 是否有效。

修改环境变量后是否已重新打开终端。

模型没有显示

检查：

配置文件是否为有效 JSONC。

Provider ID 是否为 tokenhot。

模型是否已添加到 models。

重启 OpenCode 后再查看模型列表。

连接失败

确认 baseURL 为：

https://api.tokenhot.ai/v1

并确认所选模型支持 OpenAI Chat Completions 协议。

OpenCode

OpenCode 配置#

前置要求#

配置步骤#

1. 安装 OpenCode#

2. 配置 API Key#

3. 创建配置文件#

4. 启动并验证#

可用模型#

常见问题#

提示认证失败#

模型没有显示#

连接失败#