← 博客
Claude Code教程配置指南

如何用实惠的 API 配置 Claude Code

· 更新于 （文中价格随实时价格表更新）

简短回答

要让 Claude Code 通过 APIVAI 运行，只需设置两个环境变量：ANTHROPIC_BASE_URL="https://api.apivai.com" 和 ANTHROPIC_AUTH_TOKEN="<你的密钥>"，然后照常运行 claude。Claude Code 通过 ANTHROPIC_AUTH_TOKEN 接受任何兼容 Anthropic 的 API 密钥。Claude Code 本身不变：请求发往同样的 Claude 模型，费用按 APIVAI 价格从预付余额中扣除，例如 Claude Sonnet 4.6 每百万输入 / 输出 token 为 $1.15 / $5.74（截至 2026-10-10），比官方标价低 62%。配置大约只需五分钟。

Claude Code 是什么？

Claude Code 是 Anthropic 推出的命令行编程代理。你在项目文件夹中运行它，用自然语言描述任务，它会读取文件、提出并完成修改、运行测试或构建等命令，并说明自己做了什么。Anthropic 推荐用官方安装脚本安装（macOS 和 Linux：curl -fsSL https://claude.ai/install.sh | bash；Windows PowerShell：irm https://claude.ai/install.ps1 | iex），也可以用 npm 包 @anthropic-ai/claude-code 安装，需要 Node.js 22 或更高版本。文档见 Anthropic 的 Claude Code 文档。

Claude Code 的每一步都是一次对 Claude 模型的 API 请求，而在真实代码库上工作的代理每次请求都会附带大量上下文。因此对 Claude Code 来说，单个 token 的价格比偶尔聊天更重要。默认情况下它通过 Anthropic API 按标价计费（Claude Sonnet 4.6 每百万 token $3.00 / $15.00）。更完整的数字分析见 如何降低 Claude Code 和 GPT API 的费用。

Claude Code 如何使用第三方 API 服务？

Claude Code 从环境变量中读取连接设置：

  • ANTHROPIC_BASE_URL：请求发送的地址。APIVAI 的地址是 https://api.apivai.com，不带 /v1，结尾也不带斜杠，因为 Claude Code 会自己加上 /v1/messages。
  • ANTHROPIC_AUTH_TOKEN：每次请求附带的密钥。

改变的： 地址和密钥。不变的： Claude Code 本身、它的命令、工具、权限以及它所调用的 Claude 模型。

准备工作

  • 已安装 Claude Code（官方安装脚本，或通过 npm 安装并使用 Node.js 22+；claude --version 应能输出版本号）
  • 已充值的 APIVAI 账户
  • 在 APIVAI 控制台（Dashboard）创建的 API 密钥
  • 终端：macOS/Linux 上的 bash 或 zsh，Windows 上的 PowerShell 或 cmd

第 1 步：获取 Claude Code API 密钥

  1. 用邮箱和收到的验证码 注册账户。
  2. 充值余额。银行卡或加密货币最低 $10，支付宝 / 微信支付最低 ¥20。没有订阅，也没有每月最低消费。
  3. 在控制台创建 API 密钥。给它起个名字，例如 "claude-code-laptop"，并设置预算。密钥用完预算后会停止工作，因此失控的会话不会花光你的全部余额。
  4. 复制密钥并妥善保管。建议每台机器或每个项目使用单独的密钥，这样可以分别查看费用，也能单独停用某个密钥而不影响其他密钥。

第 2 步：配置终端

macOS 和 Linux

把以下内容加入 shell 配置文件：~/.zshrc（macOS 默认）或 ~/.bashrc：

export ANTHROPIC_BASE_URL="https://api.apivai.com"
export ANTHROPIC_AUTH_TOKEN="你的密钥"

重新加载配置并启动 Claude Code：

source ~/.zshrc   # 或：source ~/.bashrc
claude

Windows PowerShell

用 notepad $PROFILE 打开配置文件（如果 PowerShell 提示文件不存在，就新建一个），加入：

$env:ANTHROPIC_BASE_URL = "https://api.apivai.com"
$env:ANTHROPIC_AUTH_TOKEN = "你的密钥"

打开一个新的 PowerShell 窗口，运行 claude。

Windows cmd

setx 会永久保存用户环境变量：

setx ANTHROPIC_BASE_URL "https://api.apivai.com"
setx ANTHROPIC_AUTH_TOKEN "你的密钥"

setx 不会改变当前窗口，只对之后新打开的终端生效。关闭当前窗口，打开一个新窗口，再运行 claude。这样设置的变量在 PowerShell 中同样可见。

另一种方式：Claude Code 的设置文件

除了 shell 变量，你也可以把它们写进 Claude Code 的用户设置文件 ~/.claude/settings.json（Windows 上为 %USERPROFILE%\.claude\settings.json）中的 env 对象：

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.apivai.com",
    "ANTHROPIC_AUTH_TOKEN": "你的密钥"
  }
}

如果文件已存在，请把 env 块加进去，而不是覆盖整个文件。这样设置只对 Claude Code 生效。文件位置和优先级可能随版本变化，最新细节请参阅 Anthropic 的 Claude Code 设置文档。

第 3 步：启动 Claude Code 之前先验证密钥

直接发一个请求，就能在不涉及 Claude Code 的情况下确认密钥、地址和网络是否正常。在 macOS/Linux 上，加载第 2 步的变量后运行：

curl https://api.apivai.com/v1/messages \
  -H "x-api-key: $ANTHROPIC_AUTH_TOKEN" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model":"claude-haiku-4-5","max_tokens":50,"messages":[{"role":"user","content":"Say hello"}]}'

在 PowerShell 中：

$body = '{"model":"claude-haiku-4-5","max_tokens":50,"messages":[{"role":"user","content":"Say hello"}]}'
Invoke-RestMethod -Uri "https://api.apivai.com/v1/messages" -Method Post -ContentType "application/json" -Headers @{ "x-api-key" = $env:ANTHROPIC_AUTH_TOKEN; "anthropic-version" = "2023-06-01" } -Body $body

如果返回带有 content 字段的 JSON，说明一切正常，这次请求也会很快出现在控制台中。如果返回错误码，请对照下文排错表中的对应行。注意：测试地址包含 /v1/messages，而 ANTHROPIC_BASE_URL 中不能包含。

如何选择和切换模型？

在 Claude Code 中输入 /model 即可为当前会话选择模型。主要选项如下，截至 2026-10-10（完整列表见 价格页）：

模型APIVAI 每百万价格（输入 / 输出）适合
Claude Fable 5.1$4.42 / $22.08最难的问题、长时间自主任务
Claude Opus 5.5$1.54 / $7.65复杂编程、重构、分析
Claude Sonnet 5.5$0.77 / $3.82日常编程：推荐的默认选择
Claude Sonnet 4.6$1.15 / $5.74支持最广泛；Sonnet 5.5 更新、更便宜
Claude Haiku 4.5$0.38 / $1.92快速修改和简单问题

一个实用的做法：先用 Sonnet，遇到卡住或需要更深推理的任务时用 /model 切换到 Opus，解决后再切回来。

如何降低 Claude Code 的费用？

  • 日常工作用 Sonnet。 大多数修改、测试和解释都不需要 Opus 或 Fable，而 Sonnet 的单 token 价格只是它们的一小部分。
  • 压缩长会话。 Claude Code 提供 /compact 命令，可以总结目前的对话，让后续请求携带更少的上下文。会话变长时使用它，或者为新任务开一个新会话（命令的最新行为以 Anthropic 文档为准）。
  • 让提示缓存发挥作用。 Claude Code 会自动缓存重复的上下文，例如系统提示和文件。缓存输入按缓存读取价计费（Claude Sonnet 4.6 每百万 $0.12），远低于普通输入。
  • 为每个密钥设置预算。 密钥达到预算就会停止，从而限制任何一台机器、一个项目或一位同事的花费。
  • 关注控制台。 每个请求都列出了模型、token 数和费用，可以看出哪些会话花费较高。

用同一个密钥使用 Codex CLI

同一个 APIVAI 密钥也能用于 OpenAI 的 Codex CLI，它使用 OpenAI 格式，base URL 需要带 /v1。对于 Codex 0.121 及更高版本，把以下内容写入 ~/.codex/config.toml（Windows 上为 %USERPROFILE%\.codex\config.toml）：

model = "gpt-5.5"
model_provider = "apivai"

[model_providers.apivai]
name = "APIVAI"
base_url = "https://api.apivai.com/v1"
env_key = "OPENAI_API_KEY"
wire_api = "responses"

然后设置密钥并启动 Codex：

export OPENAI_API_KEY="你的密钥"
codex

Cursor 也是同样的思路，见 Cursor 配置指南。

排错

现象可能原因解决方法
401 Unauthorized密钥错误或已删除，或密钥已用完预算从控制台重新复制密钥；提高密钥预算或充值
密钥正确仍然 401Claude Code 用的是别的凭据：旧的 ANTHROPIC_API_KEY、apiKeyHelper 或 /login 登录（/status 会显示当前用的是哪个）去掉多余的，例如：unset ANTHROPIC_API_KEY（bash/zsh）、Remove-Item Env:ANTHROPIC_API_KEY（PowerShell），并从配置文件和设置中删除
404 Not Foundbase URL 带了 /v1 或有拼写错误Claude Code 只用 https://api.apivai.com；/v1 只用于 Codex 等 OpenAI 格式工具
429 Too Many Requests单个密钥每分钟超过 60 次请求稍等片刻，或联系客服提高限额
Claude Code 仍在用旧账户当前终端没有加载变量打开新终端；用 echo $ANTHROPIC_BASE_URL 或 echo $env:ANTHROPIC_BASE_URL 检查
超时或连接错误你的网络中有代理、防火墙或 TLS 检查放行 api.apivai.com，或在 HTTPS_PROXY 中设置你所在网络的代理（Claude Code 的代理支持见 Anthropic 文档）

如果问题仍然存在，请运行第 3 步的 curl 测试：它能把密钥和网络问题与 Claude Code 配置问题区分开。文档 中列出了所有接口和错误。

所有 API 错误码及解决方法见 Claude API 错误码大全。

Claude Code 每月要花多少钱？

假设使用 Claude Sonnet 4.6，每条消息约 4,000 输入 token、1,500 输出 token，按 30 天计算，截至 2026-10-10：

每日用量官方 APIAPIVAI
轻度（每天 10 条）$10.35$3.96
中度（每天 30 条）$31.05$11.89
重度（每天 100 条）$104$39.63

以上数字未计入提示缓存，实际账单通常会更低。在大型代码库上运行的代理会话每条消息可能携带更多上下文，所以用了几天后请看看控制台。最新价格见 价格页；与订阅制工具的对比见 Claude Code 与 Cursor 费用对比。

常见问题

这样使用 Claude Code 需要 Anthropic 账户吗？

不需要 Anthropic API 密钥。Claude Code 会把请求发到你设置的 base URL，并用 APIVAI 密钥进行认证。

模型和官方 API 一样吗？

一样。请求会转发到你用 /model 选择的 Claude 模型；改变的只有地址和计费方式。

可以切换回自己的 Anthropic 账户吗？

可以。删除或注释掉这两个变量（或 settings.json 中的 env 块），然后打开新终端。

APIVAI 能看到我的代码吗？

APIVAI 不存储也不查看请求和响应的内容，只保留用于计费的使用元数据（模型、token 数、费用、时间）。

余额或密钥预算用完会怎样？

在你充值或提高密钥预算之前，请求会返回 401。不会产生超出预付余额的费用。

一个密钥能同时用于 Claude Code 和 Codex 吗？

可以。一个密钥同时支持 Anthropic 格式（https://api.apivai.com）和 OpenAI 格式（https://api.apivai.com/v1）。

准备好了吗？

30 秒获取 API 密钥，按量付费使用 Claude 和 GPT

开始使用