Pushary 教學：繁中完整上手指南（功能、方案、試用）

透過這篇 Pushary 教學，你會學到如何在手機上批准 AI 代理的操作請求，讓 Claude Code、Cursor 這類工具在你離開電腦時也能繼續完成任務。Pushary 是什麼，一句話就能講完：它是解決「AI 卡在等你確認」這個問題的通知與審核中樞。

查看相關日報

當你把任務交給 AI 代理，程式跑到一半需要確認某個危險操作時，整個流程就會卡住，等著你回到電腦前手動確認。Pushary 想解決的正是這件事：代理遇到需要你判斷的步驟時，它把問題送到你的手機、Mac、Slack 或網頁版，你點一下 Approve，任務就繼續跑。

對開發者來說，Pushary 怎麼用 的核心價值在於「不用一直盯著螢幕」。這篇文章會拆解 Pushary 的運作方式、方案與試用條件，以及怎麼用一行指令把它接進你的開發環境。無論你用的是 Claude Code、Codex、Cursor 還是 Hermes，這篇都會給你一套完整的 Pushary 中文 操作指南。

Pushary 是什麼？核心概念與價值

AI 代理已經能處理從寫程式碼到管理伺服器的任務，但執行過程中總會遇到需要人類判斷的「決策點」：要不要刪除這個檔案？要不要部署？要不要跑一個沒測試過的腳本？

官網用一個時間軸說明沒有 Pushary 的情況：9:12 把長任務交給代理後離開，9:14 代理遇到不該自己決定的步驟就停下來等，9:51 你回來時，它已經原地等了 37 分鐘。有了 Pushary，9:14 手機就會震動，你按下同意，回來時任務早已跑完。

官網對自己的定義是「AI 代理的控制面板」：代理需要你同意時，Pushary 把問題送到你的手機、Mac、Slack 或網頁版，你批准或拒絕，每一次回答都會被記錄下來。官網列出支援的代理包括 Claude Code、Codex、Cursor、Hermes、Gemini CLI，以及任何支援 MCP（Model Context Protocol）的代理。

價值大致落在三點：

• 即時：代理一遇到需要你的步驟，手機就會收到推播，不用等任務結束才發現卡住。
• 只送決策，不送程式碼：官網 FAQ 說明，一般產品流程只傳送通知的中繼資料（標題、內文、工具名稱），不是你的程式碼庫。
• 規則分級：低風險、可復原的步驟可以設成自動通過；刪除、部署、花錢這類無法復原的動作才送到手機給你決定。

事前準備：方案與試用條件

開始 Pushary 怎麼用 之前，先把方案看清楚。官方 Pricing and limits 文件寫得很直接：給 AI 代理用的方案沒有免費版，每個方案都從同樣的 3 天試用開始，開始試用需要綁定信用卡。

幾個容易忽略的細節：

• 試用規則：試用期一開始就能用完整方案；3 天結束時若沒有取消，會由 Stripe 從你的卡片扣款。每個工作區只能試用一次。
• Kill Switch 每個方案都有：可以從網頁後台、手機 App、Mac App 或決策頁直接停下代理。
• 稽核紀錄有差別：Agent 方案在後台只顯示最近 100 筆；可篩選的完整稽核表、CSV／JSON 匯出與預算功能需要 Agent Pro 或 Team。
• Slack：Agent 與 Agent Pro 是傳私訊給你，Team 可以送到共用頻道。

支援裝置

官網列出 iPhone、Android、Mac、Windows、Linux。手機端可以裝 App，也可以用瀏覽器接收；Mac 另有內建在方案裡的 Mac App（Pushary Isle），問題會出現在螢幕瀏海區域。記得在手機上允許 Pushary 的通知權限，免得錯過請求。

Step 1：用一行指令完成安裝

官方設定指令是：

npx pushary@latest setup

Windows PowerShell 則用 npx.cmd pushary@latest setup。官方文件註明 CLI 需要 Node.js 20.17+、22.13+ 或 23.5+。

以 Claude Code 為例，官方流程是四步：

1. 掃描 QR Code：指令執行後先顯示 QR Code，用手機相機或 Pushary App 掃描，登入或建立帳號，確認手機上的代碼和終端機一致，再按下 Approve 並允許通知。新帳號會在這一步開始 3 天試用。
2. 選擇代理：設定精靈會問「Which agents do you use?」，並預先勾選它在你電腦上找到的代理。保留 Claude Code 即可。
3. 回答測試問題：精靈會先送一則測試推播，再送一則測試問題。你在手機上回答後，終端機會顯示 You're set。
4. 重新啟動 Claude Code：Claude Code 在啟動時才讀取 hooks，所以要關掉所有開著的工作階段再重開。

這個指令會修改幾個檔案：~/.claude.json 加入 Pushary 的 MCP 伺服器，~/.claude/settings.json 加入 Pushary 的 hooks，並把 API 金鑰寫進 ~/.pushary/config.json 與你的 shell 設定檔。只有在你同意時，才會在目前資料夾的 CLAUDE.md 加一段說明。包含 API 金鑰的設定檔不要上傳到公開的 GitHub 倉庫。

想確認有沒有裝好，可以跑官方的檢查指令 npx pushary@latest doctor，它會檢查金鑰、方案、MCP 伺服器與 hooks，並送出一則真的測試推播。

Step 2：第一次真的批准

官方文件建議的測試方式很簡單：

1. 新工作區預設是 Always，代表你坐在電腦前時，問題也會送到手機。
2. 在 Claude Code 輸入「Create a file called pushary-test.txt that says hello.」
3. 手機會收到一則 Write 請求，按 Approve，檔案就會出現。
4. 測完之後，把設定切回 When away，平常在電腦前時就留在 Claude Code 自己的提示裡回答。

哪些動作會被攔下來

依官方說明，在 Claude Code 的預設模式下，執行 shell 指令（Bash、PowerShell）與修改檔案（Write、Edit 等）之前都會先等你同意；Claude 主動問你的問題與計畫審核，在每一種權限模式下都會送出。其他工具（例如讀檔、抓網頁）只有在 Claude Code 自己要跳出權限提示時才會轉到手機。

你沒回應時會怎樣

每條規則都有等待時間和「If you don't respond」的處理方式。新工作區的預設是：所有工具等 60 秒，沒回應就交回終端機（Ask in terminal），由 Claude Code 自己的提示處理，所以不會有動作在沒人回答的情況下執行。其他可選的處理方式有 Auto approve、Auto deny 與 Wait for phone。新版 CLI（1.9.66 起）在預設模式下，終端機與手機可同時回答，先回答的生效；沒人回答時動作維持待決，不會自動放行。

問題的形式

官網列出三種：確認（是／否）、選擇（2 到 6 個選項）與輸入（自由文字）。代理會依情況選擇合適的形式。

Step 3：進階設定與最佳實踐

權限規則

在後台的 policies 頁面可以為單一工具寫規則，例如讓 Bash 等 60 秒後自動拒絕、讓 Read 直接通過。針對單一工具的規則優先於全部工具（*）的規則。

搭配 --dangerously-skip-permissions

官方文件說明，用 claude --dangerously-skip-permissions 啟動 Claude Code 時，Claude Code 本身不再詢問，但 Pushary 的 hooks 仍然會執行：危險指令與檔案修改依然會等你的手機回覆，Kill Switch 也照樣有效。

多代理與團隊

同一個後台可以看到每個代理目前是否在等你。需要多人共用紀錄或把審核轉給特定同事的團隊，Team 方案才有共用稽核紀錄與把審核轉給同事或特定角色的功能。

最佳實踐

定期看稽核紀錄，確認自動通過的規則沒有放得太寬；部署、刪除這類無法復原的動作，規則一律設成送到手機；長時間無人看管的任務，先確認自己知道 Kill Switch 在哪裡。

常見問題 FAQ

Pushary 有免費方案嗎？

沒有。官方 Pricing and limits 文件寫明，給 AI 代理用的方案沒有免費版，每個方案都從 3 天試用開始，開始試用需要信用卡。最便宜的 Agent 方案每月 9.99 美元，含每月 5,000 則通知與 30 天紀錄保存；試用結束若未取消，第 3 天結束時開始扣款。

Pushary 會把我的程式碼傳到它的伺服器嗎？

官網 FAQ 說明，一般產品流程不會。審核流程傳送的是通知的中繼資料，也就是標題、內文與工具名稱。由 Pushary 啟動的對話紀錄會在本機遮罩並加密，只有獲授權的合規管理員依法定義務才能還原。

設定好了卻收不到通知，該怎麼排查？

先執行官方的 npx pushary@latest doctor，它會檢查金鑰、方案、MCP 伺服器與 hooks，並送一則真的測試推播。接著確認改完設定後有重新啟動 Claude Code，以及手機有允許 Pushary 的通知。如果你在電腦前收不到，檢查審核模式是不是 When away，這個模式下問題會留在 Claude Code 自己的提示裡。

免責聲明：本文依官方公開資料整理撰寫，非合作推廣。