Claude Code 有两种完全分开的价格,几乎所有关于其成本的困惑都源于将二者混为一谈。claude.ai 订阅将工具包含在固定月费中,并设有使用限制。API 密钥按 token 计费,无月费且没有使用上限。本页面介绍两种路线的当前数字、如何选择、一个真实月份的成本,以及——葡萄牙语内容中经常缺少的部分——如何从巴西付款。
费率核验于 2026年10月10日,依据 claude.com/pricing 和 Anthropic 的API 价格文档。Kunavo 的 token 价格实时读取模型目录。
两种路线并列比较
| 订阅(Pro / Max) | API 密钥(按量付费) | |
|---|---|---|
| 你支付的内容 | 固定月费,起价 $20 | 按 token 计费,无月费 |
| 限制 | 5 小时滚动使用窗口和每周使用窗口,与 Claude 聊天共享 | 无——用多少付多少 |
| 闲置一个月 | 全额收费 | 不花费任何费用 |
| 高强度使用一个月 | 有限制——达到上限后等待 | 与工作同步,账单也同步 |
| 巴西付款方式 | 网站使用信用卡或借记卡,或使用应用商店 | Pix、国际银行卡、Apple Pay、Google Pay |
订阅费用
Claude Code 已包含在 claude.ai 的付费套餐中——Anthropic 的安装文档明确表示,免费套餐无法访问 Claude Code。Pro 费用为 $20/月(按年计费时为 $17/月,一次性支付 $200),适合在套餐限制内工作的开发者。Max 起价为 $100/月,适合经常触及这些限制的用户。Team 和 Enterprise 额外提供按席位计算的配额和支出管理控制。
在巴西,有两个细节会影响成本:费用以美元计并按月自动续费,需要启用境外消费功能的国际信用卡——发卡行的 IOF 和国际交易手续费会每月产生;此外,使用限制与 Claude 聊天共享,因此一个下午的对话会消耗与你代码会话相同的使用窗口。
API 路线的费用
这里没有月费:你按 token 付费。价格以每 100 万个 token 的美元金额表示,并在旁边列出 Anthropic 官方表格,以便直接比较。
| 模型 | Kunavo 输入 / 输出 | Anthropic 标价(input / output) | 节省金额 | 每一步的成本 |
|---|---|---|---|---|
claude-haiku-4-5 | $0.70 / $3.50 | $1.00 / $5.00 | ~30% | $0.0217 |
claude-sonnet-4-6 | $2.10 / $10.50 | $3.00 / $15.00 | ~30% | $0.065 |
claude-sonnet-5 | $1.40 / $7.00 | $2.00 / $10.00 | ~30% | $0.043 |
claude-opus-5 | $3.50 / $17.50 | $5.00 / $25.00 | ~30% | $0.109 |
“每一步的成本”是任务中与模型的一次往返——输入包括系统提示、历史记录和文件上下文(约 25,000 个 token),输出包括一次编辑或解释(约 1,200 个 token)。这是理解 Claude Code 的正确单位,因为该工具会在每一步重新读取上下文。
一个真实月份的费用
Anthropic 的成本文档报告称,在企业部署中,每位开发者每个活跃日约为 $13,每位开发者每月为 $150–250,且 90% 的用户每个活跃日低于 $30。这些是混合使用多种模型时的完整目录价格。按 Kunavo 的费率,相同用量的成本降低 30%;将后台调用发送到 Claude Haiku 4.5(每 100 万个 token 的价格为 $0.70 / $3.50)还能进一步减少一部分成本。
按 Kunavo 费率计算,盈亏平衡点是:$20 大约可以在 Sonnet 5 上购买每月 460 个 agentic 步骤,约等于 23 个 20 步任务。在低于这一用量时,按量付费更划算,因为轻量月份的成本为零。超过这一用量后,月费更划算——直到你达到套餐限制并等待使用窗口刷新。
在巴西付款——Pix,无需国际信用卡
这通常才是真正的障碍,而不是价格。在网站上购买的订阅仅接受信用卡或借记卡(Anthropic 帮助中心,查询于 2026 年 10 月 1 日);通过手机应用购买时,由 App Store 或 Google Play 扣款。通过 Kunavo 使用 API 密钥的支付路径不依赖银行卡:结账由 Stripe 处理,对于从巴西付款的用户,Pix 会作为支付方式显示,并提供以雷亚尔计价且即时到账。对于偏好其他方式的用户,国际银行卡(Visa、Mastercard、American Express)、Apple Pay 和 Google Pay 仍然可用。
每个 token 的费率以 USD 定价:使用 Pix 时,Stripe 会在付款时显示换算后的巴西雷亚尔金额;使用银行卡时,换算遵循发卡行汇率(请在银行应用中确认 IOF 和国际交易手续费)——Pix 付款步骤请参阅使用 Pix 支付 API 指南。这是一个预付钱包——最低充值金额为 $10,无订阅、无自动续费,并且余额永不过期。根据上面的计算,Pix 充值 $10 已足够支付约 12 个 20 步 agentic 任务。有关巴西的完整背景信息(圣保罗延迟、LGPD、发票)请参阅巴西 Claude API 指南。
如何将 Claude Code 指向 Kunavo
Claude Code 会读取环境变量中的端点和凭据——六行代码,无需代理或插件:
export ANTHROPIC_BASE_URL=https://api.kunavo.com
export ANTHROPIC_AUTH_TOKEN=sk-kn-...
export ANTHROPIC_MODEL=claude-sonnet-5
export ANTHROPIC_DEFAULT_OPUS_MODEL=claude-opus-5-5
export ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-5
export ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-haiku-4-5模型行不是可选项:Claude Code 的默认模型以及 opus 和 sonnet 别名会跟随 Anthropic 的最新模型。sonnet 别名会请求 Sonnet 5.5,而 Kunavo 不提供该模型:没有 ANTHROPIC_DEFAULT_SONNET_MODEL 时,/model sonnet、opusplan 的执行阶段以及使用 model: sonnet 的子代理都会返回 404。opus 别名固定到 Claude Opus 5.5(Kunavo 中每 1M 个令牌的 claude-opus-5-5、$2.80 / $14.00),这要求 Claude Code 2.1.280 或更高版本——如果版本较旧,请运行 claude update。设置了 ANTHROPIC_AUTH_TOKEN 后,Claude Code 会使用该密钥,而不是已保存的登录信息:套餐限额不再适用,使用量将从密钥余额中扣除。删除该变量后,它会恢复使用订阅——可以通过 shell 在两条路径之间切换。密钥可在 控制面板中创建,完整步骤请参阅 Claude API 密钥指南。
一次真实会话的计算
在 Claude Code 中运行 /usage,查看会话的四个数字(新输入、输出、缓存读取和缓存写入),然后将它们代入此函数:
# Quanto custou uma sessão do Claude Code, a partir dos tokens dela.
# Rode /usage dentro do Claude Code para pegar os quatro números reais.
RATES = { # USD por 1M de tokens na Kunavo: (input, output, leitura de cache / input)
"claude-haiku-4-5": (0.70, 3.50, 0.1),
"claude-sonnet-4-6": (2.10, 10.50, 0.1),
"claude-sonnet-5": (1.40, 7.00, 0.1),
"claude-opus-5": (3.50, 17.50, 0.1),
"claude-opus-5-5": (2.80, 14.00, 0.05),
}
def custo_sessao(model, inp, out, cache_read=0, cache_write=0):
i, o, r = RATES[model]
return (
inp / 1e6 * i # input novo
+ out / 1e6 * o # output, incluindo tokens de raciocínio
+ cache_read / 1e6 * i * r # leitura de cache: fração r da tarifa de input
+ cache_write / 1e6 * i * 1.25 # escrita de cache de 5 min: 125%
)
print(custo_sessao("claude-sonnet-5", 1_200, 5_300, 940_000, 50_000))请注意缓存读取的影响:在长会话中,它占据令牌计数的主要部分,而其价格恰恰只有 Sonnet 5 输入费率的 10%(Opus 5.5 为 5%)。因此,提示缓存而非模型选择,是 Claude Code 中单独影响成本最大的杠杆。
如何降低账单
- 让缓存发挥作用。 Sonnet 5 的缓存输入费用为费率的 10%(Opus 5.5 为 5%),而 Claude Code 会在每一步重新读取完整对话(了解其工作方式)。
- 在无关任务之间清理上下文。 无休止的会话会在每一步重新发送完整历史记录;上下文越短,成本越低。
- 根据问题规模选择模型。 将最大模型设为默认模型,是最昂贵且最常见的错误。
- 不要移除 Haiku 这一行。如果没有
ANTHROPIC_DEFAULT_HAIKU_MODEL,Claude Code 的haiku别名会请求 Kunavo 不提供的 ID(从 v2.1.293 起为 Haiku 5.5),导致/model haiku和设为model: haiku的子代理返回 404。同一行还会将频繁且琐碎的内部调用从主模型转移出去。
还没有安装?请参阅Claude Code 安装指南。如果你是在与 OpenAI 的代理进行比较,Codex 的相同计算请参阅Codex 需要多少钱。
常见问题
Claude Code 需要多少钱?
根据付款方式不同,有两种分开的价格。在 claude.ai 订阅中,Claude Code 已包含在月费内:Pro 费用为 $20/月(按年计费时为 $17/月,一次性支付 $200),Max 起价为 $100/月。使用 API 密钥时按 token 付费,无月费——在 2026年10月10日,Anthropic 列出的 Claude Sonnet 5 价格为每 100 万个 token 输入 $2.00 / 输出 $10.00,Claude Opus 5 为 $5.00 / $25.00;Anthropic 自己的文档估计,实际使用成本约为每位开发者每个活跃日 $13、每位开发者每月 $150–250。通过 Kunavo,同样的模型价格为 $1.40 / $7.00 和 $3.50 / $17.50。 模型费率请参阅价格页面。
在巴西如何支付 Claude Code?支持 Pix 吗?
在 claude.ai 网站购买的订阅仅接受信用卡或借记卡,并按月续费;通过手机应用购买时,由 App Store 或 Google Play 扣款。订阅不支持 Pix。通过 Kunavo 使用 API 密钥的支付路径支持 Pix:结账由 Stripe 处理,金额以雷亚尔显示,并即时到账,无需依赖国际银行卡。国际银行卡(Visa、Mastercard、American Express)、Apple Pay 和 Google Pay 也可以使用。这是一个预付钱包,最低充值金额为 $10,余额不会过期,因此一个月不编程也不会产生费用。开始使用,请创建账户并生成你的密钥。
订阅 Claude Code 还是使用 API 密钥更便宜?
这取决于你运行多少个代理步骤,而不是你工作多少天。一个步骤大约包含 25,000 个输入 tokens 和 1,200 个输出 tokens,按 Kunavo 费率,在 Claude Sonnet 5 上的费用为 $0.043。因此,$20 的 Pro 订阅每月大约相当于 460 个步骤,即约 23 个二十步骤任务。在此以下,按量付费更便宜,停用一个月无需花费;超过此用量后,月费更划算,直到达到方案的使用限制。
Claude Pro 订阅包含 API 访问权限吗?
不包含。claude.ai 订阅和 Claude API 密钥是分开的产品,分别计费,二者不会叠加。当 ANTHROPIC_AUTH_TOKEN 这类凭据变量被设置后,Claude Code 会使用该密钥而不是你的登录信息:套餐限制不再生效,使用费用由密钥所有者承担。移除该变量后,Claude Code 会恢复使用订阅。
是否有免费运行 Claude Code 的方式?
CLI、编辑器扩展和全部配置都是免费的。模型调用并不免费,也不存在允许 Claude Code 零成本调用模型的免费层——Anthropic 的安装文档明确表示,Claude.ai 免费套餐不包含 Claude Code 访问权限。最低承诺的方式是使用按量付费的密钥,因为它没有月费。
如何降低 Claude Code 的成本?
按效果排序的四项做法:启用提示缓存(缓存输入按输入费率的 10% 计费;Claude Code 每一步都会重新读取整段对话);在无关任务之间清除上下文,不要一直延续一个长会话;根据问题规模选择模型,不要默认使用最大的模型;使用网关时保留 ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-haiku-4-5:Kunavo 必须设置这一项,否则 haiku 别名会请求 Kunavo 不提供的 ID,/model haiku 和设为 model: haiku 的子代理都会返回 404;它还会将 Claude Code 的内部调用从主模型转移出去。将 ANTHROPIC_BASE_URL 指向更便宜的端点,可与这四项叠加起效。
那在 VS Code 中呢?
Kilo Code、Cline 和 Roo Code 使用相同的密钥和费率,只需配置三个字段——详见Kilo Code 使用 Claude API 指南。如需使用 OpenAI 的终端工具,请参阅 使用 API 密钥的 Codex CLI。