OpenCode 接入 NineClaw 教程

基本介绍

OpenCode 是一款专为终端打造的 AI 编码代理工具，通过优化的键盘操作流程为命令行用户提供高效的开发体验。其客户端/服务器分离架构不仅支持本地运行，还可通过移动应用实现远程控制。

安装 OpenCode

可通过下面的 NPM 命令安装 OpenCode 官方 CLI 程序

npm i -g opencode-ai@latest

此外 OpenCode 官网 https://opencode.ai 也提供应用程序插件等其他安装方式。

接入步骤

1️⃣初始化服务商（Provider）

先不要直接启动 OpenCode，而是在终端中执行以下命令：

opencode auth login

• 然后在服务商列表中，选择 other（在最下面，可以直接搜索）。
• 系统会提示你输入 Provider ID： 请填写一个唯一标识名（例如 nineclaw），后续配置需与之严格一致。
• 接着输入 API Key 令牌： 可填写任意内容（如 admin），因为实际密钥可通过配置文件安全引用（见下一步）。

这一步的作用是让 OpenCode 在本地凭证管理器中注册一个自定义服务商，便于后续引用密钥。

2️⃣修改配置文件接入 API

打开 OpenCode 配置目录（文件路径因系统而异）：

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

在该目录下创建或编辑配置文件：opencode.json，文件内容如下：

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "nineclaw": {  // 这里必须和上一步的提供商 ID 完全一致！
      "npm": "@ai-sdk/openai-compatible",
      "name": "NineClaw",  // 在终端中显示的名称，可自定义
      "options": {
        "baseURL": "https://api.nineclaw.cc/v1",  
        "apiKey": "nc-xxxxxxxxxxxxxxxx" // 改为你自己的 API 令牌
      },
      "models": {
        "gpt-5.2-codex": {  // 支持任意模型 ID，例如 gpt-4o、claude-sonnet-4-5 等
          "name": "GPT-5.2"
        },
        "claude-sonnet-4-5-20250929": {
          "name": "Claude-4.5-Sonnet"
        },
        "gemini-3-pro-preview": {
          "name": "Gemini-3-Pro"
        }
        // 添加更多模型...
      }
    }
  }
}

3️⃣重启并验证

保存配置文件后，重启并运行 OpenCode：

opencode

在聊天界面输入命令：

/models

即可在模型列表中看到你配置的中转站及其模型（如 “GPT-5.2”）。选择后即可正常使用！

注意事项

• Provider ID 必须一致：配置文件中的键名（如 nineclaw）必须与 auth login 时输入的 ID 完全相同（区分大小写）。
• API 令牌：打开无限额度，永不过期，其他全部保持默认即可。
• API 地址格式：确保 baseURL 正确。可先用 curl 或 Postman 测试是否响应 /v1/models。
• 模型 ID 要匹配：models 下的键（如 gpt-5）必须与 NineClaw 实际支持的模型 ID 一致。
• 若修改配置后未生效，请尝试完全退出 OpenCode 并重新启动。