Prtokens – 查看AI代理令牌的PR成本

Prtokens 是一款面向开发者的命令行工具，旨在帮助团队直观了解使用 AI 编码代理（如 Claude Code、Codex 和 OpenCode）时，单个 Pull Request（PR）所消耗的令牌数量及其估算成本。该工具通过读取本地存储的代理会话转录文件，将令牌使用量精确归因到 PR 分支上的各个提交，最终在 PR 中自动发布一条包含详细成本分析的评论。

使用 Prtokens 非常简单。只需确保已安装 Node.js 22.13 及以上版本，并通过 gh auth login 完成 GitHub CLI 的身份认证。之后，在包含开放 PR 的分支上运行 npx prtokens，工具将自动检测当前分支对应的 PR，读取本地代理转录数据，并发布或更新一条估算成本评论。重复运行该命令可刷新评论内容，多个贡献者的数据将以独立标签段显示。

评论内容以清晰的结构呈现，包括总成本、令牌输入/输出量、会话数、使用的模型列表以及按代理拆分的成本。此外，还包含一个可折叠的按提交明细表，列出每个提交的令牌消耗、成本及对应会话数。例如，评论可能显示：“🪙 此 PR 大约花费 $4.12 令牌费用”，并进一步分解为 Claude Code 和 Codex 的具体花费。

除了基础功能，Prtokens 还提供了丰富的命令选项。--dry-run 模式可将渲染后的评论输出到标准输出而不实际发布；--json 模式输出包含完整数据的 JSON 负载；--verbose 模式打印详细诊断信息。通过 prtokens init 可安装可选的全局预推送钩子，实现每次 git push 时自动发布成本评论。工具还支持 prtokens pr create 命令，在创建 PR 的同时直接发布评论。

隐私保护是 Prtokens 的核心设计原则。所有转录数据仅在本地处理，从不离开用户机器。PR 评论中仅包含聚合的令牌计数、估算美元成本、会话数、模型名称以及已在 PR 中可见的提交元数据。自动队列仅存储仓库路径、远程分支名、提交哈希、时间戳和任务状态，绝不涉及转录内容、提示词或评论文本。

Prtokens 基于 MIT 许可证开源，使用 TypeScript 和 JavaScript 编写，并已在 GitHub 上发布多个版本。对于使用 AI 编码工具的开发团队来说，Prtokens 能够有效提升成本透明度，帮助优化开发流程中的资源投入。