安裝
claude plugin marketplace add mbailey/voicemode
claude plugin install voicemode@voicemode適合誰
你已經在用 Claude Code，希望在手騰不開、不方便打字時改用自然語音把對話繼續下去。官方寫明：語音不是為了取代打字，而是讓它在無法打字時仍然可用。適合接受一次真實語音進出、而不是只要文字回顯的人。
平台摘錄覆蓋 Linux、macOS、Windows（原生或 WSL）和 NixOS，Python 3.10-3.14。現有說明沒有列出必須的麥克風型號、揚聲器要求，也沒有寫出是否強制雲端語音服務。若你不能給 Claude Code 裝外掛，或不能允許語音相關工具，這份指南幫不到你。
3 分鐘完成第一次嘗試
前置條件：Claude Code 可用，Python 落在 3.10-3.14，當前環境允許出聲和收聽。官方推薦路徑是先加市場再裝外掛，不要先走旁路 MCP 命令：
claude plugin marketplace add mbailey/voicemode
claude plugin install voicemode@voicemode
裝好後重啟或重開一次 Claude Code，確認外掛已出現。第一次嘗試只用摘錄裡點名的 mcp__voicemode__converse。這不是唯讀查詢：它會進入語音對話，可能使用本機音訊裝置，也會把你的說話內容交給代理。開始前先確認你處在可以出聲、可以聽、並且不介意這段對話被模型處理的環境，再發起呼叫。
可觀察的成功訊號：對話以語音形式接上，而不是外掛安裝命令本身回傳成功。現有說明沒有給出「說一句固定測試詞」或日誌關鍵字；若用戶端彈出權限確認，先看清它要放行的是 mcp__voicemode__converse 再同意。不要在第一次嘗試裡呼叫 mcp__voicemode__service——摘錄只把它列在權限名單裡，沒有說明它做什麼。
材料另有一條 claude mcp add --scope user voicemode -- uvx --refresh --from voice-mode voicemode-mcp-launcher，那是另一條安裝路徑。第一次嘗試只走上面的外掛市場，避免同時配兩套入口。
使用案例
案例 1：手邊不適合打字時，用 mcp__voicemode__converse 把正在進行的 Claude Code 任務改成語音往返。現有說明只保證「自然語音對話」，沒有列出語言、打斷、降噪或把語音轉成可編輯草稿的參數。成功時應以你能聽懂回覆、並能繼續下一輪為準，而不是看某一條文字日誌。
案例 2：需要顯式放行語音能力時，權限名單裡同時出現 mcp__voicemode__converse 和 mcp__voicemode__service。摘錄沒有解釋 service 的職責、是否會改本機服務、以及失敗如何回退。因此這一案例只走到「按名單放行 converse，service 保持未說明」為止，不要編造重啟服務或安裝系統守護行程的步驟。
使用邊界
官方頁面是
https://github.com/mbailey/voicemode
不要把它理解成「無網路、無本機讀取、無隱私邊界」：語音對話預設會採集你的說話內容。Python 必須落在 3.10-3.14；平台名單止於 Linux、macOS、Windows（原生或 WSL）和 NixOS。摘錄沒有解除安裝、關閉麥克風或撤銷一次對話的步驟。service 工具除權限名外沒有用法。旁路 uvx 啟動命令存在，但不要和外掛市場搶成兩條主路徑。沒有寫出配額、計費或必須的雲端金鑰。