两分钟配置好 Claude Code + apmix

Claude Code 是 Anthropic 推出的终端编程智能体：它会阅读你的代码库、修改文件、运行命令、编写测试。它调用的是 Anthropic API，而 apmix 提供的正是同一套 API。所以你可以用 apmix 密钥运行 Claude Code，使用套餐内的 Claude 模型，只需一份月度额度，而不用单独支付 Anthropic 账单。

整个配置大约两分钟。你需要一个带 API 密钥的 apmix 账号（在控制台创建）以及 Node.js 18 或更高版本。

1. 安装 Claude Code#

如果你的机器上已经能运行 claude，可以跳过这一步。

npm install -g @anthropic-ai/claude-code

2. 指向 apmix#

Claude Code 读取三个环境变量。因为它使用 Anthropic 协议，Base URL 是 https://api.apmix.ai，不带 /v1，Claude Code 会自己补上路径。

macOS 或 Linux：

export ANTHROPIC_BASE_URL="https://api.apmix.ai"
export ANTHROPIC_AUTH_TOKEN="apx_live_YOUR_KEY"
export ANTHROPIC_MODEL="claude-sonnet-5"

Windows 的 PowerShell：

$env:ANTHROPIC_BASE_URL = "https://api.apmix.ai"
$env:ANTHROPIC_AUTH_TOKEN = "apx_live_YOUR_KEY"
$env:ANTHROPIC_MODEL = "claude-sonnet-5"

这些设置只对当前终端有效，第一次试用正合适；下一步会让它永久生效。

3. 永久保存#

Claude Code 还会读取 ~/.claude/settings.json 中的设置。把同样的值放进它的 env 块，之后每个新终端都能直接使用：

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.apmix.ai",
    "ANTHROPIC_AUTH_TOKEN": "apx_live_YOUR_KEY",
    "ANTHROPIC_MODEL": "claude-sonnet-5"
  }
}

文档里提供了 PowerShell 和 bash 的一行脚本，可以自动写入这个文件，并备份旧文件。

4. 运行#

进入你的项目，启动 Claude Code：

cd your-project
claude

就这样：之后每个请求都会经过 apmix，并计入你的套餐额度。

用 /model 切换模型#

在 Claude Code 中输入 /model，即可为当前会话切换模型，可以使用模型目录中的任意 Claude 模型 ID：

每个模型都有自己的权重 token 倍率，列在价格页上。日常工作用更轻量的模型，同样的额度能用得更久；详见权重 token 详解。

检查密钥是否可用#

如果有问题，先列出你的密钥能调用的模型。返回 JSON 列表就说明密钥和 URL 都正确：

curl https://api.apmix.ai/v1/models -H "Authorization: Bearer apx_live_YOUR_KEY"

最常见的返回及处理方法：

• 401 invalid_api_key：密钥错误或已被删除。请到控制台 → API 密钥重新复制。
• 403 model_not_in_plan：该模型高于你的套餐。GET /v1/models 只会列出你的套餐能调用的模型，请从中选择或升级套餐。
• 429 rate_limit_exceeded：同一个密钥一分钟内超过 60 个请求（Max 为 120 个）。请等待 retry-after 中给出的秒数。

每个错误都在错误参考中有说明，每个响应都带有 x-apmix-request-id 响应头，联系支持时请附上它。

随时掌握用量#

智能体很“能吃”：一次长时间的 Claude Code 会话可能发送数百万 token。以下三点很有帮助：

1. 关注控制台 → 日志，实时显示每个请求的模型、token 和费用。
2. 在设置中配置可选的每日或每周上限，防止失控的会话耗尽整月额度。
3. 开启邮件提醒，在额度用到 50%、70%、80% 或 90% 时通知你。

做好这些，Claude Code 在 apmix 上的体验与原版完全一样，而你运行的其他一切也只需一个密钥、一张账单。