Claude Code费用详情

成本与用量

把 Claude Code 的费用拆成订阅费和用量费两条线,讲清每笔钱归属哪一边,以及怎么对账、怎么把月支出压下来。

很多人用 Claude Code 用着用着就懵了:明明买了订阅,账单上还冒出一笔 API 调用;明明只是写代码,额度却掉得比预想快。问题多半不在模型贵不贵,而在你没分清「订阅覆盖什么、超出的部分走哪条计价口径」。这篇不讲缓存原理,只讲费用构成和你能动手做的事。

很多人用 Claude Code 用着用着就懵了:明明买了订阅,账单上还冒出一笔 API 调用;明明只是写代码,额度却掉得比预想快。问题多半不在模型贵不贵,而在你没分清「订阅覆盖什么、超出的部分走哪条计价口径」。这篇不讲缓存原理,只讲费用构成和你能动手做的事。

把 Claude Code 的钱拆开看,无非两条线:一条是你按周期付的订阅费,换一段时间内的使用额度;另一条是按量计费,走官方 API 或中转接口,用多少算多少。大部分人超支,是因为两条线的边界没划清。下面逐节讲怎么认、怎么选、怎么对账、怎么压下来。

先分清:Claude Code 的钱其实分两条线收

订阅式是按周期付固定费用,换来一段时间内的使用额度,额度内不再按次扣钱;按量式是按输入 token、输出 token 分档计价,用多少算多少,没有上限也没有保底。这两条线不是二选一的关系,同一个人同一天完全可能两边都产生费用。

订阅式
周期性固定支出,买的是「一段时间内能用到某个量」,额度内不额外扣
按量式
没有固定支出,每轮调用都产生 token 消耗,随用随扣
混合场景
订阅额度跑满后切到 API key 继续跑,两边同时出账
中转层
你在客户端和官方之间自建或使用的中转接口,会改变实际计费口径

判断自己属于哪条线,最简单的办法是看你登录的是什么:用订阅账号登录,主账走订阅;用 API key 或自建中转登录,主账走按量。如果你两个都配了,那就得按混合场景来管,别指望只盯一边就能看懂账单。

  • 先确认客户端里当前生效的是订阅登录态还是 API key,环境变量和配置文件都查一遍
  • 再确认有没有自建中转层,中转会替换真实计价口径,账单上的数字不一定对得上官方单价
  • 最后确认你的工作实际跑在哪一侧,很多人以为在吃订阅额度,其实早就切到 API 了

订阅档位怎么选:别只看总额度,看你能用多久

订阅各档位的差异,主要集中在额度上限和可用的模型范围、并发能力上,而不是功能开关的差别。也就是说低档位通常不是「功能被砍」,而是「跑不了几轮就到顶」。所以选档位时,总额度只能当参考,真正要看的是你的高峰日能不能撑过去。

你的使用形态容易卡住的点选档位时先看什么
每天都用、强度平稳总额度够不够覆盖整月日均额度与实际日均消耗的比值
一周集中写几天高峰日一次性吃满单日峰值能不能被一档覆盖
临时项目、用完就停按月付不划算是否更适合走按量这条线
团队多人共用额度被谁用光说不清能否按人分账号或分 key
  1. 算出你的日均消耗把上周实际用掉的量摊到有工作的那几天,而不是摊到七天,否则会低估高峰。
  2. 找出你的峰值日看单日最高消耗是多少,这是决定你会不会被卡住的关键数字,不是平均值。
  3. 拿峰值去比档位如果某一档的日均可比额度接不住你的峰值日,那这档对你来说就是假够用。
  4. 留一次复盘点用满一个周期后回站内核对实际分布,再决定是升档还是改用法。

具体每档的当前额度、地区差异和可用模型范围,到 /coding-plans 和 /plans/claude-pro 看当时的数字,别拿别人截图里的数字当准。用量波动大的人,比如一周里只有两三天高强度写代码,比每天平稳用的人更容易被低档位卡住,这种情况反而更应该先评估走按量这条线。

按量这条线:钱是按什么口径扣的

按量的基本计价单位是 token,输入和输出通常是两个价,长上下文和缓存命中又是另一套口径。对写代码这件事来说,真正贵的是反复读入的项目上下文和文件内容,不是你敲的那几句指令。你打一行字可能只值很少的量,但为了让模型看懂,客户端要带上一大堆文件。

  • 输入侧:项目文件、历史对话、系统提示,每一轮都可能重复带上,越长的会话越贵
  • 输出侧:模型生成的代码和解释,通常单价更高,写长注释和长文档会明显加钱
  • 缓存侧:命中缓存的部分与未命中的部分口径不同,缓存失效时费用会跳一下
  • 模型档位:同一条链路里不同步骤用不同模型,单价不是单一数值,别用一个模型的价格去套整条链路

还有一个容易被忽略的点:你的客户端是按整轮对话计费还是按单次请求计费,结果差别很大。同样一个任务,拆成多次小请求和合成一次大请求,token 走法完全不一样。具体单价随模型档位和提供商变化,到 /official-api/providers/anthropic 核对当期数字,再回来套你的用量。

一轮任务的钱花在哪:四个常见出血点

知道钱花在哪,比知道单价是多少更有用。下面四个是编码场景里最常见的出血点,按出现频率排,不按金额排。你可以对着自己的使用习惯一条条勾,勾中的就是优先改的地方。

出血点表现先做的动作
上下文反复重读项目越大、越爱整目录贴文件,输入侧越高只带相关文件,不带整个仓库
无效重试报错后连着重跑,每次都是完整计费给重试加次数上限和退避
重活上大模型格式化、补全类工作也用最高档位按任务复杂度分流模型
长会话不清理历史越滚越长,每轮带的东西越多完成一个子任务就开新会话

这四个里,前两个改起来最快,也不用重新买任何东西。第三个需要你先摸清哪些工作真的需要复杂推理,哪些只是机械改写。第四个最容易被忽略,但效果往往最直接,因为长会话的每轮输入都在为历史买单。

对账:怎么确认自己没被多扣

对账不是不信任谁,而是两条线并行时本来就需要对齐。建议准备三份记录:订阅扣费记录、API 用量明细、你自己的任务日志。前两份找得到,第三份得自己留,哪怕只是每天记一句「今天主要干了什么、跑了多久」都比没有强。

  1. 按天对齐三份记录同一天里订阅侧扣了什么、API 侧用了多少、你实际干了什么,三列并排放。
  2. 重点看切换日订阅额度已满但仍然有 API 调用生成的日子,是最容易算错也最容易超支的日子。
  3. 核对起算周期确认额度周期和账单周期是不是同一天起算,错开会造成「看起来多扣了」的假象。
  4. 检查 key 配置确认换过 key 之后配置文件也同步换了,否则用量会记到你没在看的那个账号上。

对不上的常见原因其实就三个:周期起算点不同、key 换了配置没换、中转层改了计价口径。具体路径上,先到 /usage 看真实用量分布,再用 /tools/token-price-calculator 把 token 数还原成金额,两边的量级应该能对上。

把月支出压下来的四步顺序

省钱这件事有顺序,顺序反了会白花。核心逻辑是:先改用法,再改工具,最后才改套餐。因为你用法没改就换套餐,等于把浪费搬了个地方。下面四步按优先级排,做完一步看一周再进下一步。

  • 第一步降模型档位:把不涉及复杂推理的活分流到更便宜的模型,先试一周看返工率有没有上升
  • 第二步砍上下文:只贴相关文件,不做整目录灌入,这一步通常收益最稳
  • 第三步控制重试:给自动化脚本加失败次数上限和退避策略,别让它自己烧一晚上
  • 第四步才是换套餐:前三步做完再回来看订阅档位够不够,这时候的判断才准

注意第一步有个前提:如果返工率明显上升,说明你分流错了任务,不是所有活都能降档。第二第三步没有这个顾虑,基本可以无条件做。至于要不要走更便宜的中转接口,那是另一类决策,牵扯到稳定性、数据路径和合规,不能只按价钱拍板,具体可以到 /sites 看各家的当前状态再决定。

预算怎么设:给出事留一道闸

预算管理的关键不是算得准,而是出事之前能被拦住。订阅侧和 API 侧的闸门位置不一样:订阅侧你没有硬上限,只能靠安排任务时间;API 侧可以设硬上限或告警,这是真正能兜底的一层。

  • 订阅侧:记清额度重置时间,把重活安排在周期初,别攒到周期末卡死
  • API 侧:设月度硬上限或告警阈值,别只靠事后翻账单
  • 团队场景:按人分 key 或按项目分 key,否则超支之后根本查不出是谁
  • 判断标准:如果某个 key 的月消耗超过你一个订阅档位的价格,它就值得单独评估走哪条线
  • 复盘节奏:每月固定看一次用量分布,别等到账单出来才想起来
预算不是算得多准,而是超支之前有没有人能喊停。

给团队用的话,分 key 这件事越早做越省事。一个人的用量失控,和十个人的用量混在一个 key 里,排查成本差得非常远。带上限、带告警、按人分,这三条做到了,超支最多是浪费一次,不会变成连续几个月。想顺手比一下不同渠道当前的状态,可以去 /rankings 和 /price-watch 看当时的记录。

这些做法什么情况下不适用

上面讲的默认前提是:你能用公开订阅和公共接口,且代码允许经过外部服务。这个前提一旦不成立,省钱的逻辑就得整个换掉,硬套只会得出错误的结论。

  • 合规要求必须走私有部署或专属实例的团队,公开订阅和公共 API 的那套省法基本用不上
  • 有严格代码不出内网要求的场景,切第三方中转这条省钱路直接排除,不用评估
  • 一次性短期项目,做精细分档和预算体系反而得不偿失,按月看总量就够了
  • 单人临时试用,还没形成稳定用量规律之前,谈档位优化为时过早

简单说,先确认你的约束条件,再看这些方法哪几条能用。约束越硬,能动的空间越小,这时候更该关注的是「用得起」而不是「用得多便宜」。如果你不确定自己属于哪一类,可以先到 /guides 看对应场景的说明,再回来对照本文的清单。

下一步:把当期数字换成你自己的数字本文只讲了构成和顺序,具体单价、各档额度和渠道状态是会变的,到 /coding-plans 看订阅档位、到 /official-api/providers/anthropic 看按量口径,两边对齐之后再按本文的四步顺序动手,第一步就能看到差别。

常见问题

我买了 Claude Code 订阅,为什么账单上还有 API 费用?

最常见的两种情况:一是订阅额度用完后客户端自动切到了你配置的 API key 继续跑;二是你在别的工具里用了同一个 key。先确认当前会话走的是哪条通道,再去看 /coding-plans 对应档位的额度口径,两者不是一回事。

订阅和直接买 API,哪个更划算?

看用量形态。每天稳定写几小时代码、任务类型杂的人,订阅通常更省心;用量忽高忽低、或只是偶尔跑一跑的人,按量更划算。可以用最近两周的真实 token 消耗去 /tools/model-cost-calculator 折算一遍再对比。

额度掉得比预期快,应该先查什么?

按这个顺序查:先看是不是有大目录或长文档被反复读入;再看有没有失败重试的循环;最后看模型档位是不是比你以为的高。这三点占掉大部分异常消耗,具体口径去 /official-api/providers/anthropic 对照。

团队一起用,费用怎么分摊才不乱?

不要共用一把 key。按人或按项目分 key,每个 key 单独设上限;月底用 /usage 的用量分布去对,谁超了一眼能看出来。共用 key 的团队最后基本都会在算账上耗掉大量时间。

要不要为了省钱换成更便宜的第三方接口?

可以先小范围试,但要同时看三件事:计费倍率口径是否和官方一致、限速会不会拖慢你的流程、出问题时能不能查到调用记录。只比单价容易踩坑,参考 /sites 里的中转站目录先看可信度再动手。

本文依据各平台公开文档与官方公告整理,只做中文归纳;具体做法、参数与限制以官方文档为准。