CC-Ledger: Claude Code Cost Tracker (Per-Session and Per-PR)

说明与用途

**项目简介**
CC‑Ledger 是一个用于跟踪 Claude（Anthropic）代码生成费用的工具，能够按会话（Session）和 Pull Request（PR）分别记录并统计消耗的 token 与费用。它适合在代码审查或 CI 流程中实时监控 LLM 使用成本。

**价值**

• **成本可视化**：帮助团队了解每次代码生成或每个 PR 消耗的 Claude 费用，避免意外超支。
• **预算控制**：配合内部费用分摊或上限警报，实现对 LLM 预算的细粒度管理。
• **决策依据**：通过历史成本数据，评估不同提示（prompt）或模型版本的性价比，指导后续使用策略。

**典型接入方式**

1. **CI/CD 集成**：在 GitHub Actions、GitLab CI 或 Jenkins 等流水线中添加一个步骤，调用 CC‑Ledger 的 CLI 或 API，将当前 PR 的代码变更提交给 Claude，并记录返回的 token 用量。
2. **本地开发插件**：在 IDE（如 VS Code）中安装对应插件或使用预提交钩子（pre‑commit hook），在每次本地提交前自动发送代码片段至 Claude 并写入本地 ledger。
3. **Webhook 方式**：在仓库设置 webhook，监听 PR 打开/更新事件，后端服务调用 Claude 并把费用信息写入 CC‑Ledger 的持久化存储（如 SQLite、PostgreSQL），再通过仪表盘或 Slack 通知展示。

**生产可用性**

• **成熟度**：当前评分 41/100，属于 **中等** 级别。代码最近更新于 2026‑05‑12，文档与示例较少，集成信号稀疏。
• **适用场景**：适合原型、内部工具或成本实验项目；在正式生产环境使用前建议进行以下检查：
• **许可证**：确认符合企业合规（MIT、Apache 等）。
• **依赖安全**：审计第三方库的安全性和维护状态。
• **文档完整度**：补全安装、配置、API 调用示例。
• **发布节奏**：观察项目的 issue 响应和版本迭代频率，确保后续能得到维护。
• **风险**：质量信号有限，可能出现未捕获的错误或缺乏官方支持。建议在内部环境进行充分测试后，再决定是否推广到生产环境。

实际用途

CC-Ledger: Claude Code Cost Tracker (Per-Session and Per-PR) may be useful when its README and activity match a concrete workflow.

限制与审查说明

Medium: useful for prototypes or internal workflows, with dependency and maintenance checks before production.