cost-metering

跨会话跟踪 Claude API 成本，并提供预算提醒、模型路由优化和支出报告。与 workflow-orchestrator 的成本门禁集成，以自动执行预算限制。

<quick_start> 查看当前支出：

cat ~/.claude/daily-cost.json 2>/dev/null || echo "No tracking yet"

初始化跟踪：

mkdir -p ~/.claude
echo '{"date":"'$(date +%Y-%m-%d)'","spent":0,"budget_monthly":100,"budget_daily":5}' > ~/.claude/daily-cost.json

</quick_start>

<success_criteria>

• 每日成本跟踪已初始化，文件位于 ~/.claude/daily-cost.json
• 预算提醒在 50%（信息）、80%（警告）和 95%（阻止）阈值触发
• 已应用模型路由：搜索/分类使用 Haiku，代码使用 Sonnet，批量处理使用 DeepSeek
• 可通过 portfolio-artifact 集成获取单项功能成本指标
• 月度支出保持在配置的预算范围内（默认 $100/mo） </success_criteria>

- “成本检查”、“预算状态”、“花了多少钱” - “优化成本”、“成本跟踪”、“预算提醒” - “模型路由”、“更便宜的模型”、“成本报告”

---

模型费率（当前）

模型	输入/1M 令牌	输出/1M 令牌	典型用途
Claude Opus 4.6	$5.00	$25.00	架构设计、复杂推理
Claude Sonnet 4.6	$3.00	$15.00	代码生成、常规任务
Claude Haiku 4.5	$1.00	$5.00	搜索、分类、简单任务
DeepSeek V3	$0.27	$1.10	批量处理
GROQ Llama 3.3 70B	$0.59	$0.79	快速推理
Voyage Embeddings	$0.10	—	嵌入

v1.1.0 定价变更： Opus 从 $15/$75 降至 $5/$25（Opus 4.6 便宜 70%）。Haiku 从 $0.25/$1.25 涨至 $1/$5（从 Haiku 3 升级到 4.5，贵 4 倍）。Sonnet $3/$15 保持不变（模型从 4.5 升级到 4.6）。

---

预算配置

~/.claude/daily-cost.json

{
  "date": "2026-02-07",
  "spent": 2.40,
  "budget_monthly": 100,
  "budget_daily": 5,
  "alerts": {
    "info": 0.5,
    "warn": 0.8,
    "block": 0.95
  }
}

提醒阈值

阈值	占预算比例	操作
信息	50%	显示：“已使用月度预算的 50%”
警告	80%	黄色提醒：“⚠️ 预算已用 80% — 请考虑降级模型”
阻止	95%	红色提醒：“🛑 预算已用 95% — 继续操作需要明确覆盖”

---

成本优化策略

1. 模型路由（影响最大）

任务	高成本方案	优化方案	节省
文件搜索	Sonnet（$3/1M）	Haiku（$1/1M）	67%
代码审查	Sonnet（$3/1M）	Haiku（$1/1M）	67%
分类	Sonnet（$3/1M）	Haiku（$1/1M）	67%
批量处理	Sonnet（$3/1M）	DeepSeek（$0.27/1M）	91%

规则： 如果任务不会生成代码，就使用 Haiku。如果任务不需要 Claude，就使用 DeepSeek。

2. 上下文管理

• 将 SKILL.md 文件控制在 200 行以内（渐进式披露）
• 仅在需要时加载参考文件
• 使用 Explore Agent 和 haiku 模型搜索代码库
• 避免读取整个文件 — 使用 Grep 查找特定行

3. 任务批处理

• 将相关搜索合并到一次 Explore Agent 调用中
• 使用并行子 Agent（haiku），而非串行 sonnet 调用
• 尽可能合并文件读取操作

---

跟踪命令

每日支出检查

cat ~/.claude/daily-cost.json | jq '{date, spent, remaining: (.budget_daily - .spent), pct: ((.spent / .budget_monthly) * 100 | floor)}'

每周报告

# Aggregate daily logs
cat ~/.claude/cost-log.jsonl | jq -s 'group_by(.phase) | map({phase: .[0].phase, total: (map(.est_cost) | add), count: length})'

月度汇总

cat ~/.claude/cost-log.jsonl | jq -s '{
  total: (map(.est_cost) | add),
  by_model: (group_by(.model) | map({model: .[0].model, cost: (map(.est_cost) | add)})),
  by_phase: (group_by(.phase) | map({phase: .[0].phase, cost: (map(.est_cost) | add)}))
}'

---

集成点

系统	方式
workflow-orchestrator	工作流运行前，成本门禁会检查预算
subagent-teams	模型选择使用成本档位
agent-capability-matrix	包含模型建议
portfolio-artifact	报告单项功能成本指标
End Day 协议	记录每日成本，更新 MTD
TaskCreate/TaskUpdate	API 成本为零 — 用于进度跟踪的本地 UI 工具
TeamCreate/SendMessage	API 成本为零 — 本地协调（但启动的 Agent 会产生模型成本）

---

存储

~/.claude/
├── daily-cost.json          # Current day's budget + spend
├── cost-log.jsonl           # Append-only operation log
└── portfolio/
    └── daily-metrics.jsonl  # Includes cost-per-feature

深入了解： 请参阅 reference/cost-tracking-guide.md、reference/budget-templates.md

写入结果 Sidecar

最后一步，将结果写入 ~/.claude/skill-analytics/last-outcome-cost-metering.json：

{"ts":"[UTC ISO8601]","skill":"cost-metering","version":"1.1.0","variant":"default",
 "status":"[success|partial|error]","runtime_ms":[estimated ms from start],
 "metrics":{"sessions_tracked":[n],"total_cost_usd":[n],"budget_alerts":[n]},
 "error":null,"session_id":"[YYYY-MM-DD]"}

如果部分阶段失败但已生成结果，请使用状态 "partial"。仅在未生成任何输出时使用 "error"。