Claude Code 定价与免费额度完全解释：订阅、API 与用量怎么选

更新日期：2026-09-27

"Claude Code 免费吗？""订阅和 API 哪个划算？"——这是安装之外被问得最多的问题。Claude Code 本身是免费的命令行工具，费用来自背后的模型调用，而模型调用有订阅与 API 两种计费路径，结构不同、适合的人也不同。

本篇把计费结构讲清楚：两种模式各自的额度逻辑、什么行为最消耗额度、怎么查询用量，以及个人开发者与团队的选择建议。具体价格数字随官方调整频繁，本文以结构性解释为主，准确数字以官方定价页为准（文末有链接）。

一、先分清三层：工具、模型、计费

理解定价的关键是把三层拆开：

1. Claude Code 工具本身：开源形态的 CLI，安装不收费，更新不收费——它只是个"遥控器"。
2. 模型调用：真正的成本所在。Claude Code 发出的每一次请求都在消耗 Anthropic 模型的 token。
3. 计费路径：同一个工具、同样的模型，可以通过订阅套餐（Pro/Max）或 API Key（按 token 计费）两种方式付费，二选一或并存。

所以"Claude Code 免费吗"的准确回答是：工具免费，用起来不免费；有没有免费额度取决于你走哪条计费路径。

二、订阅模式：包月额度制

结构：Claude Pro（入门档）与 Max（高档）是月付订阅，订阅内包含一定额度的模型用量，Claude Code 的调用与网页版 Claude 共享同一份订阅额度。额度不以 token 精确展示，而是按小时滚动窗口的用量限制——重度连续使用触顶后进入等待恢复，额度随时间滚动返还。

适合谁：个人开发者的日常编码。按典型用法，Pro 档能覆盖每天数小时的编码辅助；连续整天的重度 Agent 任务（大规模重构、批量迁移）则容易触顶，Max 档为此设计。

怎么省着用：订阅额度对"请求频率"敏感而非纯粹的 token 总量。实践中省额度的要点是控制会话节奏——用 /clear 及时清理上下文、避免无意义的超长对话、把批量任务拆成多天分批跑，而不是在额度窗口内一次性打满。会话内 /status 可查看当前账号与用量状态。

三、API 模式：按 token 精确计费

结构：在 Anthropic Console 创建 API Key，按实际消耗的 token 付费，输入与输出 token 单价不同，不同模型档位单价不同。没有月费，用多少付多少，额度上限即你在 Console 设置的消费限额。

适合谁：CI/CD 自动化（非交互 -p 模式）、团队按项目分摊成本、用量波动大或需要精确归因的场景。API 模式下不存在"触顶等待"，只存在"预算上限"。

怎么查用量：Console 的 Usage 面板可按时间段查看消耗；CI 中建议为每个用途创建独立 Key 并单独设限，费用归因一目了然。会话级的 token 消耗可在 /status 与对话成本提示中观察。

四、什么行为最消耗额度

同样是"用了一次 Claude Code"，消耗可以差出两个数量级。大头按序排列：

1. 超长上下文的反复往返：会话里累积的文件内容每次请求都会作为输入重复计费（订阅模式则表现为额度快速消耗）。/clear 和 /compact 是最有效的省钱命令。
2. 大规模 Agent 任务：让它自主跑几十个步骤的重构或排查，每步都是"读上下文 + 思考 + 输出"的完整调用。任务拆小、每步验证，总消耗反而更低。
3. 无反馈回路的失败重试：指令不清导致反复返工，每次返工都是完整调用。花在探索与计划阶段（便宜）的时间，能省下执行阶段（贵）的返工。
4. 让它输出大段已知内容：让它打印长文档、逐行复述代码，输出 token 是最贵的一类。要结论不要全文。

反过来看，省额度的实践与我们的 Claude Code 最佳实践一文完全重合：上下文卫生、小步任务、清晰指令——好习惯就是省钱习惯。

五、订阅还是 API：一个决策框架

个人日常编码 → 订阅 Pro 起步，触顶频繁再升 Max。订阅的本质是"为平均用量付费"，日常节奏下比 API 便宜得多。

CI/自动化/机器人 → API。非交互模式跑在流水线里，需要的是可预算、可归因、不触顶等待，按 token 计费完美匹配。

团队协作 → 订阅（成员个人）+ API（共享自动化）混合最常见：人手一份订阅用于交互编码，CI 与内部工具走统一 API 并按项目分 Key。

想先试试再决定 → 两边都有低门槛入口：API 侧新账号通常附带少量试用额度；订阅可随时取消。用一两个真实任务各跑一遍，看消耗再定档。

六、和竞品的计费对比视角

同类工具的计费结构值得对照理解：Cursor 是编辑器订阅，额度内含多模型调用，Agent 重度使用需更高档位；Codex 打包在 ChatGPT 订阅里，逻辑与 Claude 订阅类似；GitHub Copilot 以更低月费提供补全为主的能力。跨工具对比时注意口径差异——有的按"对话次数"限额，有的按"提示词请求"限额，有的按 token——同为"每月 20 美元档"，实际能干多少活差异很大。结构性对比可参考我们的 Claude Code vs Codex 与 Claude Code vs Cursor 两篇对比页。

对个人开发者，一个务实的结论：如果你已经为某个模型生态付了订阅（Claude 或 ChatGPT），优先用该生态的官方编码工具，边际成本最低；跨生态切换工具不会让模型变得更强。

七、成本核算：一个典型任务的消耗结构

用一个常见的"中等规模重构"任务做定性拆解，帮助建立消耗直觉。假设任务是把一个 3,000 行的模块从旧 API 迁移到新 API：

输入侧（大头）：探索阶段读取相关文件约几万 token；每轮修改请求都会携带会话上下文（已读文件 + 历史对话），20 轮交互的上下文重复携带是输入消耗的主体。这就是为什么上下文卫生直接等于省钱——/clear 与 /compact 砍掉的是重复计费的最大项。

输出侧：代码 diff 与说明文字的输出 token，单价高于输入。让它"输出完整文件"与"只输出 diff"在成本上差异显著；一次性长篇解释同样是浪费。

隐形成本：失败与返工。方向错误的执行轮次消耗的是"输入+输出+再次输入"的三重费用。把预算花在前期的探索与计划（便宜且杠杆高），是所有成本优化里回报最好的一条。

八、prompt 缓存与结构性省钱

API 模式下有一类容易被忽略的结构性优化：提示缓存（prompt caching）。同一会话里反复携带的前缀（系统提示、已读文件）可以被缓存复用，缓存命中的输入按大幅折扣计价。这带来的实践结论是：保持会话连续反而可能比频繁开新会话便宜——稳定的前缀走缓存价，断裂的会话每次都要全价重建上下文。在"及时 /clear 防污染"与"前缀复用走缓存价"之间取得平衡的姿势是：相关任务共用一个会话（吃到缓存红利），任务切换时果断 /clear（止损上下文污染）。

九、团队采购：集中还是分散

团队接入通常在两种模式间选择。分散订阅：每人一份个人订阅，采购简单、额度天然隔离，缺点是费用归因粗、离职即浪费；集中 API：团队共用一个 Console 组织，按项目分 Key、按人设限额，费用透明可归因，缺点是需要人管额度与安全。实践中最常见的形态是混合：交互式编码发个人订阅，自动化与内部工具走集中 API。此外注意组织账号的管理能力（SSO、审计、共享对话库）通常绑定在 API/团队套餐侧，选型时把它当作决策变量而不只是"价格差"。

十、竞品定价结构速览

注意各家"限额"口径不同：有的限对话轮数、有的限请求数、有的按 token 折算——同为月费 20 美元档，实际可完成的工作量差异可能数倍。对比时用同一个真实任务实测，比换算参数可靠得多。

十一、决策树：一分钟定路径

1. 只是偶尔用用、想先体验 → 注册 API 拿试用额度，或找有订阅的同事跑一遍；
2. 个人日常编码 → 订阅入门档起步，一个月后评估触顶频率；
3. 每天高强度使用、经常跑大任务 → 直接高档订阅，或"高档订阅 + API 兜底"；
4. CI/机器人/批量任务 → API，按用途分 Key 并设硬上限；
5. 团队 → 个人订阅 + 集中 API 的混合模式，管理需求（SSO/审计）视规模加上。

十二、模型档位与任务匹配：API 模式的最大杠杆

API 按 token 计费的世界里，"用什么档位的模型干什么样的活"是比省着聊天大得多的成本杠杆。模型线的档位逻辑大体是：旗舰档（推理最深、最贵）适合架构决策、疑难排障、复杂重构的规划阶段；中档（均衡）适合日常功能开发与代码审查；快档（便宜、快）适合批量机械任务——格式转换、简单补全、批量重命名、日志归类。把活分层的价值在于：绝大多数调用量其实是快档就能干好的机械活，全用旗舰档跑等于给所有请求付"专家出诊费"。会话内切换模型、不同任务用不同配置，是 API 用户的日常操作。

另一个结构性省钱机制值得知道：上下文缓存在 API 侧有对应的定价类别，重复携带的相同前缀按折扣计价。对固定工作流（比如每次都带同一份大文档或代码库摘要），稳定的上下文结构不只是工程好习惯，直接反映在账单上。

十三、用量异常排查：账单突然涨了看什么

API 用量某天突增，按命中率排查：循环调用——某段自动化代码在失败后无限重试，每次都全价调用，这是账单事故的第一大来源，务必给所有自动化加最大重试次数与总预算上限；大文件反复入上下文——某个会话反复读取超大文件（几十万 token 的日志或数据文件），检查会话里是否在粘巨物；并行任务失控——同时跑了多个 Agent 各自消耗，时间线重叠叠加；模型用错档——本该快档跑的批量任务配置成了旗舰档。Console 的用量面板支持按时间段观察曲线，异常日的形状（均匀走高 vs 尖峰）能直接指向原因类型。

订阅模式没有账单但有对应症状：额度异常快地触顶，通常是超长会话未清理、或被某个失控的自动化占用了订阅额度（是的，订阅 Key 也能接自动化，别这么用）。

十四、免费与开源替代的现实评估

存在完全免费的路线吗？技术上存在，值得诚实地评估边界：本地部署开源模型配合开源终端 Agent，确实可以做到零 API 成本。现实差距有三：能力差距——旗舰闭源模型在复杂 Agent 任务上的成功率仍然领先，开源模型在"多步骤自主执行"场景的可用性明显更弱；硬件成本——能流畅跑可用模型的本地硬件本身是一笔投入，摊销逻辑取决于你的用量强度；运维成本——模型部署、更新、显存调优都是持续的隐性时间成本。务实的结论：把本地开源方案当作"离线可用、隐私敏感、机械批量"场景的补充，而不是 Claude Code 体验的平价替代。想清楚自己要的是"能力"还是"免费"，选型就不会拧巴。

十五、成本治理清单

最后给出一份可直接执行的十条清单：1. 会话按任务隔离，切换即 /clear；2. 长会话主动 /compact，别等变卡；3. 探索与计划用便宜方式，执行才上火力；4. 指令里给验收标准，消灭返工轮次；5. 要 diff 不要全文，要结论不要复述；6. 批量机械任务用快档模型；7. 自动化必须带最大重试与预算上限；8. CI 的 Key 按用途分离并各自设硬上限；9. 每月看一次用量面板，给"正常形态"建立基线；10. 团队把这份清单写进 onboarding 文档，成本习惯和代码规范一样需要传承。

十六、年度成本怎么估：一个预算示例

把前面的结构性知识落成一个预算方法。估算公式：年度成本 ≈ 频率 × 单次消耗 × 单价。举例：一名日常编码的开发者，工作日每天 3 个有效会话、每会话约 20 轮交互——这个画像在订阅模式下落在入门档额度内，年成本约等于订阅价 ×12；换成 API 模式，同样的画像按中档模型单价粗算，年度花费通常显著高于订阅价，这就是"日常编码选订阅"的定量依据。反过来，一个 CI 机器人每天跑 200 次小任务（每次几千 token），没有订阅额度可用，API 模式下月成本可能只有几杯咖啡钱——这就是"自动化选 API"的对称结论。预算的实操步骤：先记录一周的真实会话数与轮次（/status 有用量线索），套入上述画像选择路径，一个月后用实际数据校准。估算的意义不在精确，而在选对计费路径——路径错了，怎么省都别扭。

十七、订阅与 API 共存的具体玩法

两种计费路径可以在同一台机器、同一个工具上共存，这是很多进阶用法的基础：日常交互会话走订阅登录；需要精确归因或绕过触顶等待的场合，临时设置 ANTHROPIC_API_KEY 环境变量切换到 API（配置了环境变量且未登录订阅时自动走 API）。团队里的高级形态：个人的订阅用于交互，共享的 API Key 通过 direnv 按项目目录自动切换——进公司项目目录自动走团队 Key（费用归因到项目），回个人项目自动走订阅，边界清晰无需人工记切换。注意环境变量的作用域管理：全局导出 API Key 会让"以为在用订阅"的会话悄悄烧 API 额度，按目录注入比全局导出安全得多。

十八、高频问答补充

可以多人共享一个订阅吗？ 订阅按账号使用，共享账号违反服务条款且有封号风险；团队场景的正确解是官方团队套餐或集中 API。

发票与采购怎么走？ 订阅走应用商店或官方收单渠道（支持信用卡），API 走 Console 绑定支付方式；企业采购通常在 Console 侧配置组织与账单，具体票据能力以官方账单文档为准，采购前先确认贵司需要的发票类型是否支持。

换了电脑额度怎么办？ 订阅额度跟账号不跟设备，新机器登录即恢复；API 额度跟组织，Key 重建即可。两边都没有"设备数量"概念，无需迁移操作。

超额会被停服吗？ 订阅触顶是等待恢复而非扣费停服；API 触达自设上限会拒绝请求，同样不产生超额账单——上限机制本身就是防失控设计，务必设置。

降档或取消会丢数据吗？ 会话历史存在本地与账号侧，代码始终在你自己的仓库里；取消订阅损失的只是当期额度。真正的"数据"从来不在 Anthropic 那边，这也是这类工具的架构常识。

十九、账号与安全：别让省钱的努力毁在泄钥上

成本治理的最后一块拼图是凭据安全：API Key 泄露的账单是无限额度的账单。三条铁律：Key 只存环境变量或凭据管理器，绝不进代码仓库与 Docker 镜像（提交前扫一遍 diff 是最低标配）；发现泄露立即在 Console 作废重发——作废是分钟级生效的止损动作，比追查泄露路径更优先；CI 里用平台的 Secret 机制（GitHub Actions 的 secrets、GitLab CI 的 variables），不用明文变量。订阅侧的对应风险是账号安全，开双因素认证的成本是一次扫码，收益是保住整年的订阅与代码会话历史。

二十、把成本意识写进团队习惯

个人省钱靠自觉，团队省钱靠机制。三个可落地的团队实践：把"API Key 用途登记表"纳入运维文档（Key、用途、月预算、负责人四列，季度审一遍），孤儿 Key 是账单噪音的常见来源；把"这个任务该用哪个档位的模型"写进 AI 使用规范，与代码规范同等地位；月度成本复盘只看三个数——总量环比、异常日清单、Top 消耗用途，十分钟的会议足够。成本治理的目标不是越省越好，而是让每一分钱都花在产生工程产出的调用上——花得清楚，才敢用得充分，这最终是个工程效能问题而不是财务问题。

二十一、五种典型用户的完整方案

把全文收敛成五种画像的端到端方案，对号入座即可：

学生与尝鲜者：API 试用额度起步，配合免费阶段的工具探索；把第一次付费留给"我已经连续两周每天在用"的时刻，而不是第一天。选择 CLI 之外的网页版免费档体验模型能力，确认这个生态值得进入。

独立开发者：入门订阅 + 本地 /clear 纪律。订阅覆盖全部交互编码；开源自己的 Brewfile、CLAUDE.md 与 Skills 模板，个人工作流的资产化从第一天开始积累。

重度个人用户：高档订阅，自动化需求溢出的部分用 API 兜底。订阅触顶的等待时间用来做代码评审与测试补充——把额度恢复窗口变成强制的评审节拍，反而是好节奏。

创业小团队（3-10 人）：成员个人订阅 + 一个集中 Console 的 API 组织。团队规范（CLAUDE.md 模板、Skills 库、提示词模式库）进内部仓库；每月一次十分钟成本复盘。这个规模的痛点不是钱，是"大家的用法参差不齐"——规范比预算重要。

平台/基建团队：集中 API + 按项目 Key + 硬上限 + 用量看板；为内部用户封装统一的接入层（代理、审计、模型路由）；把"模型档位选择"做成内部工具的默认配置而非个人决定。这个规模下你是别人的"官方"，成本与安全的治理能力就是产品能力的一部分。

二十二、写在最后：把定价问题还原成工程问题

回头看，"哪个便宜"从来不是正确的提问方式。订阅与 API 的差异本质是两种风险分配：订阅把波动的用量风险转给厂商（厂商靠平均定价盈利），API 把确定性留给用户（精确但需要自己治理）。正确的选择取决于你的用量形态是"平均"还是"极端"，以及你愿意投入多少治理。把计费结构当工程问题拆解——三层分离、额度逻辑、消耗结构、缓存与档位——你会发现它和容量规划、缓存策略这些经典工程问题同构。这也正是本文愿意花整篇篇幅讲定价的原因：看懂一张价目表背后的结构，比记住任何一个数字都有用。

订阅档位怎么读？ 官方定价页的档位差异主要是额度倍率与高级功能的组合。读表的方法：先找"额度相对倍率"（高档对入门档的倍数），再找"是否包含优先访问/更高上下文"这类能力差异，最后用你上周的真实用量乘以倍率反推合适档位——从下往上升级容易，从上往下降档心理成本高，首次选择宁可保守。

用量高峰期怎么平滑？ 订阅额度按小时滚动，把批量任务铺到不同时段（比如跨天的分批迁移）比在单一窗口硬跑更顺畅；API 用户则相反，集中批量反而便于观察与控制。

价格还会变吗？ 几乎必然。模型定价整体呈下行趋势，档位与规则每隔数月都有调整——这正是本文反复强调"学结构不记数字"的原因：结构稳定，数字易变。把官方定价页加入书签，每次做大额预算决策前花两分钟核对当期数字即可。

二十三、常见问题

免费能用到什么程度？ 工具本身永久免费；模型侧的免费空间来自 API 试用额度（新账号，量小）与订阅套餐的取消政策。想零成本长期使用，目前没有官方路径——这也是它与开源模型本地部署方案的本质差异。

触顶了怎么办？ 订阅额度按小时滚动恢复，等待即可；急用时可在会话内临时切换到 API Key 模式（设置 ANTHROPIC_API_KEY 后重启会话），两者可共存。

API 会不会被跑到天价？ Console 设置消费硬上限即可封顶；CI 场景再叠加流水线超时与单任务预算，双重保险。

换模型会影响计费吗？ 会，不同模型档位单价不同。在需要强推理的任务用高档模型、简单任务用快档模型，是 API 模式下最直接的成本优化。

官方资料与继续阅读

• Anthropic 官方定价页（各档位当前价格）：https://www.anthropic.com/pricing
• Claude Code 官方文档（设置与计费说明）：https://docs.claude.com/en/docs/claude-code/overview
• Anthropic Console（API Key 与用量管理）：https://console.anthropic.com
• 站内相关文章：Claude Code 安装指南、Claude Code 最佳实践、Claude Code vs Codex 对比、Claude Code vs Cursor 对比