Claude Code CLI 可免费安装,但运行它并不免费。 Claude Code 执行的每个操作——读取文件、提议编辑、运行命令、检查结果——都是需要有人付费的模型调用。Anthropic 会向新的 API 账户提供少量免费额度用于测试,但除此之外没有免费层级;额度用完后,每次调用都会计费。
费用完全取决于你选择两种付费路径中的哪一种——claude.ai 订阅或按 token 计费的 API 密钥——而且它们适合截然不同的使用模式。不订阅时运行它最便宜的方式是按量付费的密钥:在 Kunavo,每个 Claude 模型的价格都比 Anthropic 列表价低 30%,充值 $10 起,无月费,设置只需几个环境变量(如下)。下面是实际计算方式。
哪些免费,哪些不免费
| 组件 | 成本 |
|---|---|
| 安装 CLI | 免费 |
| VS Code 和 JetBrains 扩展 | 免费 |
| 配置、钩子、技能、子代理、MCP 服务器 | 免费 |
| 模型调用——也就是实际使用它 | 付费 |
唯一的免费入门方式是访客通行证。符合条件的 Pro 和 Max 订阅者可以分享通行证,让此前未使用过 Claude 付费计划的人获得 7 天 Pro 试用,其中包含 Claude Code;发送者可以使用 /passes 命令查找通行证。通行证数量有限,也可能过期,因此它适合用来试用 Claude Code,不能作为持续免费使用的方式(Anthropic 关于访客通行证的文章,于 2026-10-10 查阅)。免费计划本身不包含 Claude Code。
Codex 的情况恰好相反:ChatGPT 免费计划包含有限使用量的桌面版 Codex。并列对比见Codex 是否免费。
两种付费方式
| 订阅 | API 密钥 | |
|---|---|---|
| 计费 | 固定月费(Claude Pro 或 Max) | 按 token 计费,无月费 |
| 限额 | 每个时间窗口的使用上限 | 没有——用多少付多少 |
| 低使用量月份 | 仍会收费 | 不收取任何费用 |
| 高使用量月份 | 有上限,但你会达到限额 | 随工作量增加 |
| 适用场景 | 每日、可预测的使用 | 不规律或突发式使用 |
两者不会叠加,而且当前启用哪一个很重要:设置 ANTHROPIC_AUTH_TOKEN 或 ANTHROPIC_API_KEY 之类的凭据变量时,Claude Code 会使用它,而不是已保存的 claude.ai 登录信息。你的订阅会暂停且不被使用,其限额不再生效,使用量计入该密钥。取消设置变量后,Claude Code 会恢复使用订阅。运行 /status 可查看当前实际启用的方式。
一个真实月份的费用
费用取决于代理步骤,而不是日历天数。Claude Code 会在每一步重新发送系统提示词、对话和最新文件上下文,因此一步比一条聊天消息大得多——典型值约为 25,000 个输入 token 和 1,200 个输出 token。在 claude-sonnet-5 上按 Kunavo 费率计算:
| 工作负载 | Kunavo | 按 Anthropic 列表价 |
|---|---|---|
| 一次代理式步骤 | $0.043 | $0.062 |
| 一个 20 步任务 | ~$0.87 | ~$1.24 |
| 高强度的一天(5 个任务) | ~$4.34 | ~$6.20 |
| 20 个这样的日子 | ~$87 | ~$124 |
这些是未经优化的数字——没有提示词缓存,全部使用主线模型。轻度或探索性使用每月只需个位数美元;真正昂贵的是持续的每日代理式工作,因为按 token 计费会在这里不断累积。使用费用计算器计算你自己的数字,或参阅 Claude Code 价格,了解订阅层级、完整的按模型费率表,以及两条路径之间的盈亏平衡点。上方“按 Anthropic 列表价”一栏来自 Anthropic 官方 API 价格,其中列出了每个 Claude 模型当前的按 token 列表价,并与同一模型在此处的价格并列。
运行它最便宜的方式
Claude Code 原生读取 ANTHROPIC_BASE_URL,因此它可以连接任何提供 Anthropic Messages API 的端点——无需插件、无需修改二进制文件,也无需人工维护代理。这是降低每 token 费率的受支持路径:
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相同的模型、相同的 CLI,主流模型的目录价格约低 30%。保留模型相关行:Claude Code 内置的默认模型以及 opus 和 sonnet 别名会跟随 Anthropic 的最新模型;如果 Kunavo 尚未提供其中某个模型,请求会返回 404。sonnet 别名请求 Sonnet 5.5,而 Kunavo 不提供该模型,因此 /model sonnet、opusplan 的执行阶段以及设置为 sonnet 的子代理都会返回 404,除非由 ANTHROPIC_DEFAULT_SONNET_MODEL 固定该模型。opus 固定为 Opus 5.5,需要 Claude Code v2.1.280 或更高版本——旧版本安装请运行 claude update。按用量付费,最低充值金额为 $10,无月费,余额不会过期——因此,一个月没有使用时确实不会产生任何费用。完整流程请参阅Claude Code 设置指南。如果你已经在使用某个套餐并不断触及其窗口限制,达到 Claude 限额后会发生什么会计算保留套餐并为套餐停止服务的时段添加密钥时的盈亏平衡点。
真正会改变费用的四个杠杆
- 保留 Haiku 这一行。如果没有
ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-haiku-4-5,Claude Code 的haiku别名会请求 Kunavo 未提供的模型 ID(v2.1.293 起为 Haiku 5.5),因此/model haiku和指定为haiku的子代理都会返回 404。设置后,Claude Code 自行生成摘要和标题时的调用会使用最便宜的模型(每百万 token $0.70 / $3.50),而不是主模型;Anthropic Claude API 价格表列出了此处切换所涉及的各模型费率,并将官方价格与折扣价并排展示。 - 从新任务开始。 每一步都会重新发送上下文,因此一个长期运行的会话成本会按平方级增长。新任务会重新使用较小的上下文。
- 让提示词缓存发挥作用。缓存输入按输入费率的 10% 计费。在每一步都重新发送稳定前缀的循环中,这是可用的最大单项节省(工作原理)。
- 为密钥设置上限。 在控制台中为编辑器使用独立密钥并设置消费上限。失控循环会变成有上限的费用,而不是意外账单。
人们对此最常见的误解
“Claude Code 是开源的,所以免费”
客户端可以免费安装,并不意味着模型调用免费。CLI 是便宜的部分;推理才是成本所在。
“我的 Claude Pro 订阅涵盖 API”
并不涵盖。订阅和 API 密钥是独立产品,拥有独立计费——claude.ai 负责前者,console.anthropic.com 负责后者。Pro 仅通过订阅路径为 Claude Code 提供资金,不适用于密钥。
“如果使用小模型,应该有免费层级”
更便宜,但不是免费。claude-haiku-4-5 的价格为每 1M 个 token $0.70 / $3.50,只是 Sonnet 的一小部分,但仍然会计费。
“使用网关就可以不用向 Anthropic 付费”
你仍在为推理付费——只是费率不同,收款方不同。改变的是价格和计费模式,而不是是否需要付费。
常见问题
Claude Code 是免费的吗?
Claude Code CLI 可免费安装,但运行它并不免费——它执行的每个操作都是需要付费的模型调用。你有两种付费方式:claude.ai 订阅(Pro 或 Max),其中包含该计划限额内的 Claude Code 使用量;或者使用按 token 计费且无月费的 API 密钥。不存在允许 Claude Code 免费调用模型的免费层级。
不订阅也可以使用 Claude Code 吗?
可以——改用 API 密钥即可。Claude Code 接受按 token 计费的密钥,适合不规律使用,因为不写代码的月份无需支付任何费用。设置密钥后,任何 claude.ai 订阅都会暂时停用:凭据变量存在期间,订阅计划的限额不再生效,使用量改为计入该密钥。
Claude Code 每月实际要花多少钱?
这取决于你运行多少个代理步骤,而不是使用多少天。一个典型步骤约有 25,000 个输入 token 和 1,200 个输出 token;在 Kunavo 费率下,Claude Sonnet 5 上的 20 步任务约为 $0.87,而按 Anthropic 官方列价约为 $1.24。轻度使用每月为个位数美元;重度每日使用——每天五个此类任务,持续 20 天——约为 $87。
Claude Code 有免费试用吗?
仅限受邀用户。符合条件的 Pro 和 Max 订阅者可以发送访客通行证;持有人可获得 7 天 Pro 试用,其中包含 Claude Code,适用于此前未使用过 Claude 付费计划的人。没有邀请就无法免费运行:CLI 可以免费安装,但首次实际提示词调用需要付费计划或已充值的 API 密钥。小额按量充值无需月费,是试用时投入最少的方式。
运行 Claude Code 最便宜的方式是什么?
将它指向更便宜的端点。Claude Code 原生支持读取 ANTHROPIC_BASE_URL,因此网关无需额外软件;在 Kunavo 上,同样的 Claude 模型价格约比 Anthropic 的标价低 30%。在此配置中保留 ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-haiku-4-5:如果不设置,Claude Code 的 haiku 别名会请求 Kunavo 未提供的模型 ID,导致 /model haiku 和指定 haiku 的子代理返回 404。同一行还会将 Claude Code 自动发起的后台调用从主模型转交给最便宜的模型。
我可以在不承诺订阅的情况下试用 Claude Code 吗?
可以——按量付费的密钥是承诺最低的选项,因为少量充值没有月费,也不会过期。你还可以先安装 CLI,探索其配置、技能和命令,再进行充值;只有第一次真正的提示词需要凭据。
对我来说,订阅还是 API 更便宜?
大致规则:如果你大多数日子都会达到订阅限额,固定费用更划算。如果你是间歇式编程——有些周使用量很大,有些周完全不用——按 token 付费更划算,因为闲置周无需支付费用。使用 费用计算器估算你自己的盈亏平衡点。
使用网关会导致功能失效吗?
编码、工具、子代理、MCP 和提示词缓存都能正常工作。但 Remote Control 和语音听写不行——两者都需要 claude.ai 身份,设置网关凭据后不可用。完整列表见 设置指南。
如何设置密钥?
请参阅 获取 Claude Code API 密钥——其中说明在哪里创建密钥、应将其放入哪个变量,以及变量错误时为何会静默失败。如果你尚未安装 CLI,安装 Claude Code中提供了各操作系统对应的命令。