OpenCode

OpenCode 是开源 AI 编程代理，支持终端、桌面和 IDE。猫咖啡 API 可作为自定义 OpenAI Compatible 提供商接入。

安装

macOS / Linux

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

Windows npm

npm install -g opencode-ai

Homebrew

brew install anomalyco/tap/opencode

检查安装：

opencode --version

设置令牌

macOS / Linux / WSL

export COFFEECAT_API_KEY="sk-你的令牌"

Windows PowerShell

$env:COFFEECAT_API_KEY="sk-你的令牌"

配置提供商

全局配置通常位于：

• macOS、Linux、WSL：~/.config/opencode/opencode.json
• Windows：%USERPROFILE%\.config\opencode\opencode.json

也可以在项目根目录创建 opencode.json。示例：

{
  "$schema": "https://opencode.ai/config.json",
  "model": "coffeecat/控制台中的模型 ID",
  "provider": {
    "coffeecat": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "猫咖啡 API",
      "options": {
        "baseURL": "https://coffeecatbox.cc/v1",
        "apiKey": "{env:COFFEECAT_API_KEY}"
      },
      "models": {
        "控制台中的模型 ID": {
          "name": "猫咖啡编程模型"
        }
      }
    }
  }
}

model 的格式是 提供商 ID/模型 ID，两处模型 ID 必须一致。

Responses 模型

上面配置走 /v1/chat/completions。如果模型只支持 Responses，可将 provider 的 npm 改为 @ai-sdk/openai 后测试；具体可用性取决于模型渠道。

启动与验证

cd /path/to/project
opencode

在 OpenCode 中运行：

/models

确认能看到 coffeecat 下配置的模型，然后先用 Plan 模式做一个只读任务。

常见问题

• 提供商不显示：检查 JSON 是否有效，以及配置文件路径是否正确。
• 凭据无效：确认启动 OpenCode 的终端可以读取 COFFEECAT_API_KEY。
• 模型不显示：provider ID、model 前缀和 models 键必须一致。
• 工具调用失败：换用支持 OpenAI 原生工具调用的模型。