Claude Code（および他の MCP 対応エージェント）との自然な音声会話

VoiceMode を使うと、Claude Code との自然な音声会話が可能になります。音声入力は、タイピングに代わるものではなく、タイピングができないときに利用できるようにするためのものです。

以下の場面に最適です:

• 次の会議に向かっている途中
• デバッグ中に料理をしている
• 長時間の画面作業で目を休めたいとき
• コーヒー（または犬）を持っているとき
• 手や目が塞がっているあらゆる瞬間

要件: マイクとスピーカーが搭載されたコンピュータ

Claude Code ユーザーが最も速く始める方法です:

# Add the VoiceMode marketplace
claude plugin marketplace add mbailey/voicemode

# Install VoiceMode plugin
claude plugin install voicemode@voicemode

## Install dependencies (CLI, Local Voice Services)

/voicemode:install

# Start talking!
/voicemode:converse

依存関係をインストールし、VoiceMode Python パッケージをインストールします。

# Install UV package manager (if needed)
curl -LsSf https://astral.sh/uv/install.sh | sh

# Run the installer (sets up dependencies and local voice services)
uvx voice-mode-install

# Add to Claude Code
claude mcp add --scope user voicemode -- uvx --refresh voice-mode

# Optional: Add OpenAI API key as fallback for local services
export OPENAI_API_KEY=your-openai-key

# Start a conversation
claude converse

手動セットアップについては、スタートガイド を参照してください。

• 自然な会話 - 自然に話し、すぐに応答を聞く
• オフラインで動作 - オプションのローカル音声サービス（Whisper STT、Kokoro TTS）
• 低レイテンシ - 実際の会話のように感じるほど高速
• スマートな無音検出 - 話を止めると自動的に録音を停止
• プライバシーオプション - 完全にローカルで実行するか、クラウドサービスを使用

プラットフォーム： Linux、macOS、Windows (WSL)、NixOS Python： 3.10-3.14

VoiceMode はそのまま動作します。カスタマイズするには以下を実行してください：

# Set OpenAI API key (if using cloud services)
export OPENAI_API_KEY="your-key"

# Or configure via file
voicemode config edit

詳細については設定ガイドを参照してください。

VoiceMode をパーミッションプロンプトなしで使用するには、~/.claude/settings.json に以下を追加してください：

{
  "permissions": {
    "allow": [
      "mcp__voicemode__converse",
      "mcp__voicemode__service"
    ]
  }
}

詳細についてはパーミッション設定ガイドを参照してください。

プライバシーまたはオフライン使用のために、ローカル音声サービスをインストールしてください：

• Whisper.cpp - ローカル音声文字変換
• Kokoro - 複数音声対応のローカル文字音声変換

これらは OpenAI と同じ API を提供するため、VoiceMode はそれらの間でシームレスに切り替わります。

sudo apt update
sudo apt install -y ffmpeg gcc libasound2-dev libasound2-plugins libportaudio2 portaudio19-dev pulseaudio pulseaudio-utils python3-dev

sudo dnf install alsa-lib-devel ffmpeg gcc portaudio portaudio-devel python3-devel

brew install ffmpeg node portaudio

# Use development shell
nix develop github:mbailey/voicemode

# Or install system-wide
nix profile install github:mbailey/voicemode

git clone https://github.com/mbailey/voicemode.git
cd voicemode
uv tool install -e .

# In /etc/nixos/configuration.nix
environment.systemPackages = [
  (builtins.getFlake "github:mbailey/voicemode").packages.${pkgs.system}.default
];

トラブルシューティング

Natural voice conversations with Claude Code (and other MCP capable agents)

VoiceMode enables natural voice conversations with Claude Code. Voice isn't about replacing typing - it's about being available when typing isn't.

Perfect for:

• Walking to your next meeting
• Cooking while debugging
• Giving your eyes a break after hours of screen time
• Holding a coffee (or a dog)
• Any moment when your hands or eyes are busy

Requirements: Computer with microphone and speakers

The fastest way for Claude Code users to get started:

# Add the VoiceMode marketplace
claude plugin marketplace add mbailey/voicemode

# Install VoiceMode plugin
claude plugin install voicemode@voicemode

## Install dependencies (CLI, Local Voice Services)

/voicemode:install

# Start talking!
/voicemode:converse

Installs dependencies and the VoiceMode Python package.

# Install UV package manager (if needed)
curl -LsSf https://astral.sh/uv/install.sh | sh

# Run the installer (sets up dependencies and local voice services)
uvx voice-mode-install

# Add to Claude Code
claude mcp add --scope user voicemode -- uvx --refresh voice-mode

# Optional: Add OpenAI API key as fallback for local services
export OPENAI_API_KEY=your-openai-key

# Start a conversation
claude converse

For manual setup, see the Getting Started Guide.

• Natural conversations - speak naturally, hear responses immediately
• Works offline - optional local voice services (Whisper STT, Kokoro TTS)
• Low latency - fast enough to feel like a real conversation
• Smart silence detection - stops recording when you stop speaking
• Privacy options - run entirely locally or use cloud services

Platforms: Linux, macOS, Windows (WSL), NixOS Python: 3.10-3.14

VoiceMode works out of the box. For customization:

# Set OpenAI API key (if using cloud services)
export OPENAI_API_KEY="your-key"

# Or configure via file
voicemode config edit

See the Configuration Guide for all options.

To use VoiceMode without permission prompts, add to ~/.claude/settings.json:

{
  "permissions": {
    "allow": [
      "mcp__voicemode__converse",
      "mcp__voicemode__service"
    ]
  }
}

See the Permissions Guide for more options.

For privacy or offline use, install local speech services:

• Whisper.cpp - Local speech-to-text
• Kokoro - Local text-to-speech with multiple voices

These provide the same API as OpenAI, so VoiceMode switches seamlessly between them.

sudo apt update
sudo apt install -y ffmpeg gcc libasound2-dev libasound2-plugins libportaudio2 portaudio19-dev pulseaudio pulseaudio-utils python3-dev

sudo dnf install alsa-lib-devel ffmpeg gcc portaudio portaudio-devel python3-devel

brew install ffmpeg node portaudio

# Use development shell
nix develop github:mbailey/voicemode

# Or install system-wide
nix profile install github:mbailey/voicemode

git clone https://github.com/mbailey/voicemode.git
cd voicemode
uv tool install -e .

# In /etc/nixos/configuration.nix
environment.systemPackages = [
  (builtins.getFlake "github:mbailey/voicemode").packages.${pkgs.system}.default
];

export VOICEMODE_SAVE_AUDIO=true
# Files saved to ~/.voicemode/audio/YYYY/MM/

• Getting Started - Full setup guide
• Configuration - All environment variables
• Whisper Setup - Local speech-to-text
• Kokoro Setup - Local text-to-speech
• Development Setup - Contributing guide

Full documentation: voice-mode.readthedocs.io

• Website: getvoicemode.com
• GitHub: github.com/mbailey/voicemode
• PyPI: pypi.org/project/voice-mode
• YouTube: @getvoicemode
• Twitter/X: @getvoicemode
• Newsletter:

MIT - A Failmode Project

mcp-name: com.failmode/voicemode