有效管理成本

​

跟踪成本

​

使用 /usage 命令

Total cost:            $0.55
Total duration (API):  6m 20s
Total duration (wall): 6h 33m 10s
Total code changes:    0 lines added, 0 lines removed
Usage by model:
   claude-sonnet-4-6:  1.2k input, 5.3k output, 940.0k cache read, 50.0k cache write ($0.55)

​

Prompt cache 统计

Prompt cache (main):   14 requests · 91% of input tokens from cache · 2 misses (last 6m 10s ago, 310.2k tokens re-cached) · 1 expected rebuild (compaction or tool-result clearing) · warm (1h TTL, last activity 40s ago)

• Misses（未命中）：重新处理缓存已保存内容的请求，包括最后一次未命中的时间以及这些请求写回缓存的令牌数。当请求重新处理了超过 5% 且至少 2,000 个令牌的内容时，Claude Code 会将请求计为未命中，这些内容本可以从缓存中读取。使缓存失效的操作列出了常见原因。当 Claude Code 能够识别最后一次未命中的可能原因时，该行也会命名它，例如 likely cause: tool definitions changed。可能原因文本需要 Claude Code v2.1.260 或更高版本。
• Expected rebuilds（预期重建）：当 Claude Code 本身刚刚重写对话时，通过压缩或从上下文中清除旧工具结果，它会将相同类型的未命中计为预期重建。此部分仅在至少发生过一次预期重建后出现。
• Warm or cold（热或冷）：缓存的前缀是否仍在其缓存生命周期内，以及生效的 TTL。当缓存冷时，该行显示会话已空闲多长时间。当没有响应报告缓存令牌时，该行以 no prompt caching reported by the API 结尾。

​

计划使用情况明细

• Attribution（归属）：最近使用情况归属于 skills、subagents、plugins 和各个 MCP 服务器，每个都显示为总数的百分比。MCP 服务器的份额仅计算消耗其工具结果之一的请求。在 v2.1.222 之前，在调用 MCP 服务器一次后，Claude Code 将每个后续请求归属于该服务器，高估了其份额。
• Behavior flags（行为标志）：行为，例如长上下文或缓存未命中，当其占最近使用情况的 10% 或更多时标记。
• Loops（循环）：最近运行的每个最重的 /loop 或其他计划任务 的行，按总令牌排序，其余的计数。Claude Code 报告每个任务触发的频率、运行次数、其总令牌和每次运行令牌，以及最后一次运行的时间。Claude Code 通过任务的提示键入行，因此您停止并重新创建的循环保持为一行。需要 Claude Code v2.1.242 或更高版本。

​

检查您的使用额度支出

• Pro 和 Max：当前月份的支出，与您设置的每月支出限制进行比较（如果您设置了一个）。当您未设置限制时，该行显示 Unlimited，没有支出数字。
• Team 和 Enterprise：当前月份的您自己的支出，与您的组织设置的任何限制进行比较，该限制适用于您。覆盖整个组织的限制不会出现在该行中。当您没有自己的限制时，该行显示您的支出，旁边没有限制。当使用额度对您关闭时，/usage 不显示使用额度行。

​

当使用情况请求失败时

​

分析您的使用情况模式

​

向您的订阅添加使用额度

​

管理组织的成本

​

按您的合同费率报告支出

​

Claude for Teams 和 Enterprise

• 查看支出：组织分析中的支出报告显示每个用户和每个模型的估计支出，带有 CSV 导出，每日更新。该报告涵盖使用额度支出，并在启用使用额度后出现。座位额度内的使用情况不以美元计量。
• 查看采用情况：分析仪表板显示每日活跃用户、会话和贡献指标，带有贡献数据的 CSV 导出。请参阅使用分析跟踪团队使用情况。
• 限制支出：座位额度是默认上限。要让成员继续超过它，请启用使用额度并在组织、组或个人成员级别设置支出限制。
• 提取每用户数字：在 Enterprise 计划中，Enterprise Analytics API 返回跨 Claude 表面（包括 Claude Code）的每用户使用情况和成本报告。主所有者在 claude.ai/analytics/api-keys 处使用 read:analytics 范围创建密钥。在 Teams 计划中，导出支出报告 CSV，其中列出了每个用户和每个模型的令牌使用情况和估计支出。

​

Claude Console

​

速率限制建议

​

云提供商

• OpenTelemetry：导出指标从每个开发者的机器到您自己的可观测性堆栈。这为您提供每用户令牌计数、成本和工具活动，无论提供商如何。
• Claude apps gateway：自托管的 Claude apps gateway提供每用户使用情况归因、带有令牌计数的 OTLP 指标，以及这些提供商上的每用户支出限制。
• LLM gateway：通过代理路由所有 Claude Code 流量，该代理按密钥跟踪支出。几个大型企业报告使用LiteLLM，一个开源工具，可以按密钥跟踪支出。此项目与 Anthropic 无关，尚未进行安全审计。

​

当开发者询问限制时

• “您已达到会话限制”或”您已达到每周限制”：订阅计划上基于座位的使用窗口，在所有模型中共享，因此开发者无法通过使用 /model 切换模型来恢复访问权限。该消息显示窗口何时重置。在模型特定的”您已达到 Opus 限制”或”您已达到 Sonnet 限制”消息之后，使用 /model 切换到该系列之外的模型确实会让开发者继续工作。请参阅使用限制错误。开发者在此期间可以做什么：
  • 运行 /usage-credits 以请求超过额度的使用情况，如果您已启用使用额度。
  • 在 Claude Code v2.1.234 或更高版本上，在重置后自动等待并继续中断的任务；该部分列出了 Claude Code 何时自动启动等待以及开发者何时从 /rate-limit-options 中选择它。要控制您的车队 Claude Code 是否自动启动该等待，请在托管设置中设置 autoContinueAtUsageLimit。
• 来自 Claude apps gateway 的支出限制消息：开发者超过了您在自托管网关上设置的支出上限，网关会阻止他们的请求，直到该期间重置或您提高上限。请参阅网关支出限制以了解上限、重置计划和开发者看到的消息。
• 上下文或自动压缩警告：不是使用限制。对话已接近会话的自动压缩窗口，这是 Claude Code 总结较早历史以释放空间的阈值。将开发者指向减少令牌使用。
• API 或云提供商计划上的意外高支出：通常可以追溯到从未清除的长会话或将 Opus 作为默认模型。要分享的最高影响习惯是在不相关的任务之间清除和将模型与工作相匹配，两者都在减少令牌使用中涵盖。

​

Agent 团队令牌成本

• 为队友使用 Sonnet。它为协调任务平衡了能力和成本。
• 保持团队规模小。每个队友运行自己的上下文窗口，因此令牌使用大致与团队规模成正比。
• 保持生成提示的重点。队友会自动加载 CLAUDE.md、MCP servers 和 skills，但生成提示中的所有内容都会从一开始就添加到其上下文中。
• 工作完成后关闭队友。每个活跃的队友会继续消耗令牌，直到它退出或会话结束。
• Agent 团队默认被禁用。在您的settings.json或环境中设置 CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1 以启用它们。请参阅启用 agent 团队。

​

减少令牌使用

​

主动管理上下文

• 在任务之间清除：使用 /clear 在切换到不相关的工作时重新开始。陈旧的上下文会在随后的每条消息上浪费令牌。在清除之前使用 /rename 以便您稍后可以轻松找到会话，然后使用 /resume 返回到它。
• 添加自定义 compaction 指令：/compact Focus on code samples and API usage 告诉 Claude 在总结期间保留什么。在新会话中，/compact 打印 Not enough messages to compact.，因为还没有对话历史可以总结。

# Compact instructions

When you are using compact, please focus on test output and code changes

​

选择正确的模型

​

减少 MCP server 开销

• 在可用时优先使用 CLI 工具：gh、aws、gcloud 和 sentry-cli 等工具比 MCP servers 更节省上下文，因为它们不添加任何每工具列表。Claude 可以直接运行 CLI 命令。
• 禁用未使用的 servers：运行 /mcp 查看配置的 servers 并禁用您未积极使用的任何 servers。

​

为类型化语言安装代码智能插件

​

将处理卸载到 hooks 和 skills

{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Bash",
        "hooks": [
          {
            "type": "command",
            "command": "~/.claude/hooks/filter-test-output.sh"
          }
        ]
      }
    ]
  }
}

#!/bin/bash
input=$(cat)
cmd=$(echo "$input" | jq -r '.tool_input.command')

# If running tests, filter to show only failures
if [[ "$cmd" =~ ^(npm test|pytest|go test) ]]; then
  filtered_cmd="$cmd 2>&1 | grep -A 5 -E '(FAIL|ERROR|error:)' | head -100"
  echo "$input" | jq --arg filtered "$filtered_cmd" \
    '{hookSpecificOutput: {hookEventName: "PreToolUse", permissionDecision: "allow", updatedInput: (.tool_input + {command: $filtered})}}'
else
  echo "{}"
fi

​

将指令从 CLAUDE.md 移动到 skills

​

调整扩展思考

​

将冗长的操作委托给 subagents

​

管理 agent 团队成本

​

编写具体的提示

​

高效处理复杂任务

• 对复杂任务使用 plan mode：按 Shift+Tab 进入 plan mode，然后再进行实现。Claude 探索代码库并提出一个方法供您批准，防止当初始方向错误时的昂贵返工。
• 尽早纠正方向：如果 Claude 开始朝错误的方向发展，按 Escape 立即停止。使用 /rewind 或双击 Escape 将对话和代码恢复到之前的 checkpoint。
• 给出验证目标：在您的提示中包含测试用例、粘贴屏幕截图或定义预期输出。当 Claude 可以验证自己的工作时，它会在您需要请求修复之前捕获问题。
• 增量测试：编写一个文件，测试它，然后继续。这会在问题便宜时尽早捕获问题。

​

后台令牌使用

• 对话总结：为 claude --resume 功能总结以前对话的后台作业
• 命令处理：某些命令（如 /usage）可能会生成请求以检查状态

​

为什么长时间会话中使用量会增加

• 长上下文：Claude Code 在每个请求中发送你与它的完整对话，每当 Claude 使用工具时，它会发送另一个请求，其中包含该批工具结果。使用 prompt caching，Claude Code 以 缓存令牌速率 重新读取该历史记录，因此即使在已打开一整天的会话中提出一行问题，仍然会为整个对话消耗使用量。请参阅 主动管理上下文 了解保持上下文较小的方法
• 缓存未命中：在超过 缓存生命周期 的中断后的第一条消息会错过缓存并重新处理你的完整上下文。在订阅上生命周期为一小时，一旦你开始使用 使用额度，生命周期会降至五分钟；在 API 密钥或云提供商上，默认为五分钟。要在使用使用额度时保持一小时的生命周期，自己选择 TTL。在 Pro 和 Max 计划上，当你在长时间中断后恢复大型会话时，Claude Code 提供从摘要恢复 的选项，以便后续请求不会携带完整历史记录
• 计划任务：计划任务 按其间隔触发，即使会话处于空闲状态，每次都发送你的完整上下文
• 跨会话消息：当此会话处于空闲状态时，Claude Code 将 来自你另一个会话的消息 作为新轮次传递，每次都发送你的完整上下文。要保留入站消息而不是传递它们，请将 crossSessionInbound 设置为 hold
• 目标检查：当后台工作使活跃的 目标 保持等待时，Claude Code 要求 Claude 检查该工作，即使会话处于空闲状态，启动发送你完整上下文的新轮次。Claude Code 在你的提示之间每个目标最多启动三个空闲检查。在 v2.1.246 之前，空闲检查是无限制的。要关闭检查，请将 CLAUDE_CODE_GOAL_CHECKIN_MINUTES 设置为 0。空闲检查需要 Claude Code v2.1.236 或更高版本
• 代理队友：每个活跃的 队友 会继续消耗令牌，直到它退出
• 压缩：/compact 读取它总结的对话，因此 压缩大型上下文 本身就是一个大型请求。当你想要全新开始而不是连续性时，/clear 不消耗任何成本

​

了解 Claude Code 行为的变化

• 订阅计划（Pro、Max、Team、Enterprise）：在 claude.ai 登录，点击左下角的您的首字母缩写，然后选择获取帮助
• Console（API）计费：在 platform.claude.com 登录，点击您的首字母缩写，然后选择获取帮助