Speaklna給 AI 程式設計工具
讓 AI 工具開口跟你說話
Claude Code、Codex 等 AI 程式設計工具做完一輪，Speaklna 可以用一句話告訴你結果，你不用一直盯著螢幕。你也可以讓它們把某段內容念出來。聲音全在你的 Mac 上生成。念出來的報告像這樣：“Codex，myproject：測試已經透過，你還需要重啟一下服務。”
npm install -g speaklna
speaklna setupSpeaklna 即將上架 Mac App Store，免費。裝好先開啟一次再設定。
需要什麼
- macOS 15.2 或更新，Apple 晶片的 Mac
- Node.js 18 或更新，用來執行
speaklna包 - 下面任意一個 AI 工具，裝在同一臺 Mac 上
設定說明
一個小包把你的 AI 工具接到 App 上。裝一次，讓它去設定你 Mac 上已有的工具。
setup 會先列出要改的每個檔案，問你 y/N，同意了才寫。每個檔案的原件會備份一次，叫 <檔案>.speaklna-bak。只設定某一個工具，就在後面加名字：speaklna setup codex。加 --dry-run 只看不寫，加 --yes 就不再詢問。
也可以不安裝直接執行：npx -y speaklna setup。更推薦全域性安裝，這樣鉤子指向的是固定路徑，而不是 npx 的快取目錄。
選你的工具
每一頁都寫明 setup 會改哪些檔案、怎麼試、怎麼解除安裝。
用之前知道這些
報告排隊，一次念一句
同一個會話排著好幾句時，只留最新的一句。排了兩分鐘還沒念上的，直接丟掉，因為已經不是新訊息了。
插在段落之間
Speaklna 正在給你念別的內容時，報告會等當前這一段念完，插進來念，然後接著念原來的。
⌥T 和 ⌥S 永遠優先
按 ⌥T 會開始念剪貼簿，並清掉 AI 工具排著的所有內容；按 ⌥S 全部停下，並清空佇列。
開會時不出聲
別的 App 正在用麥克風時（比如通話、語音輸入），AI 工具的聲音一律不出。被攔下的句數會記在“接入 AI”視窗裡。
存成音訊檔
在終端機裡執行 speaklna save "文字" -o clip.wav，或者叫 AI 工具把一段話存成音訊。念法和 ⌥T 一樣，只是不出聲、寫成 WAV 檔案；不給 -o 就放在“音樂”資料夾裡的 Speaklna 資料夾。Speaklna 正在念時它不開工，存的時候按 ⌥T 會把它停掉。
“接入 AI”視窗
在 Speaklna 面板裡開啟。裡面能看到哪些 AI 工具接入過，可以開關“來源”字首（“Codex，myproject：”），可以改成只念“Codex 在 myproject 做完了”，也可以給每個 AI 工具單獨選音色。
隱私
- 報告這一行是你的 AI 工具寫的。Speaklna 加的規矩會告訴模型，絕不能在裡面寫密碼、金鑰或令牌；這個包在把句子交給 App 之前，還會把長得像金鑰的內容抹掉。
- 這個包透過本機的 macOS 訊息把文字交給 App，不出這台 Mac。安裝它時會從 npm 下載一次。
- AI 工具只能念、存成 WAV 放進“音樂”資料夾、停、查狀態、列音色，不能匯入音色，也不能改設定。
詳細內容見隱私政策。
解除安裝
只刪 setup 加進去的東西，別的不碰。
speaklna uninstall # 所有工具
speaklna uninstall codex # 只卸一個它會先列出要刪的內容，問過你再刪。之後想把這個包也刪掉：npm uninstall -g speaklna。
出問題怎麼辦
提示沒有安裝 Speaklna
先從 Mac App Store 安裝 App，再開啟一次。鉤子只在 macOS 上起作用。
一輪結束後沒有聲音
按順序查：
- AI 回覆的最後有沒有一行以
🔊（喇叭 emoji）開頭？沒有的話，新開一個會話，讓它讀到規矩。 - Codex 是否在
/hooks裡點了信任？OpenClaw 裝完後是否重啟過 Gateway？ - 是不是別的 App 正佔著麥克風？通話和語音輸入時報告會被攔下。
- 執行
speaklna say "你好"。如果這句能聽到，說明 App 和這個包都沒問題，問題在 AI 工具那邊的設定。
AI 工具說 speaklna 工具啟動失敗
這個工具是透過 npx 啟動的，所以 Node.js 必須在 AI 工具自己的 PATH 裡，不只是你的終端機裡。裝好 Node.js 18 或更新，再重啟 AI 工具。
setup 說已經有一個不同的 speaklna 條目
不是它自己寫的條目，setup 一律不動。把你那條改名或刪掉，再執行一次 setup。