NexoToken 技术指南中心
Claude Code 缓存计费与成本核对
把未缓存输入、缓存读取、缓存写入和输出分开,再核对模型、公开分组、价格时间与账单。
缓存命中不等于免费,缓存写入也不等于缓存读取。核对 Claude Code 成本时,应先固定请求时间、完整模型 ID 与公开分组,再把普通输入、读取、5 分钟写入、1 小时写入和输出分开计算。不要把 Anthropic 的官方单价或倍率直接当作 NexoToken 的结算价格,也不要把模型名称当成模型身份的独立证明。
适用于通过 Messages 兼容 API 使用 Claude Code、检查缓存是否命中并核对一次任务成本的用户;不适用于把聊天订阅额度换算成 API 余额。
最后核验
操作步骤
先区分来源:Anthropic 官方 Messages usage 中 input_tokens 是未缓存输入,cache_read_input_tokens 是读取,cache_creation_input_tokens 是写入总量。三者相加才是总输入。平台归一化记录可能已经包含缓存,不可机械照搬加法。
若 usage.cache_creation 提供 ephemeral_5m_input_tokens 与 ephemeral_1h_input_tokens,应分开按各自单价计算;二者已属于 cache_creation_input_tokens,不能重复加上总写入量。缺失不等于零,不能自行把未知 TTL 当作 5 分钟。
公式:费用 =(未缓存输入×输入价 + 读取×读取价 + 5分钟写入×5分钟写入价 + 1小时写入×1小时写入价 + 输出×输出价)÷1,000,000。各项必须同币种、同一价格档位。
2026-11-20 核验的 Anthropic 官方文档中,5分钟/1小时写入基础倍率分别为1.25/2;多数模型的官方读取倍率为0.1倍,但 Claude Sonnet 5.5 和 Opus 5.5 为0.05倍,Fable 5.1/5.2 为0.025倍。下面的方案 3 平台报价里,Sonnet 5.5 的读缓存价约为该组输入价的0.1倍,不能拿官方直连倍率套算。
NexoToken 公开价格页是带时间的快照,同模型只展示最低输入价的一档,不保证就是你的 Key 所属分组;缓存读取价缺失不代表免费,未列出的写入价也不能从读取价推断。
平台实价样本(不是客户账单):公开快照生成于2026-11-20 14:18:03北京时间,claude-sonnet-5-5,公开分组「Anthropic 方案 3」。按原始 USD/token × 1,000,000 换成美元/百万 Token,四舍五入为:输入0.074184、输出0.370920、缓存读取0.007418、cache_write_usd_per_token 对应写入0.092730。该字段没有区分TTL,不能拿它证明1小时写入价;快照按当时 USD/CNY 汇率折算为美元,充值口径另为1元人民币=100积分。美元报价不是实际扣款,结算以当时分组和账单为准。
最后按实际请求逐条对账,再汇总任务。核查重试、并行子任务、上下文变化和长上下文档位;发现差异时带脱敏记录联系支持,不要通过反复付费调用猜原因。
安全示例
纯假设教学示例,不是真实客户账单,也不是任何模型报价。
假设五项单价(美元/百万 Token):输入2,5分钟写入2.5,1小时写入4,读取0.2,输出10。
互不重复的用量:输入2,000;5分钟写入10,000;1小时写入4,000;读取20,000;输出500。
费用 = (2000×2 + 10000×2.5 + 4000×4 + 20000×0.2 + 500×10) / 1000000
= 0.054 美元。
Messages 写入总量为14,000,总输入为36,000;不能再把14,000计费一次。
此处不做人民币/平台额度换算,不包含其他工具费或价格档位调整。常见错误与排查顺序
- 读取与写入混为一类会丢失 TTL 差异,低估或高估成本。
- 把总输入与其中的缓存量重复累加,会重复计费。
- 固定宣称所有 Claude 模型缓存都是1折,忽略了模型与分组差异。
- 只看一次界面操作,忽略重试、工具循环与子任务导致的多次请求。
- 缓存未命中先核对前缀、模型、TTL 和实际 usage;客户端开关本身不是命中证据。
完成检查清单
- 模型、公开分组、请求时间与单价时间一致。
- 五类 Token 互不重复,缺失字段已明确标为未知。
- 单价单位和币种统一,未把平台额度当作法币。
- 示例与真实账单明确区分,无客户数据和凭证。
- 任务级费用已经纳入所有实际请求及额外工具费。
限制与边界
- 本页核验日期为2026-11-20,价格、模型和客户端行为会变化;当前记录与实时价格优先。示例仅用于演示计算,不承诺节省比例或命中率。
- 平台状态页统计最近24小时真实请求的被动聚合,不是第三方持续主动探测;可用性与延迟不证明模型身份、输出质量或账单正确。外部监测也必须按其模型、时间窗口与方法单独核验。
- 只有字段完整、语义一致时才能精确复算;缺少TTL拆分或当时价格时,应说明无法精确核对,不补造数值。