clauditor 是什麼?防止 Claude Code 長 session 過度消耗 token 的守門工具
編輯:BJ最後檢查:2026-05-04主要來源:GitHub
用中文白話介紹 clauditor 如何監控 Claude Code 長 session 的 token 浪費、何時提醒換新 session、適合誰使用,以及安裝與風險提醒。
先講使用情境
你用 Claude Code 做一件大事,原本只是修一個功能,後來一路改檔、跑測試、修錯誤、再討論架構。幾十輪後你覺得還在同一個任務裡,但 Claude Code 每次回合要帶著越來越長的對話脈絡,session 可能變得很重。
clauditor 想解決的不是「Claude 回答太長」,而是「長 session 變胖後,每一輪都可能用掉更多 quota」。它像一個 session 守門員,提醒你該保存交接摘要、開新 session 接著做,而不是在同一段對話裡硬撐到底。
它實際在做什麼?
clauditor 官方 README 的說法是:Claude Code session 會在每一輪帶上整段 conversation history,因此 session 越長,每一輪傳送的上下文也越大。換成白話:你每講一句新的話,Claude 都要把前面整段對話再讀一次,才能回你這一句;對話越長,每一輪要重讀的東西就越多。clauditor 會監控 session 大小和 waste factor,當它判斷你正在用高浪費倍數繼續工作時,就阻擋這一輪,並保存目前進度,讓你用新的 Claude Code session 接續。
白話說,它不是幫你省掉所有 token,也不是讓 Claude Code 變便宜,而是提醒你不要讓一個 session 拖到太肥。你可以把它想成長工時工作中的「交班提醒」:現在該寫交接單,換下一班繼續,不要讓同一班一路燒到崩潰。
新手第一步該怎麼試?
不要一開始就在正式專案上裝。先找一個低風險的小專案,跑一次完整流程:寫到一半被提醒換 session、看它幫你存了什麼交接訊息、開新 session 把訊息讀回來、繼續做下去。
先確認三件事:
- 它在什麼情況下會打斷你
- 被打斷時你正在做的事情有沒有完整保留
- 換到新 session 後,能不能直接接著做,還是要回頭重講
如果這三件事都順,再放進你日常的開發流程。安裝方式和支援平台請直接看官方 repo,那裡會是最新的。
下載與價格
clauditor 是 GitHub 上的開源工具,免費,使用授權是 MIT。它本身不收錢,但你要先有 Claude Code 才用得上它,所以實際成本還是看你 Claude Code 的方案。
它不會要你自己去申請任何 API Key,也不用裝 Docker。真正要考慮的是:它會在你的電腦上接管 Claude Code 的部分流程,會自動寫一些設定檔和交接檔。如果是公司電腦或正式專案,最好先問過團隊再裝。
什麼情況值得裝?
如果你只是偶爾用 Claude Code 問幾題,先不用裝。clauditor 適合三種人:
- 一個 Claude Code session 常常一開就好幾小時的人
- 常被額度或 session 大小限制打斷、回頭發現進度沒存好的人
- 希望每次中斷都有交接訊息可以接續、不想靠自己回想進度的人
如果你只是用 Claude 網頁版聊天,或者每次用 Claude Code 都是短任務,clauditor 對你太重。它也不會幫你檢查程式碼對不對、不能取代測試,估出來的浪費倍數也只是參考,不是 Anthropic 給的正式帳單。它能做的只有一件事:看到對話拖太久就提醒你該換一個新對話來繼續工作。
風險與注意事項
clauditor 不是只在旁邊看,它會主動介入你和 Claude Code 的互動。你送一句話、Claude 跑一個工具、開始一段新對話,它都可能在中間插手判斷要不要擋下來。這就是它的價值,但你要知道會發生什麼:
第一,它會在某些時候直接打斷你。被打斷時你正在做的事情會中斷,要等它幫你存好交接訊息、再開一個新 session 才能繼續。所以不要在重要正式專案直接裝,先用小專案試一次完整流程,看交接訊息夠不夠你接續工作。
第二,它估的「浪費倍數」只是它自己的估算,不是 Anthropic 給的正式帳單。不要拿這個數字去算錢,當它是個提醒你「該換 session 了」的訊號就好。
第三,它只能配合電腦上裝的 Claude Code 用,不支援網頁版。如果你都是直接開瀏覽器用 Claude,這個工具對你沒幫助。
最後給你的建議
如果你常常一個 Claude Code session 開好幾小時、會有「明明還在同一件事為什麼這麼慢這麼貴」的感覺,clauditor 值得花一個下午試。
第一次用,建議照這個順序:找一個小專案 → 故意把 session 開久一點等它跳出來打斷 → 看它幫你存了什麼交接訊息 → 開新 session 把訊息讀進來 → 確認你能順利接續。整條路順了,再放進你的日常工作。
如果中間任何一步覺得「交接訊息不夠我接續」,那就先別裝在正式專案上,回頭看怎麼讓自己的工作習慣更好交接,再決定要不要靠工具。
資料來源
本文依 clauditor 官方 GitHub repo、README、license 與安裝說明整理。實際支援平台、hook 行為、版本限制與使用方式仍以官方 repo 為準。
- https://github.com/IyadhKhalfallah/clauditor
- https://github.com/IyadhKhalfallah/clauditor/blob/main/README.md
- https://github.com/IyadhKhalfallah/clauditor/blob/main/LICENSE
- https://docs.anthropic.com/en/docs/claude-code/hooks
延伸閱讀
用中文白話介紹 claude-token-efficient 如何用短版 CLAUDE.md 控制 Claude Code 回覆長度、什麼情況有效、什麼情況不適合,以及使用前的限制。
Claude / Codex Skills 是什麼?AI Agent 技能包的功能、限制與新手使用建議用中文白話整理 Claude / Codex Skills 與 Agent Skills 生態,說明它適合誰、風險在哪、和 MCP、CLAUDE.md、n8n 有什麼差異。
Codex 桌面版是什麼?OpenAI coding agent 如何協助規劃、改碼、測試與送出變更用中文白話介紹 Codex App 的用途、適合對象、下載與價格、和 Codex CLI / IDE extension / Web 的差異,以及使用 coding agent 前要注意的資料、權限與改碼風險。
Hermes Agent 是什麼?開源自我學習 AI Agent 的功能、限制與使用建議用中文白話介紹 Nous Research 的 Hermes Agent:它和一般聊天機器人、AI coding agent 有什麼不同,適合誰、風險在哪、新手該不該現在就用。
ComfyUI 是什麼?節點式 AI 圖像與影片工作流工具的功能、限制與新手使用建議用中文白話整理 ComfyUI 的功能、適合對象、硬體需求、使用限制、風險提醒與替代工具,幫助創作者判斷是否值得使用。
Prompt Optimizer 是什麼?功能、限制、適合對象與新手使用建議用中文白話整理 Prompt Optimizer 的功能、適合對象、使用限制、風險提醒與替代工具,幫助非工程師判斷是否值得使用。