voicemode

动嘴就能写代码，和 Claude Code 自然对话提效

voicemode 是一个让开发者通过自然语音与 Claude Code 进行对话的开源工具。它解决了在编码过程中频繁切换键盘输入与思考的问题，允许开发者直接说出指令或问题，由系统完成语音识别（ASR）和文本转语音（TTS）的闭环。核心能力包括：基于 LiveKit 实现低延迟的实时语音交互，集成 Whisper 进行高精度语音识别，使用 Kokoro 提供自然流畅的语音合成，并通过 MCP 服务器与 Claude Code 深度集成，支持上下文感知的对话。项目采用 Python 编写，技术栈涵盖 anthropic、claude 等，为开发者提供了一种更高效、更沉浸式的编程交互方式，特别适合需要长时间编码或有多任务处理需求的场景。

开源 unknown 音频音乐

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 1374

维护状态活跃

是否开源是

定价模式 unknown

项目数据

分类音频音乐

开发团队mbailey

所属国家

官网地址https://voicemode.dev

GitHubhttps://github.com/mbailey/voicemode

定价模式unknown

价格说明定价信息待确认

访问状态

是否开源是

开源协议MIT

主要语言Python

技术栈/模型anthropic,asr,claude,claudecode,kokoro,livekit,mcp,mcp-server,tts,voice,voicemode,whisper

GitHub 星标★ 1374

30天Star增速

HF 下载量

上线时间2025-06-08 00:00:00

最近更新2026-09-23 00:00:00

维护状态活跃

中文支持

访问方式

移动端支持

综合评分

收录时间2026-08-09

浏览次数4

使用教程

难度：入门约 10 分钟部署方式：命令行工具 8 步

环境要求

带麦克风和扬声器的电脑
已安装 Claude Code（插件方式或 MCP 方式均需）
联网环境（首次安装依赖需要下载）
可选：OpenAI API Key 作为本地语音服务的备用
可选：本机已安装 UV 包管理器（安装脚本会自动装）

安装与启动步骤

1添加插件市场

在 Claude Code 中执行，把 mbailey/voicemode 加入插件市场列表，这是推荐的快速安装方式第一步。
```
claude plugin marketplace add mbailey/voicemode
```
2安装 VoiceMode 插件

从刚添加的市场安装 voicemode 插件，装完后 Claude Code 内会出现 /voicemode 系列命令。
```
claude plugin install voicemode@voicemode
```
3安装依赖

在 Claude Code 会话中执行该斜杠命令，自动安装 CLI 与本地语音服务依赖。
```
/voicemode:install
```
4开始语音对话

执行后即可对着麦克风说话，Claude 会用语音回复，完成 ASR 与 TTS 闭环。
```
/voicemode:converse
```
5备用：安装 UV

不使用插件方式的用户，先安装 UV 包管理器。已装可跳过。
```
curl -LsSf https://astral.sh/uv/install.sh | sh
```
6备用：运行安装器

通过 uvx 运行官方安装器，自动配置依赖和本地语音服务，无需手动装包。
```
uvx voice-mode-install
```
7备用：注册 MCP 服务

把 VoiceMode 的 MCP 服务器加入 Claude Code 用户级配置，供其调用语音能力。
```
claude mcp add --scope user voicemode -- uvx --refresh --from voice-mode voicemode-mcp-launcher
```
8备用：启动对话

配置完成后在终端直接启动一次带语音的 Claude 对话。
```
claude converse
```

关键配置

配置项	必填	说明	示例
`OPENAI_API_KEY`	否	可选，作为本地语音服务失败时的备用云端能力	`export OPENAI_API_KEY=your-openai-key`
`~/.claude/settings.json 的 permissions.al`	否	可选，加入后使用语音功能时不再弹权限确认	`{"permissions":{"allow":["mcp__voicemode__converse","mcp__vo`

如何确认成功

执行 /voicemode:converse 或 claude converse 后对它说话，Claude 能语音回应即安装成功。

常见问题

Q：必须用 Claude Code 吗？

A：README 主打与 Claude Code 集成，同时也面向其他支持 MCP 的 agent，但给出的安装命令都是围绕 Claude Code 的。

Q：没有麦克风或扬声器能用吗？

A：不行。README 明确要求一台带麦克风和扬声器的电脑，语音输入输出是核心功能。

Q：OPENAI_API_KEY 是必须的吗？

A：不是。README 标注为 Optional，仅作为本地语音服务之外的备用方案。

Q：装完每次都要重新安装吗？

A：不需要。插件安装和 uvx voice-mode-install 只需执行一次，之后直接用 /voicemode:converse 即可。

注意事项

官方推荐优先使用 Claude Code 插件方式，比 Python 安装包更快。
README 还提到 Nix 安装方式（nix profile install github:mbailey/voicemode），适合 NixOS 用户。
配置项默认开箱即用，无需额外设置即可开始对话。

核心亮点

基于 LiveKit 实现低延迟实时语音交互，对话流畅自然
集成 Whisper 与 Kokoro，语音识别和合成质量高
通过 MCP 与 Claude Code 深度集成，支持上下文感知

不足之处

依赖外部语音服务，离线场景支持有限
文档/社区待观察

适用场景

编程时快速下达指令或提问，免去打字
多任务处理时用语音操作 Claude Code
无障碍场景，辅助手部不便的开发者

替代项目

Open Interpreter、ShellGPT、Warp

项目介绍

voicemode 是对话助手领域的开源项目，由 mbailey 开发，2025 年首次发布。

在全站 13,090 个收录项目中，它的 GitHub 星标数（1,374）位列前 30%，在对话助手分类中处于中上游。

近 42 天，它的 GitHub 星标从 1,320 增加到 1,374，净增 54。

项目目前处于活跃维护状态，最近一次代码更新于 2026-09-23。从国内网络环境看，可直接访问。

它主要面向的使用场景是：编程时快速下达指令或提问，免去打字。同类可对比的替代方案包括 Open Interpreter、ShellGPT、Warp。

上一篇：cortana

下一篇：voice-chat-ai