你對著 Mac 說「開計算機」,程式真的打開了;接著說「把這段話整理成三點」,助手又給了答案。這篇 Atticus 教學要帶你分清:兩次看起來都是說話做事,背後走的路、送出的資料和消耗的額度,可能完全不同。
專為第一次接觸桌面 AI 助手的讀者寫。你會學會準備環境、用三種小任務辨認本機指令、模型判斷與快捷重播,再檢查取消、記憶和撤權。這裡的 Atticus 是 SaarthurR 的 atticus-mac,可從 官方程式庫核對身分。
查核截至 2026 年 10 月 15 日,操作依據固定在 031f0d6 版本。以下是文件與原始碼導向的上手及驗收方法,未執行原生語音、桌面控制或 Claude 帳號測試。尤其這版語音模組明確指定 en-US;繁中需求先用文字輸入驗收,不把 Mac 系統支援中文直接推成 Atticus 已通過繁中語音驗收。
先說結論:Atticus 教學先記住「三條路、兩張帳」
Atticus=本機聽寫+指令分流+桌面操作;模型用量與資料去向分開記。像一位接電話的助理:熟悉的小事自己做,新問題請外援,做過的固定動作則翻出便條照著走。接電話在家裡,不代表整件工作都留在家裡。
- 先用可回復、沒有私人資料的動作開始,例如開啟 Calculator。
- 本機即時指令、穩定快捷重播、模型處理是三條不同路;重複一句話不保證一定命中重播。
- 保留 Safe mode,首次練習關閉邊說邊做、預先思考、畫面與選取文字的自動附帶。
- 軟體在此固定版本免費;Claude 訂閱、可用量與額外付費是另外一張帳。
原理:為什麼本機聽寫不等於整個助手離線?
語音辨識負責把聲音寫成字;模型負責理解較複雜的要求;執行層負責開視窗、找資料或操作按鈕。你可以把它們想成耳朵、判斷和雙手。想先補上這個分工,可讀 AI Agent Harness 白話原理。
固定版的 語音模組使用 Apple 的 SpeechAnalyzer,並把 SpeechTranscriber 與 DictationTranscriber 都設成 en-US。這是本篇對語言能力的證據範圍;我們未量到繁中辨識準確率。語音稿若把日期或否定詞聽錯,下游動作就可能跟著錯。
較複雜的請求會經 原始碼中的 Claude Code 呼叫交給 claude -p。Anthropic 的 程式化執行文件說明 -p 是非互動式呼叫。這裡「本機執行 Claude Code」與「模型推論在本機」要分開理解。
資料也不只包含你講的那句話。原始碼會組合適用的規則、個人資料、選取文字、視窗文字,並依任務決定畫面圖片。因此本機語音、模型請求、遙測三條資料流要各自檢查。關閉圖片仍要另外檢查文字與記憶。

Atticus 教學上手:六步完成一輪小任務
①「先認門牌」:核對環境與版本
怕裝錯同名軟體?先確認程式庫擁有者是 SaarthurR,名稱是 atticus-mac。官方安裝要求 macOS 26 以上、Apple 命令列工具,以及你選用的 AI 用戶端。走本文 Claude 路線時,先在官方 Claude Code 完成自己的帳號登入。
sw_vers -productVersion
xcode-select -p
claude auth status
第一行看系統版本,第二行看開發工具位置,第三行看 Claude Code 的登入狀態;不要把登入輸出貼到公開討論。如果第二行報錯,才執行 xcode-select --install 並完成 Apple 的安裝視窗;若找不到 Claude,先照 官方安裝文件安裝。
為了讓下文與原始碼對得上,使用固定 commit。下列路線供尚未安裝、家目錄沒有 .atticus 資料夾的讀者;已有安裝就先查版本,別覆蓋自己的檔案。前三行取得並固定原始碼,最後一行才開始建置。
git clone https://github.com/SaarthurR/atticus-mac.git "$HOME/.atticus"
git -C "$HOME/.atticus" checkout 031f0d665b2e8844bf4f7a9209c7a30d48fdb64a
git -C "$HOME/.atticus" rev-parse HEAD
bash "$HOME/.atticus/build.sh"
這不是單純把圖示拖進資料夾。建置腳本會建立 ~/Applications/Atticus.app、登入啟動項目,並嘗試建立名為 Atticus Local Signing 的本機簽署身分。先讀過腳本再執行;出現權限問題就保存錯誤,不用關閉系統保護來硬裝。首跑後到 Settings → About & Updates 暫停自動更新,記下完整 commit,讓這輪驗收保持同版。
②「先縮小雙手的範圍」:再開第一個視窗
怕一句話還沒講完就動作?在 Settings → Intelligence 保留 Instant commands 與 Learn commands,先關閉 Act while I’m talking、Start while I’m talking。前者允許支援的即時指令在句中執行;後者讓模型提早開始思考,兩者不是同一個開關。
到 Screen & Windows 把 Look at my screen 設為 Never,關閉 Include selected text,讓 Drafts at my cursor 保持 Ask first。到 Account & Access 確認 Safe mode 開啟;這輪先關閉 Count me as a user 與 Help improve Atticus,避免把遙測混進資料流觀察。

macOS 的麥克風、輔助使用、螢幕錄影與個別 App 自動化是不同權限。先只開當前練習需要的項目;不要在 Apps 頁面一次批准所有應用程式。走文字輸入和開 App 練習時,也不用為了讓每一列變綠就開啟全部權限。
③「先走近路」:用 Calculator 認本機即時指令
先在輸入框打 Open Calculator,送出後確認是計算機程式出現。再把它關閉,用同樣文字做第二次。到 Settings → Usage → Ask log → Open 看該次紀錄;把輸入、即時指令標示、結果與完整等待時間寫在筆記。
英文例句是為了貼近內建規則與目前語音設定。之後若要試語音,按住 Control+Option+Space 說相同英文,放開送出;先核對辨識文字,再對照文字輸入那一輪。不要從「App 開了」直接推算整個語音流程耗時。
④「再請外援」:只摘要你親手編的假資料
新手最容易一次交出太多內容。這次保持畫面與選取文字附帶關閉,直接把假資料貼進輸入框:請只根據以下文字整理三點:測試活動在 10 月 22 日下午三點,預算 300 元;先準備紙張,再確認場地。不要新增日期或金額。 這是練習材料,不是真實行程。
這輪讓模型理解文字。核對三件事:三點是否忠於材料、日期金額是否保留、紀錄是否顯示模型用量。不要要求它同時讀私人行事曆、寄信或付款。用同一段繁中文字重跑,可以驗的是文字任務,不能拿來證明繁中語音辨識。
⑤「看看便條有沒有用」:同一個組合動作再做一次
先記下 Memory 中既有快捷,輸入 Open Calculator and Chess。完成後查 Settings → Memory → Saved commands and procedures 是否增加項目;關閉剛開的兩個 App,再說或輸入完全相同的句子。這是重播候選題,並未預設第一次一定走模型、第二次一定走快取。
固定版的 學習條件只保存符合條件的可重播動作;包含「這個」、失敗、讀取或當下內容的任務會受限制。另一種儲存程序則是給後續模型參考的歷史指引,仍可能重新檢查畫面。穩定快捷的直接重播,和拿舊程序再請模型判斷,要分開記。
每輪筆記留六項:原句、辨識稿、任務路徑、開始到完成秒數、模型用量、結果是否正確。找不到明確路徑證據就填「未判定」。快一點可能來自預先啟動、暖機或不同步驟;一次快慢不足以證明節省多少額度。記憶與學習評測能補上這個判讀習慣。
⑥「刻意停一次」:日期、否定與取消各自驗
先測文字,再考慮語音。依序輸入「活動在 10 月 22 日,不是 10 月 23 日」與「請不要開啟 Chess,只回覆我要求了什麼」,確認它保留最後日期與否定意思。語音稿、回答與實際桌面狀態各是一張收據;任何一張對不上就停止擴大任務。
依官方操作說明,聽寫時按 Esc 可取消而不送出;回答期間再次按快捷鍵可停止,語音播放時可停止播報。先用無害任務演練這些出口,並看桌面是否還有動作。停止後續工作不等於撤銷已完成動作,所以取消驗收要放在寄送或改檔之前。
資料與成本:看得見的零元,不是整張帳
固定版 GUMROAD_PRODUCT 為空,licensed() 因此放行,與 README 的免費描述相符;程式裡另留有尚未啟用的付費分支。這裡說的免費限定這份固定原始碼,不把它延伸成永久承諾。
Atticus Usage 頁面將用量換成 Claude API 標價估值。那個美元數字不能直接當成訂閱帳單或「每月能做幾次」。Anthropic 的 Pro/Max 與 Claude Code 說明確認兩者共享限制;若設有 ANTHROPIC_API_KEY,則可能使用 API 計費。先核對帳號認證方式與是否開啟額外用量,再記自己的實際用量。
訂閱可用也不等於任意整合都獲准。Anthropic 現行 認證與合規文件允許終端使用者在未修改的 Claude Code 以自己的訂閱登入,同時限制第三方代收、儲存或轉送帳號憑證。本篇只採自己的官方登入流程;遇到第三方要求貼上 session token 或借帳號,就停在登入之前。
想改成本機模型?這個版本的 Settings → Intelligence → Custom server 已提供 Address、Key、Model。介面指定相容 Claude API 的伺服器,不能把任意 OpenAI-compatible URL 直接當成已相容。畫面任務還要求模型能理解圖片;這條路要另驗連線、工具與品質,不是把網址換成 localhost 就算完成離線驗收。
遙測也另有去向:官方說明的每日使用計數送往 PostHog;Help improve Atticus 另外涉及失敗任務資料。畫面設定、模型端點和這兩個開關各自檢查。會議功能另有逐字稿與 AI 摘要路徑,第一輪練習先保持關閉,避免把真實會議帶進測試。
Safe mode、記憶與撤權:把門關好才算完成
Safe mode 像有管制的工作區,但別把它理解成所有操作都被關在同一個盒子。原始碼明示,App 控制所需的部分指令在沙盒外執行,再由 Atticus 的 gate 檢查;Claude 啟動參數也使用 bypassPermissions 配合自訂 hook。這使 Claude Code 沙盒的邊界與 Atticus 自己的批准規則都成為你要查的部分。
因此這輪只做開 App 與假資料摘要。遇到要求修改檔案、寄送或離開安全資料夾的批准卡,讀完整命令和對象;不清楚就拒絕。安全模式的存在支持「有一道檢查」,不構成所有自然語言風險都已被辨認的證據。
到 Settings → Memory 逐項檢查規則、個人資料、儲存快捷與程序,刪掉本輪測試項目;不要按 Import from your Mac 把通訊錄帶入。Usage → Forget this conversation 針對近期上下文,與 Memory 中長期項目分開處理。先再問一次測試偏好,確認刪除後沒有繼續引用。
要停用,先 Quit Atticus,再到 macOS 系統設定 → 隱私權與安全性 分別收回麥克風、輔助使用、螢幕錄影與自動化;Apple 的 麥克風權限說明可協助找到開關。重開 App 做無害動作,確認已撤回的能力真的受到限制。
要移除預設安裝,依 README 先卸載登入服務,再用 Finder「前往檔案夾」檢查並移到垃圾桶:~/Applications/Atticus.app、~/.atticus、~/.config/atticus、~/Library/LaunchAgents/com.atticus.app.plist。第三個資料夾含設定、歷史與可能的會議存檔,先決定要不要留自己的紀錄。若曾改用自訂資料路徑,另核對該位置。
launchctl bootout "gui/$(id -u)/com.atticus.app"
這只停止登入服務。完整清理還要檢查 com.atticus.app 的偏好設定,以及建置時新增的本機簽署身分;先確認身分確由這次安裝建立、沒有其他用途,再在「鑰匙圈存取」處理。刪除本機檔案也不會撤回已送達模型或遙測服務的資料,資料最小化要在首跑前完成。
FAQ:Atticus 新手最容易混淆的八件事
1. 免費 App 代表每次要求都免費嗎?
不代表。固定版本軟體免費;模型用量依你實際的訂閱、API 或其他端點認證方式處理,另查額外用量設定。
2. 聽寫在本機,就能把機密資料交進去嗎?
先分資料流。語音轉字、模型請求與 PostHog 遙測是不同路徑;文字與相關記憶仍可能成為模型脈絡。
3. 這篇證明繁中語音可用了嗎?
尚未。固定版指定 en-US,本文沒有繁中語音成績;先完成繁中文字的日期與否定句驗收。
4. 第二次比較快,就表示完全沒用模型嗎?
證據還不夠。查 Ask log 與儲存快捷;直接重播和帶著舊程序重新推理要各自辨認。
5. 改成本機伺服器要填什麼?
先查你現有伺服器的 Claude API 相容介面,再填 Address、Key、Model;工具呼叫與圖片能力另驗,不預設所有端點可互換。
6. Safe mode 開著,可以批准所有 App 嗎?
先只批准任務需要的 App。部分桌面控制走沙盒外路徑,批准卡與 macOS 權限仍要看對象和操作。
7. 按 Esc 會把已做的動作還原嗎?
Esc 在聽寫階段取消送出;已完成的動作需另外回復。先測停止出口,再給它修改或寄送任務。
8. Forget this conversation 就刪光記憶了嗎?
要分開處理。近期對話、Memory 長期項目及本機檔案是不同位置;依你要保留的資料逐項檢查。
給新手的三個重點
- 用「三條路」辨認行為:本機即時、穩定快捷重播、模型判斷;紀錄不明就保留未判定。
- 用「兩張帳」看代價:模型用量與資料去向;速度、估價和隱私不是同一個數字。
- 先驗收可回復的小事與停止出口,再擴大權限;繁中語音要有自己的辨識證據。
接著閱讀
左右滑動查看更多推薦
下一步:今天只完成三句話的紀錄
回到錨點:本機聽寫+指令分流+桌面操作,模型用量與資料去向另外記。今天先做 Calculator、假資料摘要、組合動作重複三題,留下紀錄,再練一次取消。當你能解釋每一句走哪條路,才把下一件工作交出去。想把這套習慣用在更多流程,可到 AI 教學專區或 AlphaLab 課程選下一個練習。






