主题
语言

Claude Code CLI

将 Claude Code CLI 连接到 GetVibe API:通过环境变量设置 ANTHROPIC_BASE_URL、ANTHROPIC_AUTH_TOKEN 和模型选择。

现成配置

根据请求从我们的目录构建:API 地址、每个已发布模型及其上下文和输出限制,以及推荐设置。其中不包含密钥。Claude Code 通过 apiKeyHelper 从 GETVIBE_API_KEY 读取密钥 — 请在环境中设置它。在没有 WSL 的 Windows 上,请改为设置 ANTHROPIC_AUTH_TOKEN。

# macOS / Linux
mkdir -p ~/.claude
curl -fsSL https://getvibeapi.com/api/integrations/claude-code.json -o ~/.claude/settings.json
# Windows PowerShell
New-Item -ItemType Directory -Force "$HOME\.claude" | Out-Null
Invoke-WebRequest https://getvibeapi.com/api/integrations/claude-code.json -OutFile "$HOME\.claude\settings.json"
  • 主模型 — claude-opus-5.5:我们通过 /v1/messages 提供的最强 Claude 模型。
  • 小型任务 — claude-haiku-4.5:最便宜的 Claude,由 Claude Code 用于后台任务。
  • 启用流式传输,请求超时时间为 600 秒,推理力度为 medium:较长的推理回答需要几分钟,而不使用流式传输会达到等待时限。
  • 所有地方都使用不带 :suffix 的纯模型 ID,这样可以保持自动故障转移到健康通道的功能。
目录会发生变化:出现新模型时,请再次下载该文件。若只保留部分模型,请在 URL 中添加带逗号分隔 ID 的 ?models=。
不想用终端? 大多数任务用 Claude Desktop 应用更简单:几步操作,不用命令。本页面向在终端里写代码的人。

Claude Code 是 Anthropic 官方的智能体编程 CLI。它通过 /v1/messages 端点并使用 x-api-key 请求头工作。

1. 打开终端

Windows:开始 → 输入 PowerShell → Enter。macOS:终端(应用程序 → 实用工具)。通过 npm 安装需要 Node.js 22 或更高版本(node --version)——下方代码块用于安装 CLI 本身。不想使用 Node.js?也可以使用 Anthropic 的原生安装程序:curl -fsSL https://claude.ai/install.sh | bash(macOS/Linux)或 irm https://claude.ai/install.ps1 | iex(PowerShell);然后在新窗口中设置下方变量。

2. 粘贴一整块内容并回车

这块内容会安装 CLI、永久保存设置(setx)、在当前窗口生效并启动程序。把 sk-pv-… 换成你的密钥。

Windows(PowerShell)

npm.cmd install -g @anthropic-ai/claude-code
setx ANTHROPIC_BASE_URL "https://getvibeapi.com"
setx ANTHROPIC_AUTH_TOKEN "sk-pv-…"
$env:ANTHROPIC_BASE_URL="https://getvibeapi.com"
$env:ANTHROPIC_AUTH_TOKEN="sk-pv-…"
$env:ANTHROPIC_API_KEY=""
claude.cmd

macOS / Linux

npm install -g @anthropic-ai/claude-code
export ANTHROPIC_BASE_URL="https://getvibeapi.com"
export ANTHROPIC_AUTH_TOKEN="sk-pv-…"
export ANTHROPIC_API_KEY=""
claude
重要:地址为 https://getvibeapi.com(不带 /v1):CLI 会自行添加后缀。将密钥填入 ANTHROPIC_AUTH_TOKEN,并将 ANTHROPIC_API_KEY 留空:如果计算机上已保存 Anthropic 密钥,否则 Claude Code 会警告存在两个冲突的密钥。执行 setx 后,新打开的 PowerShell 窗口会读取这些设置;已打开的窗口则不会。

在哪里输入

启动后,窗口底部带 > 的那一行就是输入并回车的地方:

+---------------------------------------+
|                                       |
|  > _                                  |
|                                       |
+---------------------------------------+

第一次启动会问主题(按回车)和是否信任文件夹(选 Yes, I trust this folder)。真正干活时,请从项目文件夹启动 CLI。

3. 检查连接

发送任意消息,然后打开控制台 → 用量:会出现一条新记录,显示模型和费用。在 Claude Code 中,/status 会显示 Anthropic base URL 行——其中必须显示我们的地址。

选择模型(可选)

默认情况下 Claude Code 使用目录里的默认模型。可用环境变量覆盖:

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "sk-pv-…",
    "ANTHROPIC_BASE_URL": "https://getvibeapi.com",
    "ANTHROPIC_API_KEY": "",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-5.5",
    "ANTHROPIC_DEFAULT_OPUS_MODEL":   "claude-opus-5.5",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL":  "claude-haiku-5.5"
  }
}

如果你更习惯 settings.json

通过文件 ~/.claude/settings.json 也能达到相同效果。Windows 上:%USERPROFILE%\.claude\settings.json。请粘贴密钥本身:Claude Code 不会展开 settings.json 中的 $GETVIBE_API_KEY 等变量,因此会将该字符串作为密钥发送,导致请求被拒绝。

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "sk-pv-…",
    "ANTHROPIC_BASE_URL": "https://getvibeapi.com",
    "ANTHROPIC_API_KEY": ""
  }
}

常见问题

参数类型描述
401error检查 ANTHROPIC_AUTH_TOKEN 的值:settings.json 中必须保存 sk-pv-… 密钥本身,而不是 $variable。
Requests go to AnthropicconfigANTHROPIC_BASE_URL 未传递到 Claude Code:执行 setx 后打开新窗口,或在 settings.json 中设置地址。检查 /status 中的 Anthropic base URL 行。
404errorANTHROPIC_BASE_URL 里多了 /v1 —— 应为不带后缀的根地址。
npm.ps1 is blockedWindows这是 PowerShell 的执行策略。按上面的整块用 npm.cmd 和 claude.cmd 即可,不必改策略。
"node is not recognized"WindowsNode.js 没装,或窗口是在安装之前打开的:安装 Node.js LTS 并打开一个新的 PowerShell 窗口。
claude native binary not installed / warn install-scriptsnpm较新的 npm 版本默认跳过 Claude Code 的安装步骤。请运行 npm config set "allow-scripts=@anthropic-ai/claude-code" --location=user 后重新安装,或使用原生安装程序。
Variables are not picked upconfigsettings.json 比 shell 配置文件更可靠,尤其是在 Windows 上。
Claude Code + GetVibe API — settings.json 配置 | GetVibe API