voicemode

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

开源 🏷️定价信息待确认 ✅ 目前可打开音频音乐 🍴 复刻 202 🐛 待处理 65 👀 关注 8

访问官网 ↗ GitHub ↗

GitHub 星标 ★ 1443

维护状态活跃

是否开源开源

定价模式 🏷️定价信息待确认

项目预览

项目数据

分类音频音乐

开发团队mbailey

官网地址https://voicemode.dev

GitHubhttps://github.com/mbailey/voicemode

定价模式🏷️定价信息待确认

价格说明定价信息待确认

访问状态✅ 目前可打开

是否开源是

开源协议MIT

主要语言Python

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

GitHub 星标★ 1443

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

代码更新2026-11-08

仓库体积68.6 MB

本站数据更新2026-11-09

维护状态活跃

收录时间2026-08-09

浏览次数6

项目介绍

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

Star 增长趋势

本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整

数据来源：GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 1443

技术标签

anthropic asr claude claudecode kokoro

使用教程

难度：入门约 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`