Claude Code の応答を自然な日本語音声で読み上げるCLIツール。 VOICEVOX の高品質な音声合成をローカルで使用します。
デフォルトの声は ずんだもん。50以上のキャラクターボイスに切り替え可能です。
voicevoice.mp4
- Claude Code の応答を自動で読み上げ
- Permission prompt も音声で通知（画面を見ずに承認/拒否）
- Kindle・ブラウザ・PDF なども読み上げ（
voicevoice watch） - 画像内テキストの OCR → 読み上げ（
voicevoice ocr/voicevoice screen） - 音声ファイルとして保存（
voicevoice save） - キーボードショートカットで選択テキストを読み上げ（
voicevoice shortcut） - 50以上のキャラクターボイス（ずんだもん、四国めたん等）
- ターミナルセッションごとにON/OFF切り替え可能
- クラウドAPI不要、完全無料、ローカル完結
- OFFの時は Claude Code に影響ゼロ
- アンインストールで完全に元の環境に戻る
brew install john-rocky/tap/voicevoice# セットアップ（VOICEVOXも自動インストール）
voicevoice setup
# 読み上げONにして Claude Code を起動
voicevoice on
claudeHomebrew を使わない場合
git clone https://github.com/john-rocky/voicevoice.git
cd voicevoice
swift build -c release --product voicevoice
sudo cp .build/arm64-apple-macosx/release/voicevoice /usr/local/bin/- macOS 14 以降（Apple Silicon）
- Claude Code
- VOICEVOX —
voicevoice setupで自動インストール - jq —
brew install jq
# 読み上げを有効にする（このターミナルセッションのみ）
voicevoice on
# Claude Code を起動 → 応答が自動で読み上げられる
claude
# 会話中に切り替え
! voicevoice off # ミュート
! voicevoice on # 再開# テキストを読み上げ
voicevoice "こんにちは、今日はいい天気ですね"
# パイプで渡す
echo "ビルド成功！" | voicevoice
# 声を変える（青山龍星 = 男性）
voicevoice -s 13 "お疲れ様です"
# 使えるキャラ一覧
voicevoice -l# クリップボード監視モード — テキストをコピーするたびに自動で読み上げ
voicevoice watch
# クリップボードの内容を一回だけ読み上げ
voicevoice readvoicevoice watch をターミナルで起動しておけば、Kindle・ブラウザ・PDF など どのアプリでもテキストを選択してコピー（⌘C）するだけ で読み上げてくれます。Ctrl+C で停止。
voicevoice shortcutmacOS の Quick Action を作成します。テキストを選択してショートカットキーを押すだけで読み上げ。
設定手順:
voicevoice shortcutを実行- System Settings → Keyboard → Keyboard Shortcuts → Services
- 「voicevoice Read Aloud」にショートカットを割り当て（例: ⌃⌥V）
スクリーンリーダーでは読めない画像内のテキストを読み上げます。
# 画像ファイルを OCR して読み上げ
voicevoice ocr screenshot.png
# クリップボードのスクリーンショットを OCR（⌘⇧4 → ⌘V → 読み上げ）
voicevoice ocr
# 今の画面をキャプチャして OCR → 読み上げ
voicevoice screenmacOS 標準の Vision フレームワークを使用。日本語・英語に対応。追加インストール不要。
voicevoice save "ナレーションテキスト" # voicevoice_output.wav に保存
voicevoice save -o narration.wav "ナレーションテキスト" # 指定ファイルに保存
voicevoice save -o output.wav -s 13 "男性の声で" # スピーカー指定
echo "パイプも可" | voicevoice save -o output.wav # パイプ入力速度やキャラクターを保存できます。フックからの自動読み上げにも反映されます。
# 現在の設定を確認
voicevoice config
# 読み上げ速度を変更（0.5〜2.0、デフォルト 1.0）
voicevoice config speed 1.3
# キャラクターを変更
voicevoice config speaker 13 # 青山龍星（男性）
# 一時的に変更（保存しない）
voicevoice --speed 1.5 "速いテスト"
voicevoice -s 8 "春日部つむぎの声"| コマンド | 説明 |
|---|---|
voicevoice setup |
Claude Code 連携 + VOICEVOX インストール |
voicevoice on |
読み上げON（セッション単位 / グローバル） |
voicevoice off |
読み上げOFF |
voicevoice watch |
クリップボード監視モード（Kindle・ブラウザ等に） |
voicevoice read |
クリップボードの内容を読み上げ |
voicevoice save |
音声ファイルとして保存（WAV） |
voicevoice shortcut |
macOS キーボードショートカットを作成 |
voicevoice ocr [IMAGE] |
画像の OCR → 読み上げ（ファイル or クリップボード） |
voicevoice screen |
画面キャプチャ → OCR → 読み上げ |
voicevoice config |
設定の確認・変更（speed, speaker, host） |
voicevoice status |
現在の状態を確認 |
voicevoice help |
ヘルプを表示 |
voicevoice uninstall |
完全削除（環境を元通りに） |
デフォルト: ずんだもん（ID: 3）。voicevoice config speaker <ID> で変更できます。
| ID | キャラクター | スタイル |
|---|---|---|
| 0 | 四国めたん | あまあま |
| 2 | 四国めたん | ノーマル |
| 1 | ずんだもん | あまあま |
| 3 | ずんだもん | ノーマル |
| 8 | 春日部つむぎ | ノーマル |
| 13 | 青山龍星 | ノーマル |
| 14 | 冥鳴ひまり | ノーマル |
| 47 | ナースロボ＿タイプＴ | ノーマル |
voicevoice -l で全キャラクター（50以上）を確認できます。
Claude Code（応答完了）
↓ Stop フック
voicevoice-hook.sh
↓ セッションフラグを確認
voicevoice CLI
↓ HTTP（localhost のみ）
VOICEVOX エンジン（Mac上で動作）
↓
音声再生
- すべての処理はMac上で完結。インターネット不要。
- 読み上げはバックグラウンドで実行。再生中でも次の入力がすぐできます。
- OFFの時はファイル1個チェックして即終了（~0.1ms）。Claude Codeへの影響ゼロ。
- 複数セッションの音声は自動で順番待ち。声が重なることはありません。
voicevoice uninstall以下が削除されます:
settings.jsonからのフック登録（他の設定はそのまま）- フックスクリプト（Stop + Notification）
- Quick Action（キーボードショートカット）
- すべてのフラグ・設定・一時ファイル
セットアップ前と完全に同じ環境に戻ります。
voicevoice バイナリ自体も消す場合:
rm /usr/local/bin/voicevoiceVOICEVOX も消す場合:
rm -rf /Applications/VOICEVOX.appvoicevoice 本体は MIT ライセンスです。
VOICEVOX およびキャラクターボイスには個別の利用規約があります:
VOICEVOX で生成した音声を公開する場合、クレジット表記が必要です:
VOICEVOX:ずんだもん
キャラクター名は使用したものに置き換えてください。詳細は各利用規約を参照してください。
MIT