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 能夠有效提升成本透明度，幫助優化開發流程中的資源投入。