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