agentacct：面向編碼代理的本地優先終端儀表板
查看您的編碼代理做了什麼以及花費了多少。將每個任務分解為工作步驟、使用的工具、更改的檔案、執行的測試、花費的時間和令牌。適用於 Claude Code、Codex、OpenCode 等的本機優先儀表板。無需登錄，無需遙測。
秒懂
- 它是什麼？
- 讀取 Claude Code 和 Codex 的本地會話日誌，在即時終端介面中顯示使用量、估算成本、工作步驟和歸因信賴度，不傳送任何資料。
- 適合誰用？
- agentacct 適合需要 README 所述功能，且能接受其語言、平台與部署條件的使用者；不適合把專案描述當成已驗證效能或收益承諾的人。採用前先依 mikehasa/agentacct README 中的具體入口核對 agentacct 的安裝、主要操作與失敗回應，並確認授權條款符合你的發佈方式。
- 可以商用嗎？
- 可以。MIT 是寬鬆授權：你可以使用、修改並販售以它為基礎的軟體，只需保留著作權與授權聲明。
- 還在維護嗎？
- 有在維護。儲存庫最近一次提交在 2 天前。
- 用什麼語言寫的？
- 主要是 Python（依據 GitHub 的語言統計）。
以上回答依據專案的 GitHub 資料（最近同步於 2026年9月14日）與我們的分析，不構成法律意見。
開源專案深度解析
讀取本地會話日誌到即時終端儀表板
agentacct 讀取 Claude Code 和 Codex 已經寫入您機器的會話日誌，將它們與會話記錄的工作合併，並在 `agentacct tui`（一個即時終端儀表板）中顯示結果。無需瀏覽器、無需伺服器、無需帳戶。一切都在您的機器上：狀態是純本地檔案，不綁定任何網路連接埠，沒有電話回傳遙測，沒有帳戶，沒有雲端同步。agentacct 從不儲存或請求提供者 API 金鑰。（agentacct 第1節核對）
agentacct 的這一部分不能只用功能清單理解。README 明確提到的 `agentacct tui`、`127.0.0.1`、`agentacct stop`，應與本節描述的輸入、輸出或操作順序一起閱讀。這使文章的判斷落在 mikehasa/agentacct 的實際介面上，而不是套用其他工具的經驗。（agentacct 第1節核對）
在 agentacct 的使用情境中，取捨取決於既有環境是否符合 README 寫出的條件。若要核對本節，應直接查看 mikehasa/agentacct 的 README 與相關設定；有命令時照命令執行，有版本或平台限制時保留原文限制，不能把未說明的行為當成保證。（agentacct 第1節核對）
使用量、工作步驟和歸因標籤
TUI 顯示使用視窗、提供者速率限制條（帶重置倒數計時）和最近的會話。按 `s` 深入檢視會話，按 `u` 檢視使用畫面，按 `p` 儲存目前檢視的可分享 SVG 快照。每個代理、模型和日的代幣從用戶端自己的本地會話檔案讀取，並標記為 `client_reported`；成本是定價表估算值，絕不是發票。每個會話彙總其記錄的工作步驟和機器檢查，狀態如 `in progress`、`handed off`、`done`、`blocked`，以及帶退出代碼的檢查結果。使用量和工作之間的歸因帶有信賴度標籤：exact、high、medium、low。當 agentacct 無法證明連線時，它顯示缺口而不是猜測。（agentacct 第2節核對）
agentacct 的這一部分不能只用功能清單理解。README 明確提到的 `127.0.0.1`、`agentacct stop`、`agentacct tui`，應與本節描述的輸入、輸出或操作順序一起閱讀。這使文章的判斷落在 mikehasa/agentacct 的實際介面上，而不是套用其他工具的經驗。（agentacct 第2節核對）
在 agentacct 的使用情境中，取捨取決於既有環境是否符合 README 寫出的條件。若要核對本節，應直接查看 mikehasa/agentacct 的 README 與相關設定；有命令時照命令執行，有版本或平台限制時保留原文限制，不能把未說明的行為當成保證。（agentacct 第2節核對）
使用真相和工作意義分開，直到連線
agentacct 保持兩條證據流分開，並在真實用戶端 ID 上連線它們。使用真相來自用戶端自己的本地會話檔案，標記為 `client_reported`。工作意義來自代理在工作時透過 MCP 記錄的章節和事件，包括 `agentacct_record_section` 和 `agentacct_record_machine_check`，以及像測試執行這樣的機器檢查。連線透過會話/轉錄 ID 連結兩者，並標記每個歸因為 exact、high、medium 或 low。對於 Claude Code，安裝的鉤子橋在會話開始和每次工具呼叫時捕獲真實的會話/轉錄 ID；對於 Codex，連線在匯入時從用戶端自己的會話日誌中取證。詳細資訊在 docs/reference.md 中。（agentacct 第3節核對）
agentacct 的這一部分不能只用功能清單理解。README 明確提到的 `agentacct stop`、`agentacct tui`、`≈`，應與本節描述的輸入、輸出或操作順序一起閱讀。這使文章的判斷落在 mikehasa/agentacct 的實際介面上，而不是套用其他工具的經驗。（agentacct 第3節核對）
在 agentacct 的使用情境中，取捨取決於既有環境是否符合 README 寫出的條件。若要核對本節，應直接查看 mikehasa/agentacct 的 README 與相關設定；有命令時照命令執行，有版本或平台限制時保留原文限制，不能把未說明的行為當成保證。（agentacct 第3節核對）
用 pipx 安裝並執行 onboard
需要 Python >= 3.11，macOS 或 Linux，Windows 僅透過 WSL 支援。用 `pipx install agentacct` 安裝，然後每台機器執行一次 `agentacct onboard`。Onboard 偵測本地編碼代理日誌，設定全域儲存，執行首次使用同步，並可選地啟動一個瀏覽器儀表板在 http://127.0.0.1:8765。您必須在 onboarding 之後開啟一個新的代理會話，因為 MCP 伺服器和鉤子在會話開始時綁定，所以 onboarding 會話不能成為第一個記錄的任務。對於每個儲存庫安裝，使用 `agentacct onboard --scope project`。`agentacct demo` 執行一個安全的本地演練，使用一次性儲存。受管執行時間透過 `agentacct start`、`status`、`stop`、`repair` 控制。（agentacct 第4節核對）
agentacct 的這一部分不能只用功能清單理解。README 明確提到的 `agentacct tui`、`≈`、`$`，應與本節描述的輸入、輸出或操作順序一起閱讀。這使文章的判斷落在 mikehasa/agentacct 的實際介面上，而不是套用其他工具的經驗。（agentacct 第4節核對）
在 agentacct 的使用情境中，取捨取決於既有環境是否符合 README 寫出的條件。若要核對本節，應直接查看 mikehasa/agentacct 的 README 與相關設定；有命令時照命令執行，有版本或平台限制時保留原文限制，不能把未說明的行為當成保證。（agentacct 第4節核對）
誠實限制和標記的估算
agentacct 是早期 alpha，寧願顯示缺口也不猜測。沒有託管儀表板，沒有電話回傳遙測，沒有自動雲帳戶同步。它可以在您顯式將 OTLP 匯出器指向它時本地接收遙測。成本來自本地定價表的估算，絕不是發票。它只讀取偵測到的用戶端的本地會話檔案，從不監視在 agentacct/integrations 之外啟動的無關程序。硬停止僅適用於 agentacct 自己啟動的執行或選擇加入的代理路徑。支援是按能力而非按標誌。Claude Code 和 Codex 今天有即時觀察的使用路徑；其他用戶端（Hermes、OpenCode、OpenClaw、Cursor）有更窄、明確範圍路徑。每週 Claude 計畫估算是 beta 版，只有當它從您自己的記錄限制歷史中校準到您的帳戶時才顯示數字。（agentacct 第5節核對）
agentacct 的這一部分不能只用功能清單理解。README 明確提到的 `≈`、`$`、`agentacct receipt <task>`，應與本節描述的輸入、輸出或操作順序一起閱讀。這使文章的判斷落在 mikehasa/agentacct 的實際介面上，而不是套用其他工具的經驗。（agentacct 第5節核對）
在 agentacct 的使用情境中，取捨取決於既有環境是否符合 README 寫出的條件。若要核對本節，應直接查看 mikehasa/agentacct 的 README 與相關設定；有命令時照命令執行，有版本或平台限制時保留原文限制，不能把未說明的行為當成保證。（agentacct 第5節核對）
Alpha 狀態、文件和貢獻
介面在 alpha 期間可能會變化。儲存庫包含廣泛的文件：參考、安裝手冊、使用和成本真相表、編碼代理整合、架構、隱私威脅模型、安全邊界、完整示範、即時煙霧證據、公共 alpha 檢查清單。開發在 CONTRIBUTING.md 中介紹。從複製執行測試用 pytest；pipx 安裝不附帶測試工具。回饋請求包括您使用哪個代理，您遇到了什麼失控或成本問題，哪個連線/歸因結果看起來錯誤，以及接下來應支援哪個整合。開啟 issue，分享前請清除日誌中的任何提供者 API 金鑰或私有路徑。（agentacct 第6節核對）
agentacct 的這一部分不能只用功能清單理解。README 明確提到的 `$`、`agentacct receipt <task>`、`in progress`，應與本節描述的輸入、輸出或操作順序一起閱讀。這使文章的判斷落在 mikehasa/agentacct 的實際介面上，而不是套用其他工具的經驗。（agentacct 第6節核對）
在 agentacct 的使用情境中，取捨取決於既有環境是否符合 README 寫出的條件。若要核對本節，應直接查看 mikehasa/agentacct 的 README 與相關設定；有命令時照命令執行，有版本或平台限制時保留原文限制，不能把未說明的行為當成保證。（agentacct 第6節核對）
編輯結論
agentacct 適合需要 README 所述功能，且能接受其語言、平台與部署條件的使用者；不適合把專案描述當成已驗證效能或收益承諾的人。採用前先依 mikehasa/agentacct README 中的具體入口核對 agentacct 的安裝、主要操作與失敗回應，並確認授權條款符合你的發佈方式。
社群筆記