1. 文档
  2. 编程工具
  3. Claude Code

在 Claude Code 中使用 Airoutly

设置两个环境变量,Claude Code 就会通过 Airoutly 发送请求。命令和用法都不变,费用从你的 Airoutly 余额扣除。

Base URL
https://api.airoutly.com不带 /v1
Key 变量
ANTHROPIC_AUTH_TOKEN
可用模型
模型页中的 Claude 系列
准备
一个 Airoutly API Key,账户有余额

1. 安装 Claude Code

如果 claude --version 已经能输出版本号,跳过这一步。

curl -fsSL https://claude.ai/install.sh | bash

2. 连接到 Airoutly

推荐写进 Claude Code 的用户设置文件,任何系统、任何终端都生效。把 sk-your-key 换成你自己的 Key。

// ~/.claude/settings.json  (Windows:%USERPROFILE%\.claude\settings.json)
{
"env": {
  "ANTHROPIC_BASE_URL": "https://api.airoutly.com",
  "ANTHROPIC_AUTH_TOKEN": "sk-your-key"
}
}
Base URL 不要带 /v1Claude Code 会自己拼上 /v1/messages,Base URL 末尾再带 /v1 会导致所有请求失败。

3. 选择模型

Claude Code 对话用一个主模型,后台任务另用一个小模型。在同一个 env 里把两者都指定为 Airoutly 上架的模型 ID:

settings.json
"ANTHROPIC_MODEL": "claude-sonnet-4-5",
"ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-4-5"

会话中想临时切换,输入 /model。

4. 验证是否生效

  1. 打开一个新终端,运行 claude。
  2. 输入 /status,Base URL 一行应显示 https://api.airoutly.com。
  3. 发一句简短的提问。几秒内,控制台的用量日志里就会出现这次请求,以及它的 token 数和费用。

常见问题

首次启动提示 “Unable to connect to Anthropic services”

Claude Code 首次启动会直连 Anthropic 做初始化检查。打开 ~/.claude.json,在最外层加上 “hasCompletedOnboarding”: true,保存后重新运行 claude。

401:令牌无效

Key 复制时带了多余空格,或者已被禁用、已过期、超出了额度上限。到控制台的 API Key 页面检查。

503:model_not_found

这个模型 ID 在 Airoutly 上不可用。对照模型页检查 ANTHROPIC_MODEL、ANTHROPIC_DEFAULT_HAIKU_MODEL 和 /model 的选择,ID 区分大小写。

403:insufficient_user_quota

余额不足以支付这次请求。在控制台充值后重试。

Claude Code 询问是否使用自定义 API Key

你设置的是 ANTHROPIC_API_KEY 而不是 ANTHROPIC_AUTH_TOKEN。两者 Airoutly 都支持:确认提示即可,或改用 ANTHROPIC_AUTH_TOKEN 免去提示。