接入 OpenCode

将 OpenCode 连接到 Puyun AI，在终端里使用 Anthropic 兼容协议进行代码任务。

安装 OpenCode

先安装 Node.js 18 或更高版本，然后执行：

bash
npm install -g opencode-ai
opencode -v

手动配置

打开 OpenCode 配置文件：

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

写入或合并以下 provider 配置：

json
{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "puyunai": {
      "npm": "@ai-sdk/anthropic",
      "name": "Puyun AI",
      "options": {
        "baseURL": "https://ai.tracup.com/v1",
        "apiKey": "sk-your-api-key"
      },
      "models": {
        "claude-sonnet-4-6": {
          "name": "Claude Sonnet 4.6"
        },
        "gpt-4o": {
          "name": "GPT-4o"
        },
        "gemini-2.5-pro": {
          "name": "Gemini 2.5 Pro"
        },
        "deepseek-chat": {
          "name": "DeepSeek Chat"
        }
      }
    }
  }
}

如需添加更多模型，在 models 中追加模型 ID 即可。

验证配置

保存配置后重启 OpenCode，输入：

text
/models

在模型列表中选择 Puyun AI 下的模型，然后开始对话。

常见问题

OpenCode 找不到 Puyun AI provider

请检查 JSON 是否有效，尤其是已有配置中合并 provider 对象时不要覆盖其他字段。保存后重启 OpenCode。

401 或认证失败

确认 apiKey 是 Puyun AI API Key，并且没有多余空格。

404 或请求路径错误

OpenCode 这类基于 Anthropic SDK 的配置应使用 https://ai.tracup.com/v1。如果你改成了不带 /v1 的地址，可能会请求到错误路径。