Masko for Claude Code

Masko for Claude Code 是什麼？

Masko for Claude Code 是一款免費、開源的 macOS 桌面夥伴，在 Claude Code 工作階段旁顯示動態吉祥物覆蓋層。它即時追蹤工作階段活動，當 Claude 需要權限或注意時浮現，讓您無需切換編碼工作流程即可批准或拒絕動作。

應用程式以輕量覆蓋視窗運行，為每個 Claude 工作階段提供可觀察性儀表板——顯示工作階段狀態、活動饋送和權限提示——透過 Claude Code 的鉤子系統保持一切本地化。

主要功能

• Claude Code 的 macOS 覆蓋吉祥物：吉祥物浮動於其他視窗上方，並根據目前工作階段狀態更新（例如閒置、工作中、需要注意）。
• 即時權限處理：當 Claude 要求執行指令時，覆蓋層提供鍵盤允許/拒絕流程，而非滑鼠切換。
• 通知儀表板：儀表板顯示工作階段快照（例如執行中/等待輸入/壓縮中）、顏色編碼事件饋送和工作階段摘要。
• 子代理追蹤：即時監控子代理，讓您了解主要工作階段之外的動態。
• 鍵盤優先工作階段控制：包含切換工作階段、跳轉至執行 Claude Code 的終端機分頁，以及確認權限動作的快捷鍵。
• 本地優先行為：應用程式使用 Claude Code 的鉤子系統接收事件中繼資料（工具名稱和工作階段狀態），但不讀取您的程式碼；本地運行，不傳送程式碼至伺服器。

如何使用 Masko for Claude Code

1. 在 macOS 下載並安裝：透過提供的 macOS DMG 安裝應用程式；應用程式駐留於選單列，而非雜亂 Dock。
2. 首次授予無障礙權限：首次啟動時，應用程式自動安裝 Claude Code 鉤子，並需無障礙權限以支援覆蓋層。
3. 啟動 Claude Code：開啟終端機正常執行 Claude Code，讓應用程式觀察工作階段。
4. 從覆蓋層互動：當出現提示（例如 Claude 要執行指令或提問）時，使用鍵盤快捷鍵批准/拒絕並聚焦正確終端機分頁。
5. 選擇吉祥物：預設使用六款內建吉祥物，或從 masko.ai 載入自訂吉祥物至桌面應用程式。

使用情境

• 無需切換上下文批准 Claude Code 指令：當 Claude 請求執行某事（例如建置指令）時，覆蓋層呈現允許/拒絕動作，讓您快速從鍵盤確認。
• 追蹤多個工作階段的 Claude 動態：透過工作階段切換器和工作階段專屬終端機跳轉，管理多個 Claude 工作階段並移至每個工作階段對應的確切終端機分頁。
• 檢視工作階段活動與工具呼叫：使用通知儀表板檢查有序事件（工具呼叫與完成），了解工作階段隨時間變更。
• 處理「等待輸入」時刻：當工作階段顯示等待輸入時，儀表板與通知協助辨識該狀態並及時回應。
• 追蹤依賴子代理的代理活動：若工作流程觸發子代理，子代理追蹤即時顯示這些活動，讓您追蹤完整執行路徑。

常見問題

Masko for Claude Code 免費嗎？
是。桌面夥伴免費且開源，採用 MIT 授權。

Masko 需要伺服器或 API 金鑰嗎？
不需要。提供的資訊指出無設定檔、無伺服器、無 API 金鑰，一切本地運行。

Masko 收集什麼？會讀取我的程式碼嗎？
Masko 使用 Claude Code 的鉤子系統，接收事件中繼資料如工具名稱和工作階段狀態。它不讀取您的程式碼。

吉祥物如何運作？
應用程式預設包含六款吉祥物。您也可從 masko.ai 設計或匯入自訂吉祥物至桌面應用程式。

Masko 能幫我跳轉至正確終端機嗎？
能。覆蓋層提供快捷鍵即時聚焦執行 Claude Code 的終端機分頁，並支援頁面提及的終端機與編輯器（例如 iTerm2、Terminal.app、VS Code、Ghostty）。

替代方案

• 終端機/編輯器原生方式（無覆蓋層）：依賴 Claude Code 在終端機或 IDE 內的提示，就地回應。這與使用常駐覆蓋層和儀表板不同，需要切換注意力。
• 通用 macOS 通知/自動化工具：使用通知路由或鍵盤自動化來突顯提示和動作。這更通用，可能無法提供 Claude Code 專屬的會話可觀察性或吉祥物狀態。
• 其他開發者生產力覆蓋層：尋找提供會話追蹤和開發工作流程快速導航的工具。這些通常聚焦程式碼導航或聊天記錄，而非 Claude Code 權限提示和會話事件饋送。
• 純 CLI 工作流程搭配手動權限檢查：從命令列操作 Claude Code，並在執行前手動審核指令。這提供最大簡易性，但缺少即時儀表板可見度和覆蓋層的一鍵/鍵盤核准。