如何查看 Claude Code、Codex、Cursor 的使用量与成本：完整指南

你每月到底花了多少钱？

Claude Code 的 /usage 命令只能告诉你距离套餐上限还有多远，却无法回答一个更关键的问题：钱花在哪了？ 上周二那次会话花了多少？哪个项目吃掉了一个月的大部分成本？Max 套餐和按量付费到底哪个更划算？

好消息是，这些数据早就存在你的电脑里。Claude Code 会把每一次对话写入日志文件，每条回复都记录了所用模型和精确的 token 数。命令行工具如 ccusage 和 CodeBurn 可以读取这些文件并汇总，而你甚至不需要安装任何东西——浏览器里就能完成分析，同时还能读取 Codex 日志和 Cursor 的用量导出文件。

rss source: How to Check Claude Code, Codex and Cursor Usage and Cost (2026)

Claude Code 把用量数据存在哪里

每个会话的完整记录保存在 ~/.claude/projects/ 目录下。每个项目有独立文件夹，每次会话是一个 .jsonl 文件——每行一个 JSON 对象。子智能体的对话存放在对应会话旁边的 subagents/ 文件夹中。

不同操作系统的路径如下：

操作系统	文件夹路径
Windows	`%USERPROFILE%\.claude\projects`
macOS	`~/.claude/projects`
Linux	`~/.claude/projects`（或 `CLAUDE_CONFIG_DIR` 下的 `projects/`）

每个模型回复都有一个 usage 块，包含五个对成本计算至关重要的数字：

input tokens：未被缓存的新输入
cache creation tokens：写入提示缓存的输入，分为 5 分钟和 1 小时两种写入
cache read tokens：从缓存中读取的输入
output tokens：模型输出的内容，包括思考过程
model：例如 claude-opus-5-5

有两个容易踩坑的细节。其一，同一条回复在流式传输时可能被写入多行，恢复会话时又会被复制一次，简单的求和会导致重复计数。其二，日志文件并非永久保留——根据官方文档，超过 cleanupPeriodDays 的记录会被删除，默认值是 30 天。想要更长的历史记录，需要在文件消失之前修改 ~/.claude/settings.json 中的这个值。

什么是提示缓存（Prompt Caching）？

大语言模型的输入是按 token 计费的，而智能体每执行一步都要把完整对话、打开的文件和工具结果重新发送给模型。如果每次都按全新输入计价，成本会高到无法承受。提示缓存机制允许服务端把一段前缀内容临时存下来，后续请求若命中相同前缀，就只按远低于普通输入的价格收费。Anthropic 的缓存分为两种写入时长：5 分钟和 1 小时，写入价格不同，读取价格则统一大幅低于输入价。缓存有生存时间，过期后需要重新写入，因此频繁但间隔过长的会话反而会产生更多写入费用。理解 cache creation（写入）与 cache read（读取）的区别，是读懂后文成本表的关键。

四种查看使用量的方式对比

方式	能看到什么	需要安装	按天/项目的历史	套餐 vs API 对比	支持 Codex/Cursor
Claude Code 内 `/usage`	套餐限额进度条、当前会话	无	否	否	否
ccusage (`npx ccusage`)	终端中的日/月/会话报告	Node.js	是	否	仅 Claude Code
CodeBurn (`npx codeburn`)	终端仪表盘，多工具支持	Node.js	是	否	是，Cursor 为估算
TokenSave 用量分析器	按天/项目/模型/工具的成本，可导出 CSV	无，浏览器运行	是	是	是

/usage 适合在即将触达限额时快速查看。在 Pro 和 Max 套餐下，它还会显示是什么在消耗限额——子智能体、MCP 服务器还是缓存未命中。但它不是为回顾数周数据设计的。ccusage 和 CodeBurn 适合习惯终端操作的开发者，两者读取的是同一批 .jsonl 文件。浏览器分析器则面向不想安装 Node.js、或者想在同一屏看到套餐与 API 对比的用户。

.jsonl 格式与去重难题

.jsonl（JSON Lines）是一种每行一个独立 JSON 对象的文本格式，便于追加写入和逐行解析，日志类数据常用它。Claude Code 用它记录会话，好处是即使程序中途崩溃，已写入的行仍然完整可读。代价是同一逻辑事件可能出现多行：流式输出时每个增量块可能各写一行，会话恢复时历史又会被复制一遍。Naive 的求和会把同一份 token 算两次甚至更多次，因此所有分析工具都必须实现去重逻辑——通常按消息 ID 或响应 ID 归并。这也是为什么自己写脚本统计时，数字常常比 ccusage 或 CodeBurn 报出的偏高。

分析器的使用步骤

打开 tokensave.app/claude-code-usage
点击 Choose folder，选择你的 projects 文件夹。Windows 用户在文件夹选择器地址栏粘贴 %USERPROFILE%\.claude\projects；Mac 用户按 ⌘ + Shift + G 粘贴 ~/.claude/projects
可选：添加 ~/.codex/sessions 读取 Codex 数据，以及 Cursor 用量 CSV（Cursor 仪表盘 → Usage → Export CSV）
查看结果。可切换全部、7 天、30 天和本月周期，选择你的套餐进行对比

The file picker and the folder paths for Claude Code, Codex and Cursor

关于结果解读有几点需要注意。"Replies" 统计的是去重后的模型响应数，不是你的提问数——向智能体发出一次提示通常会产生多条回复，因为每次工具调用和每个步骤都是独立响应。"Tokens" 汇总了输入、输出和两类缓存流量，所以数字看起来会比实际对话规模大得多。如果某个模型还没有已知定价，分析器会将其列在表格下方而不是猜测价格。Download CSV 按钮会导出一份按天分行、包含所有 token 类型和成本的表格，可直接用于电子表格分析。

Chrome 在选择文件夹时可能弹出"是否上传文件到此站点？"——这只是浏览器对文件夹访问的固定措辞。页面通过浏览器的 File API 读取文件，只做数字汇总，你的提示词和代码不会离开标签页，不会发送到任何服务器。

从日志中读出的真实数据

作者用三组日志做了实测：构建和维护网站时使用的 Claude 智能体会话、PC 上的 Codex 会话，以及账户的 Cursor 用量 CSV。

工具	回复数	Token 数	API 等价成本	所用套餐
Claude Code (Opus 5.5)	1,636	277.5M	$145.90	Max 5×
Codex (GPT-5.6 Terra, GPT-6 Luna)	108	6.5M	$1.98	免费
Cursor (Grok 4.6)	2	379K	$0.29	免费

Claude Code 部分覆盖了 9 月 29 日至 10 月 15 日之间的 10 个活跃日，最繁忙的一天（10 月 8 日）按 API 价格计算约 $39。

Token 分布才是真正的意外。在 2.775 亿 token 中，全新输入只有约 3,000 个。约 2.64 亿是缓存读取，约 1,080 万是缓存写入，180 万是输出。换句话说，Claude Code "使用"的超过 95% 是同一份上下文被反复从缓存中读取。 这正是智能体的工作方式：每一步都重新发送对话、打开的文件和工具结果，而缓存让这个过程变得便宜。

但便宜不等于免费。以下是 $145.90 的构成（按 Opus 5.5 定价）：

部分	每百万 token 价格	成本占比
缓存读取	$0.20	约 36%
5 分钟缓存写入	$5.00	约 34%
输出	$20.00	约 25%
1 小时缓存写入	$8.00	约 4%
全新输入	$4.00	不到 1%

缓存读取比 Opus 5.5 的普通输入便宜 95%，但数量太大，仍然占据最大成本份额。缓存写入几乎同样多，因为每个新文件、工具结果或长回复都必须先写入缓存才能被低成本读取。输出只有 180 万 token，却占了四分之一的账单，因为输出定价是每百万 $20。

如果没有缓存，这些缓存读取按普通输入价格计算将多花约 $1,017——这就是截图中"Saved by caching"的数字。

为什么输出 token 那么贵？

在自回归生成中，模型每产出一个 token 都要完整前向计算一次，而输入侧可以通过并行计算和缓存复用摊薄成本。因此输出定价通常是输入的 5 到 10 倍。实测中，180 万输出 token 只占总量的千分之六左右，却贡献了约四分之一的账单，原因即在此。输出还包含模型在给出最终答案前的思考（reasoning）过程，这部分用户看不到，但同样计费。想要压降输出成本，最直接的办法是减少不必要的长回复和冗长的工具调用说明，而不是简单缩减提问字数。

Max 套餐值不值？套餐与 API 的对比

Analyzer results: API-equivalent cost, tokens, cache savings and cost by tool

分析器会将你选择的套餐与同一工具在同期内的 API 成本进行对比。Claude 日志跨越 17 天，Max 5× 每月税前 $100，17 天约合 $56.67。同样的 token 走 API 需要 $145.90，意味着按 API 价值计算用掉了套餐费的约 257%。 对于高强度的智能体工作，订阅明显比按量付费更划算。

但有两个需要警惕的情况：

套餐有上限。 Pro 和 Max 每 5 小时重置一次，还有周上限。如果 API 等价数字是套餐费的很多倍，你可能已经在触及这些限制了，真正的选择变成了等待、升级还是购买额外用量。
轻度用户买套餐可能亏钱。 作者的 Codex 和 Cursor 用量都在免费套餐上，分别只有 $1.98 和 $0.29。如果为了这点 Codex 用量去付 ChatGPT Plus（每月 $20），套餐价值还不如费用本身。分析器会以琥珀色标出这种情况。

Codex 和 Cursor 的用量数据

Codex 将日志存放在 ~/.codex/sessions/YYYY/MM/DD/ 下，每次会话一个 rollout-….jsonl 文件。它不是在每条回复里写 usage 块，而是在每一步写入整个会话的运行总计。分析器取相邻步骤的差值，按 OpenAI API 费率计算成本，缓存输入按缓存价格计费。归档会话会以相同名字移入 archived_sessions/，因此分析器只按文件名计数一次，避免重复。

Cursor 的情况不同。打开 Cursor 本地数据库后发现，每个对话的 token 计数都存为零——当前版本不在本地保留 token 数据，这也是命令行工具只能从文本长度估算 Cursor 用量的原因。准确来源是 Cursor 仪表盘上的用量导出：进入 Usage，点击 Export CSV。每一行包含日期、模型、含与不含缓存写入的输入、缓存读取、输出，以及 Cursor 收取的费用。分析器直接使用该费用数据。

如何降低使用成本

既然大部分成本来自缓存流量和输出，几个习惯就能带来改变：

新任务开启新会话。 /clear 丢弃旧上下文，后续步骤不再反复读取它。长会话会持续为之前的所有内容支付缓存读取费用。
日常任务使用 Sonnet。 Sonnet 5.5 是每百万 $2/$10，而 Opus 5.5 是 $4/$20，同样的会话按 API 价格计算成本降低约 50%。
关注高消费日。 日成本图表能直观看到哪一天、哪类任务推高了成本。
精简不用的工具。 在套餐模式下，/usage 会显示哪些 MCP 服务器和子智能体占用了限额份额。

常见问题

如何查看 Claude Code 的用量历史？ 用分析器打开 ~/.claude/projects 文件夹，或在终端运行 npx ccusage。Claude Code 内的 /usage 只显示当前限额，不提供历史记录。

分析器会上传我的代码吗？ 不会。它在浏览器标签页内读取文件，只汇总 token 数字，不向任何地方发送数据。

为什么 API 等价成本远高于套餐费？ 智能体每一步都重新读取整个上下文，产生大量缓存流量。套餐是固定费用，API 等价数字是同样的 token 如果按量付费的价格。

为什么只显示最近一个月？ Claude Code 默认删除超过 30 天的记录。在 settings.json 中提高 cleanupPeriodDays 可保留更久。

能读取 Gemini CLI、Copilot 或 Windsurf 吗？ 目前不支持，现阶段支持 Claude Code、Codex 和 Cursor CSV。

总结

Claude Code 已经记录了你使用的每一个 token，难的是把它读出来。/usage 告诉你距离限额还有多远，而 ~/.claude/projects 里的日志告诉你钱花在了哪里。在 17 天的智能体工作实测中，几乎所有 token 都是缓存读取，缓存流量占了 API 等价成本的四分之三左右，Max 5× 返回了约 257% 的套餐费价值。免费套餐上的 Codex 和 Cursor 只花了区区几美元。把文件夹加载进用量分析器，你就能看到自己的真实数字。