安装
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 启动命令存在，但不要和插件市场抢成两条主路径。没有写出配额、计费或必须的云端密钥。