Claude Code 计费模块源码分析
输入“/”快速插入内容
Claude Code 计费模块源码分析
Claude Code 计费模块源码分析
用户9785用户97853月31日修改
概述
🔬
本文档基于 2026-03-31 泄露的 Claude Code CLI 源码，深度分析其计费模块的实现逻辑。计费系统由三个层次组成：本地费用计算、会话费用追踪、服务端配额限流。
整体架构
📐
计费系统的数据流：API 响应 → 本地价格计算 → 会话费用累计 → 配额限流监控 → 展示与预算中断
核心文件
文件 | 职责 |
modelCost.ts | 模型价目表 + USD 费用计算 |
cost-tracker.ts | 会话级费用累计与持久化 |
claudeAiLimits.ts | 服务端配额限流解析 |
costHook.ts | 退出时展示费用摘要 |
billing.ts | 判断用户是否有查看费用权限 |
claude.ts | API 调用中触发费用计算 |
数据流方向
代码块
API 响应 (Usage 字段)
↓
calculateUSDCost()
↓
addToTotalSessionCost()
├→ 按模型累加
├→ OTel 指标上报
└→ maxBudgetUsd 检查
第一层：本地价格计算
💰
文件：src/utils/modelCost.ts — 所有费用计算的核心
价目表数据结构
每个模型定义 5 项收费维度：
代码块
type ModelCosts = {
inputTokens: number // 输入 Token 单价 ($/百万Token)
outputTokens: number // 输出 Token 单价 ($/百万Token)
promptCacheWriteTokens: number // 缓存写入单价 ($/百万Token)
promptCacheReadTokens: number // 缓存读取单价 ($/百万Token)
webSearchRequests: number // 网页搜索单价 ($/次)
}
各模型定价
模型 | 输入 $/M | 输出 $/M | 缓存写 $/M | 缓存读 $/M | 搜索 $/次 |
Haiku 3.5 | $0.80 | $4 | $1 | $0.08 | $0.01 |
Haiku 4.5 | $1 | $5 | $1.25 | $0.10 | $0.01 |
Sonnet 3.5v2/3.7/4/4.5/4.6 | $3 | $15 | $3.75 | $0.30 | $0.01 |
Opus 4/4.1 | $15 | $75 | $18.75 | $1.50 | $0.01 |
Opus 4.5/4.6 | $5 | $25 | $6.25 | $0.50 | $0.01 |
⚡ Opus 4.6 Fast Mode | $30 | $150 | $37.5 | $3 | $0.01 |
🎁
重要发现：Opus 4.6 有双价格模式 — 普通模式 \$5/\$25，Fast Mode \$30/\$150（6倍！）。通过 usage.speed === 'fast' 判断当前模式。
费用计算公式
代码块
function tokensToUSDCost(modelCosts: ModelCosts, usage: Usage): number {
return (
(usage.input_tokens / 1_000_000) * modelCosts.inputTokens +
(usage.output_tokens / 1_000_000) * modelCosts.outputTokens +
((usage.cache_read_input_tokens ?? 0) / 1_000_000)
* modelCosts.promptCacheReadTokens +
((usage.cache_creation_input_tokens ?? 0) / 1_000_000)
* modelCosts.promptCacheWriteTokens +
(usage.server_tool_use?.web_search_requests ?? 0)
* modelCosts.webSearchRequests
)
}