是什么
costs 描述 Claude Code 的计费模型、成本追踪工具、团队限额管理和降低 token 用量的策略。按 API token 消耗计费,实际成本因模型选择、代码库大小和使用模式差异显著。
核心机制
成本基准
- 企业部署平均:约 150-250/开发者/月
- 90% 用户每活跃天低于 $30
- 建议先小规模 pilot 建立基线再全量推广
成本追踪
/usage命令:当前 session 的 token 统计和本地估算成本(非账单依据)- Claude Console:platform.claude.com/usage,权威账单数据
- Bedrock/Vertex/Foundry:不发送 metrics 到 Anthropic,推荐用 LiteLLM 追踪
团队限额管理
- Console API 用户:在 Console 设置 workspace spend limit
- 自动创建 “Claude Code” workspace 用于集中追踪,不能在此 workspace 创建 API key
- 可设置 workspace rate limit 保护其他生产工作负载
Rate Limit 建议(TPM/RPM per user)
| 团队规模 | TPM/用户 | RPM/用户 |
|---|---|---|
| 1-5 人 | 200k-300k | 5-7 |
| 5-20 人 | 100k-150k | 2.5-3.5 |
| 20-50 人 | 50k-75k | 1.25-1.75 |
| 100-500 人 | 15k-20k | 0.37-0.47 |
| 500+ 人 | 10k-15k | 0.25-0.35 |
降低 token 用量
- 选择合适模型:Sonnet 适合日常任务,Opus 用于复杂推理
- 控制 context 大小:使用
/compact压缩对话历史 - Agent teams:每个 teammate 独立 context window,团队规模直接影响成本
- 关闭 extended thinking(非必要时)
- 使用 preprocessing hooks 过滤无关内容
关键细节
- LiteLLM 可按 key 追踪消费,但非 Anthropic 官方工具,未经安全审计
- LiteLLM PyPI 1.82.7 和 1.82.8 版本曾被植入恶意代码,避免使用
- Agent teams 中推荐用 Sonnet 作为 teammate 模型以平衡能力和成本
- 大型培训活动等高并发场景需提前申请更高 TPM
与其他概念的关联
- monitoring-usage - OpenTelemetry 细粒度成本监控
- analytics - 团队用量仪表盘
- llm-gateway - 通过 LiteLLM 等网关追踪多提供商成本
实践要点
/usage显示的成本是本地估算,与实际账单可能有差异- 订阅计划(Pro/Max)用户的 session cost 仅供参考,不影响计费
- 设置 workspace rate limit 时考虑并发使用场景,避免过低限制影响正常使用