會不會停掉我正在做的事？

你一回話，計數就歸零，所以你在旁邊看著、一來一回改東西時很難碰到門檻。真的誤擋了，停下的訊息裡有一行暫停指令（預設暫停 1 小時），網站上也可以標成誤擋，不算進估計省下的金額。

Budgethelm 要收費嗎？

現在免費，註冊就能使用。Pro 定價每月 1.99 美元，付款即將開放，開放前帳號都是免費的；Team 方案價格還沒定。選模型和算成本兩個工具不用註冊。

不想跑 curl | sh 怎麼辦？

可以先打開 install.sh 看內容再跑；整份腳本包在一個函式裡最後才執行，下載到一半斷線不會只跑半份。也可以不裝，改用 MCP 健檢：在 Claude Code、Cursor 或 Codex 加上 Budgethelm，對 agent 說「用 Budgethelm 幫我健檢」，同意後才上傳用量。

Budgethelm 會不會經手我的 API 呼叫？

不會。Budgethelm 不代打模型、不轉賣 token，只收時間、模型、token 數這類用量紀錄。

花費金額準確嗎？

有回報 cost_usd 的呼叫照實加總；沒回報的，依你填的模型費率或內建價目估算並標示為估算。估算不是帳單，請以模型廠商的帳單為準。

AI agent 卡住空轉時，自動幫你停下來

一行指令裝好。agent 一直出錯、重跑同一個指令時，Budgethelm 會在它燒掉更多 token 之前停下它。你睡覺、跑 claude -p 或排程的時候也一樣。

Mac／Linuxcurl -fsSL https://agentops.agentops.workers.dev/install.sh | sh

Windows (PowerShell)irm https://agentops.agentops.workers.dev/install.ps1 | iex

瀏覽器會打開一次，登入或註冊後按「授權」就裝好了。免費，不用信用卡，不拿你的模型金鑰。

免費註冊先看會動到什麼

同一個卡住的 agent，裝前裝後

測法：真的 CLI 接本機的假模型，讓 agent 每一步都拿到同一個錯誤、一直重試，數它打了幾次模型才停。不花錢，2026 年 11 月在 Mac 上跑；Codex 另外在 Windows 上跑過。

工具	沒裝 Budgethelm	裝了之後
Claude Code（claude -p）	打了 60 次，撞到 --max-turns 60 才停	第 6 次停下
Codex（codex exec）	8 秒打了約 170 次	1.7 秒停下
Gemini CLI（gemini -p）	10 秒打了 31 次	0.7 秒停下
GitHub Copilot CLI（copilot -p）	10 秒打了 866 次	2.3 秒停下

什麼時候會停

連續失敗 8 次，或同一個錯誤出現 5 次（第 3 次先提醒 agent 換個做法）
同一個指令重跑 10 次，或你上次回話後累計失敗 25 次、工具呼叫 500 次
Claude Code 最近 5 分鐘的 token 用量超過你平常的 6 倍而且超過 20 萬（照你自己過去 14 天的紀錄算）

你一回話，計數就歸零。停下的訊息裡附一行暫停指令，真的要它繼續跑就暫停 1 小時；門檻可以調，也可以整個關掉。Codex 這類 hook 不一定會跑的工具，改由背景程式讀它的紀錄來停。

跟 Claude Code 內建的 /usage 差在哪

	Claude Code 的 /usage	Budgethelm
看哪些工具	Claude Code	Claude Code、Codex、Gemini CLI、Copilot CLI、Cline 等
看哪幾台電腦	這一台的本機紀錄	每一台裝了的電腦，一起看
agent 卡住時	事後打開來查	當下停下它，跳系統通知

/usage 的範圍依 Claude Code 官方文件：數字來自這台電腦的本機紀錄，不含其他裝置。只在一台電腦用 Claude Code 的話，/usage 可能就夠了。

裝了會動到你電腦的什麼

程式放在 ~/.agentops（Windows 是 %USERPROFILE%\.agentops）。沒有 Node 18 以上時，會下載官方可攜版放在這裡並核對 SHA-256，不動系統的 Node 和 PATH。
在偵測到的工具裡加守護 hook 和 MCP 設定，例如 ~/.claude/settings.json、~/.codex/hooks.json、~/.cursor/hooks.json、~/.gemini/settings.json。原本的設定都保留。
開機自動執行：macOS 用 LaunchAgent，Linux 用 systemd 使用者計時器，Windows 用工作排程。不用系統管理員權限。
上傳的只有時間、工具、模型、token 數和停下紀錄（原因和次數）。對話、程式碼和 API key 不會離開你的電腦；設定檔資安掃描只傳問題類型、檔名和行號，不傳金鑰的值。
移除：Mac 在個人「應用程式」資料夾（~/Applications）點兩下「Budgethelm 解除安裝」（較早裝的，點同一個資料夾裡檔名有「解除安裝」的那個）；Linux 跑 sh ~/.agentops/uninstall.sh；Windows 點兩下 %USERPROFILE%\.agentops\uninstall.cmd。

裝好之後也看得到

花費：按專案、agent、模型拆開看 token、成本、錯誤率，月預算提醒。成本監控怎麼運作
浪費：重複塞上下文、沒用提示快取、輸出過長、簡單任務用了貴模型，試算換模型每月能省多少。Claude Code 省錢
資安：AGENTS.md、CLAUDE.md、MCP 設定裡藏起來的指令和寫死的金鑰。安全掃描
選模型、算成本：不用註冊，2,961 筆模型價格照每月費用排好。模型價格比較・費用試算

方案

免費（現在）：所有功能都能用，註冊就好。付費方案推出前，帳號都是免費的。
Pro：每月 1.99 美元（即將開放付款）：給重度使用的個人。規劃中：接更多台電腦、用量紀錄保留更久。付款開放前不會收費，也不用先留卡號。
Team（即將推出）：給團隊。規劃中：多人共用專案、權限管理。

Budgethelm 不做的事

不代打模型、不轉賣 token：你的 agent 照原本的方式呼叫模型。
不拿你的模型金鑰：AI 工具連 MCP 用的是 Budgethelm 自己的權杖，可以隨時撤銷。
熔斷只看次數和 token 速率，不看金額；不替你換模型，省錢試算只給建議。
還沒有 Email／Slack 即時通知，停下時只跳這台電腦的系統通知。

常見問題

會不會停掉我正在做的事？: 你一回話，計數就歸零，所以你在旁邊看著、一來一回改東西時很難碰到門檻。真的誤擋了，停下的訊息裡有一行暫停指令（預設暫停 1 小時），網站上也可以標成誤擋，不算進估計省下的金額。
Budgethelm 要收費嗎？: 現在免費，註冊就能使用。Pro 定價每月 1.99 美元，付款即將開放，開放前帳號都是免費的；Team 方案價格還沒定。選模型和算成本兩個工具不用註冊。
不想跑 curl | sh 怎麼辦？: 可以先打開 install.sh 看內容再跑；整份腳本包在一個函式裡最後才執行，下載到一半斷線不會只跑半份。也可以不裝，改用 MCP 健檢：在 Claude Code、Cursor 或 Codex 加上 Budgethelm，對 agent 說「用 Budgethelm 幫我健檢」，同意後才上傳用量。
Budgethelm 會不會經手我的 API 呼叫？: 不會。Budgethelm 不代打模型、不轉賣 token，只收時間、模型、token 數這類用量紀錄。
花費金額準確嗎？: 有回報 cost_usd 的呼叫照實加總；沒回報的，依你填的模型費率或內建價目估算並標示為估算。估算不是帳單，請以模型廠商的帳單為準。