attunz 說明
在 Mac 上口述程式開發提示詞和技術文字
你可以在各種 Mac 應用程式中使用 attunz，包括 Cursor、VS Code、Claude Code、Codex 和終端機，口述程式開發提示詞、文件和技術筆記。先說出想寫的內容，再檢查結果後使用。
把提示詞說清楚
- 將游標放在要輸入文字的位置，開始使用 attunz 語音輸入。
- 說清楚目標、相關元件或 API 名稱，以及需要遵守的限制。如果要寫文件，也說明讀者是誰、需要解釋什麼。
- 檢查產生的文字，修正重要細節，再提交給正在使用的工具。
試著口述程式開發或文件需求
假設你要口述一段程式開發提示詞：「在 UserSettings 中，當 API 傳回的專案清單為空時，增加一個空狀態。保留現有的載入狀態和錯誤狀態。修改程式碼前，先解釋計畫如何修改，並建議需要補充哪些測試。」
假設你要口述一段文件需求：「說明收到 HTTP 429 回應後如何使用 retryAfterMs，寫清楚單位，並提供一個例子。」
這些例子展示了可以口述的文字。提交前，請確認 UserSettings、retryAfterMs 和 HTTP 429 與實際任務一致。
了解 attunz 使用的上下文
聽寫時，attunz 可以按需自動結合應用程式名稱、AX 視窗文字、選取的文字、輸入欄位中既有的文字及可取得的游標位置。視窗文字透過 macOS 輔助使用（AX）介面取得，不使用截圖。可用文字和游標資訊取決於目標應用程式與權限，協助 AI 增強理解目前輸入情境，潤飾 ASR 結果並調整格式。
用於模型上下文的剪貼簿擷取預設關閉。自動視窗上下文不會掃描專案原始碼；主動匯入文件是你選擇的獨立操作，獲准讀取的本機 Claude/Codex 歷史是另一種輸入。自動上下文擷取可關閉。
檢查會影響意思的細節
檢查識別字、大小寫、檔案路徑、數字、單位和標點。尤其要核對「不要修改公開 API」這類限制條件。如果在終端機裡口述指令文字，請先檢查，再執行。
經常使用的名稱和專業術語，可以參考記憶功能指南。關於本機模型設定、本機處理與雲端處理的差異，可以參考離線語音輸入指南。是否取得上下文和在哪裡處理，是兩個不同的問題。
設定 AI 增強並預覽提示詞
在「AI 增強」設定中啟用功能並選擇模型。聽寫後，AI 會依提示詞修正辨識錯誤、去除贅詞與重複，並依情境調整語氣和格式。短文可依設定直接輸出。
在「AI 增強 → 提示詞」中寫下語氣、格式等要求，用測試區預覽效果。可插入目前 App 等情境變數；個人表達偏好也能在記憶的「風格畫像」中編輯。
「提示詞」測試區使用目前選擇的增強模型。使用雲端模型時，執行測試會將測試文字傳送給對應供應商。請使用非敏感範例並檢查輸出；測試預覽不保證每個應用程式中的結果都相同。
使用本機模型或 BYOK（自備 API Key），Attunz 完整軟體功能終身免費，Attunz 不收取任何費用。第三方模型費用由你向供應商支付。Attunz 託管雲端服務已推出，為可選雲端 ASR 與 AI 增強採用手動額度儲值，目前不自動續費。 價格
選擇適合你的語音輸入方式
即時語音對話讓你與 Agent 持續交流；聽寫則產生可編輯的提示詞文字，供你檢查後再提交。原生工具可能支援其中一種或兩種，應區分特定 App 與 CLI 的功能。需要在提示詞輸入欄、編輯器和筆記間切換時，Mac 系統範圍的語音輸入流程可以提供幫助。
先確認 Claude Code 原生語音的使用條件
Claude Code 原生聽寫針對程式術語最佳化，並以專案名和分支名作為辨識提示。它需要 Claude.ai 身分驗證，音訊會傳送到 Anthropic 轉寫。此功能不支援直接 API Key 或第三方供應商驗證；文件也排除 SSH／雲端工作階段及 VS Code Remote 工作階段。請依使用介面核對最新文件。
Codex 已有原生聽寫功能。Codex App 在 2026 年 5 月 5 日加入文字清理，以及名稱、路徑與程式符號的字典；另外，2026 年 9 月 22 日的 CLI 0.156.0 版本預設啟用語音對話。App 聽寫與 CLI 對話是不同的介面和流程。
Codex App 更新紀錄 · Codex CLI 0.156.0 發布說明
依實際工作情境選擇
- 只在一個工具工作：先查看原生語音功能。Claude Code 和 Codex 都有原生選項，Cursor 的 Agents Window 也提供語音輸入。免費、本機或 BYOK 配置並非 Attunz 獨有。
- 在多個 Mac 應用程式間切換：選擇適合在編輯器、提示詞輸入框和技術筆記之間使用的聽寫流程。能否插入文字仍取決於目標應用程式和權限。
- 希望使用本機處理：依離線指南設定本機語音辨識、增強和記憶模型，同時確認提交文字後，哪些服務會收到內容。
使用工作帳戶時，請遵守組織對應用程式和處理服務的規定。提交提示詞或執行指令前，先核對文字。
常見問題
可以在 Cursor、VS Code、Claude Code、Codex 和終端機中使用 attunz 嗎？
可以。attunz 支援在各種 Mac 應用程式中進行語音輸入，包括這些工具。將游標放在要寫入的位置，口述內容，並在提交前檢查文字。
attunz 會讀取專案檔案或剪貼簿嗎？
用於模型上下文的剪貼簿擷取預設關閉。自動視窗上下文不會掃描專案原始碼；主動匯入文件是你選擇的獨立操作，獲准讀取的本機 Claude/Codex 歷史是另一種輸入。自動上下文擷取可關閉。 聽寫時，attunz 可以按需自動結合應用程式名稱、AX 視窗文字、選取的文字、輸入欄位中既有的文字及可取得的游標位置。視窗文字透過 macOS 輔助使用（AX）介面取得，不使用截圖。可用文字和游標資訊取決於目標應用程式與權限，協助 AI 增強理解目前輸入情境，潤飾 ASR 結果並調整格式。
可以關閉自動取得上下文嗎？
可以。上下文會自動取得，你也可以關閉這項功能。本機處理和雲端處理的選擇，請另外參閱離線語音輸入指南。
本機語音輸入能讓 Claude Code 等程式開發服務離線執行嗎？
不能。選擇所需的本機模型後，聽寫可以在 Mac 上把語音轉成文字；接收文字的應用程式或服務仍有自己的連網要求和資料政策。提交提示詞前，需要另外確認這些條件。
可編輯聽寫與即時語音對話有何差別？
聽寫先產生文字，你可以檢查、編輯後再作為程式提示詞提交；即時語音對話則是與 Agent 持續口頭交流。原生功能滿足需求時可直接使用；需要跨應用輸入或選擇本機處理時，可考慮 Mac 聽寫流程。本機轉寫不會使接收文字的程式服務離線，也不代表已支援遠端工作階段。
正在從其他語音輸入應用程式切換？看看 attunz 作為 Wispr Flow 替代方案或 Superwhisper 替代方案的比較。