OpenCode 接入教程

OpenCode 是开源的终端编程 Agent。复制下面的配置文件,填上 Key,就能在 OpenCode 里用 Claude 和 GPT。

更新于 2026-11-16

一、准备 API Key

在 TokenMilo 控制台注册并充值,到「API 密钥」页面创建一个 Key(以 sk- 开头)。

二、安装 OpenCode

# macOS / Linux
curl -fsSL https://opencode.ai/v2/install | bash

# 或者用 npm(需要 Node.js)
npm install -g @opencode/cli --registry=https://registry.npmmirror.com

Windows 用户请到 OpenCode 官网下载独立压缩包或桌面版。如果装过 V1,要先卸载旧版。

三、写配置文件

新建或编辑 ~/.config/opencode/opencode.json(Windows 为 %USERPROFILE%\.config\opencode\opencode.json),粘贴:

{
  "$schema": "https://opencode.ai/config.json",
  "model": "tokenmilo-claude/claude-sonnet-5-5",
  "providers": {
    "tokenmilo-claude": {
      "name": "TokenMilo Claude",
      "package": "@opencode/ai/providers/anthropic-compatible",
      "settings": { "baseURL": "https://api.tokenmilo.com/v1", "apiKey": "{env:TOKENMILO_API_KEY}" },
      "models": {
        "claude-sonnet-5-5": { "name": "Claude Sonnet 5.5", "limit": { "context": 200000, "output": 32000 } },
        "claude-opus-5-5": { "name": "Claude Opus 5.5", "limit": { "context": 200000, "output": 32000 } },
        "claude-haiku-5-5": { "name": "Claude Haiku 5.5", "limit": { "context": 200000, "output": 32000 } }
      }
    },
    "tokenmilo-gpt": {
      "name": "TokenMilo GPT",
      "package": "@opencode/ai/providers/openai-compatible",
      "settings": { "baseURL": "https://api.tokenmilo.com/v1", "apiKey": "{env:TOKENMILO_API_KEY}" },
      "models": {
        "gpt-6.1-sol": { "name": "GPT-6.1 Sol", "limit": { "context": 200000, "output": 32000 } }
      }
    }
  }
}

注意地址:Claude 这一组填 https://api.tokenmilo.com/v1(要带 /v1),GPT 这一组填 https://api.tokenmilo.com/v1。

四、设置 Key 并启动

macOS / Linux:

export TOKENMILO_API_KEY=sk-你的TokenMilo密钥   # 写进 ~/.zshrc 或 ~/.bashrc 永久生效
opencode

Windows:

setx TOKENMILO_API_KEY "sk-你的TokenMilo密钥"   # 然后重新打开终端
opencode

启动后输入 /models 可以看到 TokenMilo 的模型。问一句话,再到控制台「使用日志」页确认请求已经记录。

五、常见报错

  • 404:Claude 那组的 baseURL 没带 /v1,或者模型 ID 拼错(以模型列表为准)。
  • 401:环境变量没生效(Windows 用 setx 后要重新开终端),或者 Key 复制不完整。
  • 配置不生效:确认是 JSON 格式正确,并且字段名是 providers / package / settings(V2 格式)。

常见问题

为什么 Claude 的地址要带 /v1?

OpenCode 的 Anthropic 兼容接口会在地址后面只拼接 /messages,所以要填 https://api.tokenmilo.com/v1。这一点和 Claude Code 正好相反(Claude Code 不带 /v1)。

网上的教程写的是 provider、npm、options,为什么这里不一样?

OpenCode V2 改了配置格式:provider → providers,npm → package,options → settings。旧写法是 V1 的,新版本请用本页的格式。

不想把 Key 放在环境变量里怎么办?

可以删掉配置里的 apiKey 那一行,启动 OpenCode 后输入 /connect,选择 TokenMilo Claude 或 TokenMilo GPT,粘贴 Key 即可,Key 会保存在本机。

怎么切换模型?

在 OpenCode 里输入 /models 选择;或者修改配置里的 "model" 字段,格式是「提供商ID/模型ID」。

相关教程

还没有 API Key?

在 TokenMilo 注册、充值,一分钟内就能在控制台创建 Key。

获取 API Key 查看全部模型