跳到主要内容

使用 OpenCode

本文说明如何在 OpenCode 中配置 ClawdRouter。OpenCode 是终端编码工具，支持 Windows、macOS 和 Linux。

准备工作​

  • API Key。
  • 可调用的模型 ID。
  • 已安装 OpenCode。

1. 安装 OpenCode​

Linux、macOS 或 WSL：

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

Windows 请按照 OpenCode 安装文档 选择适用的安装方式。

安装完成后执行：

opencode --version

2. 创建项目配置​

在代码项目根目录创建或编辑 opencode.json：

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "clawdrouter": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "ClawdRouter",
      "options": {
        "baseURL": "__DOCS_API_ORIGIN__/v1",
        "apiKey": "{env:YOUR_API_KEY}"
      },
      "models": {
        "YOUR_MODEL_ID": {
          "name": "YOUR_MODEL_ID"
        }
      }
    }
  }
}

将 YOUR_MODEL_ID 替换为有权限调用的模型 ID。

3. 设置 API Key​

Windows PowerShell：

$env:YOUR_API_KEY = "YOUR_API_KEY"

Linux、macOS 或 WSL：

export YOUR_API_KEY="YOUR_API_KEY"

请将右侧的 YOUR_API_KEY 替换为真实 API Key。

4. 启动并选择模型​

进入代码项目目录并启动：

opencode

在 OpenCode 内执行：

/models

选择 clawdrouter/YOUR_MODEL_ID，然后输入一个简单的编码需求进行验证。

常见问题​

OpenCode 找不到或无法启动​

关闭并重新打开终端，执行 opencode --version。如仍失败，请重新安装 OpenCode。

提示找不到 YOUR_API_KEY​

请在启动 opencode 的同一个终端中执行第 3 步的环境变量命令。

模型未出现在 /models​

检查 opencode.json 中模型 ID 是否正确、JSON 格式是否有效，以及 API Key 是否有该模型权限。

401、403 或 404​

状态码处理方式
401API Key 无效或未设置。
403当前 Key 没有模型权限。
404Base URL 或模型 ID 填写错误。

修改配置后未生效​

退出 OpenCode，关闭终端后重新打开，再设置 API Key 并启动 OpenCode。

相关链接​