Mac 上 Claude Code 語音輸入：設定與排障

在 Mac 設定 Claude Code /voice，先檢查文字再送出；排查空白鍵、麥克風與 SSH 問題，了解原生聽寫與獨立輸入工具的使用條件及資料邊界。

由 ListenIn 發布 · 2026年10月21日

先看結論

Claude Code 的 /voice 需要 Claude.ai 認證、本機麥克風與雲端轉寫。要先檢查草稿，可使用按住模式並關閉自動送出。ListenIn 提供另一條 Mac 文字輸入途徑；選擇前先確認語言、輸入位置與資料處理設定。

語音對話與聽寫不同

聽寫把語音變成文字指令；雙向語音對話還會讀出回答。Anthropic 的說明區分這兩種功能。本文介紹 Claude Code CLI 的 /voice，不把桌面或手機 App 的所有麥克風入口混為一談。

在 Mac 開始聽寫，檢查後再送出

在本機終端機開啟 Claude Code，以 Claude.ai 帳號登入，執行 /voice hold。
允許該終端機使用麥克風，用 /config 設定口述語言。
在輸入框按住 Space，看到聆聽指示後說一條無敏感資訊的測試要求，再放開。
檢查文字後才按 Enter。將下列設定合併到 ~/.claude/settings.json，保留其他原有設定，可明確關閉自動送出。

{
  "voice": {
    "enabled": true,
    "mode": "hold",
    "autoSubmit": false
  }
}

原生聽寫文件說明：按住模式預設保留草稿；點按模式可能自動送出至少三個詞的轉寫，且靜音 15 秒或錄音兩分鐘後停止。轉寫不計入 /usage，後續 Agent 請求則是另一回事。直接 API Key 與第三方供應商設定不適用這條原生語音服務。

沒反應時，按現象排查

現象	先檢查
找不到 `/voice` 或要求登入	實際認證方式與組織政策；不要移除工作需要的設定
按住 Space 一直輸入空格	按住模式是否啟用、終端機是否送出重複按鍵
點按只出現空格	點按錄音需從空白輸入框開始，也須留意自動送出
麥克風被拒絕或無聲	分別檢查終端機權限及 macOS「聲音 → 輸入」
SSH 或 VS Code Remote	原生錄音需要本機麥克風；可改由本機產生文字再貼上

截至 2026 年 10 月 21 日，官方語言表包含日、韓、法、德及西班牙語，未列中文。不要把能用中文回答當成支援中文聽寫的證據。更多中文聽寫細節，可閱讀英文的中文輸入指南。

何時考慮 ListenIn

一般文字輸入可先試 Apple 聽寫。需要跨 App 共用觸發鍵、整理口述要求或中文夾英文時，ListenIn 是獨立選項。公開版本為 2026 年 10 月 17 日發布的 v0.3.8（構建 45），需要 macOS 14 或以上。本文未做同音訊效能比較，也不保證每個術語都正確。

遠端工作流的示意例：在本機終端機的 Claude Code 輸入框說「解釋測試為何失敗，不要修改檔案」，檢查限制完整後自行送出。這是在本機輸入文字，不是轉送麥克風。出現複製卡片時，重新聚焦正確欄位並手動貼上；不要反覆錄音造成重複指令。若輸入框顯示折疊預覽，先檢查內容，不據此判斷丟字，也不套用舊版本的固定字數門檻。

音訊、整理文字與 Agent 各有資料邊界

ListenIn 在 Mac 辨識音訊；預設內建整理把文字傳送至服務及模型供應商。本機 Ollama 模型與離線模式可提供本機整理，但需先下載模型、關閉 Ollama 雲端功能並保持服務執行。文字送入 Claude Code 後，仍適用它自己的資料政策。詳見英文資料流程說明。本文的翻譯不代表 App 介面或所有語音模型支援同樣語言。

下載 Mac 版，先在實際使用的輸入框試一條不敏感的指令，確認詞語、限制與目的地，再決定是否適合。

下載 Mac 版