Voice Mode

VoiceMode

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

VoiceMode を使うと、Claude Code と自然な音声会話ができます。音声はタイピングに取って代わるものではありません。タイピングできないときにも使えることが大切です。

こんな場面に最適です：

• 次の会議に向かって歩いているとき
• デバッグしながら料理をしているとき
• 画面を長時間見た後、目を休めたいとき
• コーヒー（または犬）を抱えているとき
• 手や目がふさがっているあらゆる場面

実際の動作を見る

クイックスタート

必要なもの： マイクとスピーカーを備えたコンピューター

オプション 1：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

オプション 2：Python インストーラーパッケージ

依存関係と 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 --from voice-mode voicemode-mcp-launcher

# 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
];

トラブルシューティング

デバッグ用に音声を保存する

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

ドキュメント

• はじめに - セットアップの全手順
• 設定 - すべての環境変数
• Whisper のセットアップ - ローカル音声テキスト変換
• Kokoro のセットアップ - ローカルテキスト音声変換
• 開発環境のセットアップ - コントリビューションガイド

ドキュメント全文：voicemode.dev

Links

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

License

MIT - A Failmode Project

mcp-name: dev.voicemode/voicemode