Air Router

外观

Claude Code 接入 ​

Claude Code 使用 Anthropic Messages 协议。Air Router 的 Claude Base URL 为：

text
https://www.air-router.com

不要附加 /v1

Claude Code 会自动请求 /v1/messages。如果配置成 https://www.air-router.com/v1，最终路径可能重复并导致 404。

1. 安装 Claude Code ​

bash
curl -fsSL https://claude.ai/install.sh | bash
powershell
irm https://claude.ai/install.ps1 | iex
bash
npm install -g @anthropic-ai/claude-code

验证安装：

bash
claude --version

如果提示找不到命令，请重新打开终端，并确认安装目录已经加入 PATH。

2. 配置 Air Router ​

Claude Code 的用户设置文件位于：

系统路径
macOS / Linux / WSL~/.claude/settings.json
WindowsC:\Users\<用户名>\.claude\settings.json

创建目录和文件后写入：

json
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://www.air-router.com",
    "ANTHROPIC_AUTH_TOKEN": "sk-your-key",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
  }
}

字段含义：

字段说明
ANTHROPIC_BASE_URLAir Router 的 Claude 网关根地址，不含 /v1
ANTHROPIC_AUTH_TOKEN在控制台创建的 API Key
CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC关闭非必要的官方网络请求，减少中转环境下的干扰

配置文件包含密钥

不要把 ~/.claude/settings.json 提交到 Git 或发到公开工单。截图排错前请遮盖完整密钥。

3. 选择模型 ​

通常无需在文档中固定模型名称。先用 API Key 查询可用模型：

bash
curl https://www.air-router.com/v1/models \
  -H "Authorization: Bearer sk-your-key"

如果需要覆盖 Claude Code 的默认模型，可在 env 中增加控制台返回的实际模型 ID。不要直接照抄其他服务商文档中的型号，因为不同分组的映射可能不同。

4. 启动并验证 ​

进入一个测试项目后运行：

bash
claude

首次测试可以输入：

text
只回复：Air Router 已连接

同时在 Air Router 控制台查看请求记录或用量变化。客户端正常回复且控制台出现记录，即表示接入成功。

临时配置方式 ​

不想立即修改设置文件时，可以只在当前终端设置：

bash
export ANTHROPIC_BASE_URL="https://www.air-router.com"
export ANTHROPIC_AUTH_TOKEN="sk-your-key"
export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC="1"
claude
powershell
$env:ANTHROPIC_BASE_URL="https://www.air-router.com"
$env:ANTHROPIC_AUTH_TOKEN="sk-your-key"
$env:CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC="1"
claude

关闭当前终端后，以上临时变量会失效。

常见问题 ​

返回 404 ​

检查 ANTHROPIC_BASE_URL 是否误写成了 https://www.air-router.com/v1。Claude Code 配置必须去掉末尾 /v1。

返回 401 ​

确认使用的是 ANTHROPIC_AUTH_TOKEN，密钥完整且没有额外空格。然后在控制台检查 Key 是否已禁用或过期。

提示模型不可用 ​

确认当前 Key 的分组包含 Claude 模型，并使用 /v1/models 返回的模型 ID。模型包到期或额度耗尽也可能表现为模型不可用。

仍然访问官方域名 ​

完全退出并重新启动 Claude Code，检查 settings.json 是否为合法 JSON，并确认环境中没有另一组同名变量覆盖配置。

更多状态码说明见常见问题与排错。