OpenCode

这篇教程带你用 OpenCode 接入 OpenAI Hub，配好第三方模型 claude-opus-4-7，在终端里直接跟 AI 结对编程。

安装 OpenCode

确保你本机有 Node.js 18+，然后装 OpenCode：

npm install -g opencode-ai

macOS / Linux 也可以用一键脚本：

curl -fsSL https://opencode.ai/install | bash

装完验证一下：

opencode -v

能看到版本号就行。

注册自定义 Provider

在终端执行：

opencode auth login

按提示操作：

1. 在服务商列表里选 other（拉到最下面，或直接搜索）
2. Provider ID 输入 openaihub（这个名字后面配置文件要用，必须一致）
3. API Key 输入你在 OpenAI Hub 拿到的 Key，格式类似 sk-xxxx

注意：Provider ID 只能用小写字母和数字，别带特殊字符。

编辑配置文件

打开配置文件：

• macOS / Linux：~/.config/opencode/opencode.json
• Windows：C:\Users\你的用户名\.config\opencode\opencode.json

把内容替换成：

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "openaihub": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "OpenAI Hub",
      "options": {
        "baseURL": "https://api.openai-hub.com/v1",
        "apiKey": "sk-your-api-key"
      },
      "models": {
        "claude-opus-4-7": {
          "name": "Claude Opus 4 (7)",
          "limit": {
            "context": 200000,
            "output": 32768
          }
        }
      }
    }
  },
  "model": "openaihub/claude-opus-4-7"
}

几个容易出问题的地方：

• openaihub 必须跟上一步的 Provider ID 完全一致，差一个字符都不行
• baseURL 必须以 /v1 结尾
• sk-your-api-key 换成你自己的 OpenAI Hub API Key
• 最后的 "model" 字段设置了默认模型，格式是 provider-id/model-id

启动使用

进入你的项目目录，启动 OpenCode：

cd your-project
opencode

启动后可以输入 /models 确认模型列表里有 Claude Opus 4 (7)。选中它就能开始对话了。

注意：修改配置文件后需要退出并重新启动 OpenCode 才能生效。如果启动后看不到模型，先检查 JSON 格式有没有写错（多余的逗号是常见问题）。

想加更多模型？

在 models 里继续加就行，OpenAI Hub 一个 Key 能调所有模型：

"models": {
  "claude-opus-4-7": {
    "name": "Claude Opus 4 (7)",
    "limit": {
      "context": 200000,
      "output": 32768
    }
  },
  "gpt-4o": {
    "name": "GPT-4o",
    "limit": {
      "context": 128000,
      "output": 16384
    }
  },
  "claude-sonnet-4-20250514": {
    "name": "Claude Sonnet 4",
    "limit": {
      "context": 200000,
      "output": 16384
    }
  }
}

模型 ID 要跟 OpenAI Hub 平台上支持的模型名称对应，在平台文档里能查到完整列表。