跟踪成本
使用 /usage 命令
/usage 中的 Session 块显示 API 令牌使用情况,适用于 API 用户。Claude Max 和 Pro 订阅者的使用情况包含在订阅中,因此会话成本数据与计费无关。订阅者在同一屏幕上看到计划使用条和活动统计以及使用情况明细。/usage 顶部的 Session 块显示当前会话的详细令牌使用统计。美元数字是从令牌计数本地计算的估计值,可能与您的实际账单不同。有关权威计费,请参阅 Claude Console 中的使用情况页面。
/usage 还显示计入您的计划限制的内容明细。它将最近的使用情况归属于 skills、subagents、plugins 和各个 MCP 服务器,每个都显示为总数的百分比。按 d 或 w 在过去 24 小时和过去 7 天之间切换。这些数据是近似值,从此机器上的本地会话历史记录计算,因此不包括来自其他设备或 claude.ai 的使用情况。
当您的计划限制请求失败时(通常是因为使用情况端点受到速率限制),/usage 会显示它在过去 60 分钟内在此机器上加载的最后一个使用情况条,以及一个 Showing last-known usage 注释,说明该数据是多久前获取的。按 r 重试;成功重试会用新数据替换最后已知的条。如果没有过去 60 分钟内的快照,/usage 会报告使用情况端点受到速率限制,并提供相同的重试快捷方式。在 v2.1.208 之前,在尚未加载使用情况的会话中受速率限制的请求始终显示错误,没有条。
在 VS Code 扩展 中,相同的明细显示在”账户和使用情况”对话框中,带有”日”和”周”切换。需要 Claude Code v2.1.174 或更高版本。
在 Pro 和 Max 上设置支出限制
在 Pro 和 Max 计划上,/usage-credits 命令在 CLI 中打开一个对话框,您可以在其中管理 使用额度。从对话框中,您可以:
- 为您的账户启用使用额度
- 购买更多使用额度,可以是列出的套餐或自定义金额
- 设置、更改或移除您的每月支出限制
- 配置自动重新加载,当您的余额低于您设置的阈值时自动购买更多使用额度
/usage-credits 会在您的浏览器中打开使用额度计费页面。在 Team 和 Enterprise 计划上,具有计费访问权限的成员获得相同的浏览器页面,没有计费访问权限的成员从 CLI 发送请求,要求其管理员启用使用额度或提高限制。
更改每月支出限制需要账户的计费访问权限。如果您在仍有使用额度可用时达到该限制,Claude Code 会提示您提高或移除该限制,以便您可以继续使用而无需离开 CLI。
您输入到对话框中的金额,例如自定义购买金额、每月支出限制或自动重新加载阈值和目标,必须是数字,可选地后跟一个句号和一到两个小数位,例如 20 或 20.50。任何其他输入(包括逗号)都会显示内联错误,不会被保存。v2.1.207 之前的版本不显示对话框,而是打开计费页面。
Claude Code 要求您输入 yes 来确认每次购买和每次自动重新加载更改,无论金额多少,购买确认显示您批准的税后总额。更改每月支出限制仅在超过 $1,000 或非美元计费货币的 1,000 个单位时要求相同的输入确认。在 v2.1.208 之前,购买和自动重新加载更改也使用该阈值,因此较小的金额通过标准对话框流程进行,没有额外的输入 yes 步骤。
金额字段打开时预填充建议值,您输入的第一个数字替换建议而不是追加到它。启用使用额度的屏幕打开时选中”取消”,因此启用它需要刻意选择而不是误按 Enter。两者都需要 Claude Code v2.1.208 或更高版本。
管理组织的成本
您对 Claude Code 的控制方式取决于您的组织如何访问 Claude Code:通过 Claude for Teams 或 Enterprise 计划、Claude Console 或云提供商。在 Teams 和 Enterprise 计划中,使用情况从每个成员的座位额度中扣除。在 Console 和云提供商上,使用情况按令牌计费到您的组织。如果您的组织混合使用登录方法,每个开发者将根据他们进行身份验证的方法进行计量。 该表将每种设置映射到您查看支出的位置、您限制支出的位置以及如何提取每用户数字。
OpenTelemetry 导出适用于每种设置,是唯一能够以近实时方式将每用户令牌和成本指标流式传输到您自己的可观测性堆栈的选项。
Claude for Teams 和 Enterprise
在 Claude for Teams 和 Enterprise 计划中,每个成员的 Claude Code 使用情况从按座位额度中扣除,该额度在滚动五小时窗口和每周窗口上重置。该额度与 Claude chat 和 Cowork 共享,其大小取决于成员的座位等级(Standard 或 Premium)。您的控制位于 claude.ai 管理控制台中,而不是 Claude Console。- 查看支出:组织分析中的支出报告显示每个用户和每个模型的估计支出,带有 CSV 导出,每日更新。该报告涵盖使用额度支出,并在启用使用额度后出现。座位额度内的使用情况不以美元计量。
- 查看采用情况:分析仪表板显示每日活跃用户、会话和贡献指标,带有贡献数据的 CSV 导出。请参阅使用分析跟踪团队使用情况。
- 限制支出:座位额度是默认上限。要让成员继续超过它,请启用使用额度并在组织、组或个人成员级别设置支出限制。
- 提取每用户数字:在 Enterprise 计划中,Enterprise Analytics API 返回跨 Claude 表面(包括 Claude Code)的每用户使用情况和成本报告。主所有者在 claude.ai/analytics/api-keys 处使用
read:analytics范围创建密钥。在 Teams 计划中,导出支出报告 CSV,其中列出了每个用户和每个模型的令牌使用情况和估计支出。
Claude Console
API 组织通过工作区管理 Claude Code 支出。您可以设置工作区支出限制以限制 Claude Code 总支出,并在 Console 中查看成本和使用情况报告。当您首次使用 Claude Console 账户对 Claude Code 进行身份验证时,会自动为您创建一个名为”Claude Code”的工作区。此工作区为您的组织中的所有 Claude Code 使用情况提供集中式成本跟踪和管理。您无法为此工作区创建 API 密钥;它专门用于 Claude Code 身份验证和使用。对于具有自定义速率限制的组织,此工作区中的 Claude Code 流量计入您的组织整体 API 速率限制。您可以在 Claude Console 的此工作区的 Limits 页面上设置工作区速率限制,以限制 Claude Code 的份额并保护其他生产工作负载。
速率限制建议
为团队设置 Claude Code 时,请根据您的组织规模考虑这些每用户的令牌/分钟 (TPM) 和请求/分钟 (RPM) 建议:
例如,如果您有 200 个用户,您可能会为每个用户请求 20k TPM,或总共 400 万 TPM (200*20,000 = 400 万)。
随着团队规模的增长,每用户的 TPM 会减少,因为在较大的组织中,往往较少的用户同时使用 Claude Code。这些速率限制在组织级别应用,而不是按个人用户应用,这意味着当其他人未积极使用该服务时,个人用户可以暂时消耗超过其计算份额的资源。
如果您预期会出现异常高的并发使用情况(例如与大型团体进行的实时培训会话),您可能需要更高的每用户 TPM 分配。
云提供商
在 Amazon Bedrock、Google Cloud 的 Agent Platform 和 Microsoft Foundry 上,Claude Code 按令牌计费到您的云账户,支出控制位于您的云提供商的计费控制台中。Claude Code 不会从您的云向 Anthropic 发送指标,因此分析仪表板和 Claude Code Analytics API 不涵盖此使用情况。 对于每用户成本归因,您有三个选项:- OpenTelemetry:导出指标从每个开发者的机器到您自己的可观测性堆栈。这为您提供每用户令牌计数、成本和工具活动,无论提供商如何。
- Claude apps gateway:自托管的 Claude apps gateway提供每用户使用情况归因、带有令牌计数的 OTLP 指标,以及这些提供商上的每用户支出限制。
- LLM gateway:通过代理路由所有 Claude Code 流量,该代理按密钥跟踪支出。几个大型企业报告使用LiteLLM,一个开源工具,可以按密钥跟踪支出。此项目与 Anthropic 无关,尚未进行安全审计。
当开发者询问限制时
开发者通常会向他们的管理员提出限制问题,因此了解他们遇到的上限会很有帮助。这三种情况意味着不同的事情:- “您已达到会话限制”或”您已达到每周限制”:订阅计划上基于座位的使用窗口。这些窗口在所有模型中共享,因此使用
/model切换模型不会恢复访问权限,尽管在模型特定的”您已达到 Opus 限制”消息之后它确实让开发者继续工作。该消息显示窗口何时重置,开发者可以运行/usage-credits来请求超过额度的使用情况(如果您已启用使用额度)。请参阅使用限制错误。 - 上下文或自动压缩警告:不是使用限制。对话已接近模型的最大输入大小,Claude Code 总结较早的历史以释放空间。将开发者指向减少令牌使用。
- API 或云提供商计划上的意外高支出:通常可以追溯到从未清除的长会话或将 Opus 作为默认模型。要分享的最高影响习惯是在不相关的任务之间清除和将模型与工作相匹配,两者都在减少令牌使用中涵盖。
Agent 团队令牌成本
Agent 团队生成多个 Claude Code 实例,每个实例都有自己的上下文窗口。令牌使用情况随活跃队友的数量和每个队友运行的时间长度而扩展。 为了保持 agent 团队成本可控:- 为队友使用 Sonnet。它为协调任务平衡了能力和成本。
- 保持团队规模小。每个队友运行自己的上下文窗口,因此令牌使用大致与团队规模成正比。
- 保持生成提示的重点。队友会自动加载 CLAUDE.md、MCP servers 和 skills,但生成提示中的所有内容都会从一开始就添加到其上下文中。
- 工作完成后关闭队友。每个活跃的队友会继续消耗令牌,直到它退出或会话结束。
- Agent 团队默认被禁用。在您的settings.json或环境中设置
CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1以启用它们。请参阅启用 agent 团队。
减少令牌使用
令牌成本随上下文大小而扩展:Claude 处理的上下文越多,您使用的令牌就越多。Claude Code 通过 prompt caching(减少重复内容(如系统提示)的成本)和 auto-compact(在接近上下文限制时总结对话历史)自动优化成本。 以下策略可帮助您保持上下文较小并降低每条消息的成本。主动管理上下文
使用/usage 检查您当前的令牌使用情况,或配置您的状态行以连续显示它。
- 在任务之间清除:使用
/clear在切换到不相关的工作时重新开始。陈旧的上下文会在随后的每条消息上浪费令牌。在清除之前使用/rename以便您稍后可以轻松找到会话,然后使用/resume返回到它。 - 添加自定义 compaction 指令:
/compact Focus on code samples and API usage告诉 Claude 在总结期间保留什么。
选择正确的模型
Sonnet 处理大多数编码任务效果很好,成本低于 Opus。为复杂的架构决策或多步推理保留 Opus。使用/model 在会话中途切换模型,或在 /config 中设置默认值。对于简单的 subagent 任务,在您的 subagent 配置中指定 model: haiku。
减少 MCP server 开销
MCP 工具定义默认被延迟,因此只有工具名称进入上下文,直到 Claude 使用特定工具。运行/context 查看占用空间的内容。
- 在可用时优先使用 CLI 工具:
gh、aws、gcloud和sentry-cli等工具比 MCP servers 更节省上下文,因为它们不添加任何每工具列表。Claude 可以直接运行 CLI 命令。 - 禁用未使用的 servers:运行
/mcp查看配置的 servers 并禁用您未积极使用的任何 servers。
为类型化语言安装代码智能插件
代码智能插件为 Claude 提供精确的符号导航,而不是基于文本的搜索,减少在探索不熟悉的代码时不必要的文件读取。单个”转到定义”调用替代了可能需要的 grep 后跟读取多个候选文件。已安装的语言服务器还会在编辑后自动报告类型错误,因此 Claude 无需运行编译器即可捕获错误。将处理卸载到 hooks 和 skills
自定义 hooks可以在 Claude 看到数据之前对其进行预处理。Claude 不是读取 10,000 行日志文件来查找错误,hook 可以 grepERROR 并仅返回匹配的行,将上下文从数万个令牌减少到数百个。
skill可以为 Claude 提供领域知识,这样它就不必进行探索。例如,“codebase-overview” skill 可以描述您的项目架构、关键目录和命名约定。当 Claude 调用该 skill 时,它会立即获得此上下文,而不是花费令牌读取多个文件来理解结构。
例如,此 PreToolUse hook 过滤测试输出以仅显示失败:
- settings.json
- filter-test-output.sh
将此添加到您的 settings.json以在每个 Bash 命令之前运行 hook:
将指令从 CLAUDE.md 移动到 skills
您的 CLAUDE.md文件在会话开始时加载到上下文中。如果它包含特定工作流的详细指令(如 PR 审查或数据库迁移),即使您在做不相关的工作时,这些令牌也会存在。Skills仅在调用时按需加载,因此将专门指令移动到 skills 中可以保持您的基础上下文较小。目标是通过仅包含必要内容来将 CLAUDE.md 保持在 200 行以下。调整扩展思考
扩展思考默认启用,因为它显著改进了复杂规划和推理任务的性能。思考令牌作为输出令牌计费,默认预算可能是每个请求数万个令牌,具体取决于模型。对于不需要深度推理的更简单任务,您可以通过在/effort 中或在 /model 中降低 effort level、在 /config 中禁用思考或在具有固定思考预算的模型上通过设置 MAX_THINKING_TOKENS 环境变量(例如 MAX_THINKING_TOKENS=8000)来降低预算来降低成本。自适应推理模型忽略非零预算,因此请改用 effort levels。Fable 5 上不提供禁用思考,它始终使用扩展思考。
将冗长的操作委托给 subagents
运行测试、获取文档或处理日志文件可能会消耗大量上下文。将这些委托给 subagents,以便冗长的输出保留在 subagent 的上下文中,而只有摘要返回到您的主对话。管理 agent 团队成本
当队友在 plan mode 中运行时,Agent 团队使用的令牌大约是标准会话的 7 倍,因为每个队友维护自己的上下文窗口并作为单独的 Claude 实例运行。保持团队任务小且独立,以限制每个队友的令牌使用。有关详细信息,请参阅 agent 团队。编写具体的提示
模糊的请求(如”改进此代码库”)会触发广泛扫描。具体的请求(如”向 auth.ts 中的登录函数添加输入验证”)让 Claude 能够以最少的文件读取高效地工作。高效处理复杂任务
对于较长或更复杂的工作,这些习惯有助于避免因走错路而浪费的令牌:- 对复杂任务使用 plan mode:按 Shift+Tab 进入 plan mode,然后再进行实现。Claude 探索代码库并提出一个方法供您批准,防止当初始方向错误时的昂贵返工。
- 尽早纠正方向:如果 Claude 开始朝错误的方向发展,按 Escape 立即停止。使用
/rewind或双击 Escape 将对话和代码恢复到之前的 checkpoint。 - 给出验证目标:在您的提示中包含测试用例、粘贴屏幕截图或定义预期输出。当 Claude 可以验证自己的工作时,它会在您需要请求修复之前捕获问题。
- 增量测试:编写一个文件,测试它,然后继续。这会在问题便宜时尽早捕获问题。
后台令牌使用
Claude Code 即使在空闲时也会为某些后台功能使用令牌:- 对话总结:为
claude --resume功能总结以前对话的后台作业 - 命令处理:某些命令(如
/usage)可能会生成请求以检查状态
了解 Claude Code 行为的变化
Claude Code 定期接收可能改变功能工作方式的更新,包括成本报告。运行claude --version 检查您的当前版本。如有具体计费问题,请通过您的Console 账户联系 Anthropic 支持。