ずんだもんに読み上げてもらう
Claude Code、便利ですよね。ただ、長い応答が返ってくると画面を凝視し続けることになります。
「これ、読み上げてくれたら画面見なくていいのでは?」
そう思って作りました。Claude Code の応答をリアルタイムで読み上げる CLI ツール voicevoice です。
デフォルトの声は ずんだもん。あの声で Claude の応答を読んでくれます。
3行でセットアップ
brew install john-rocky/tap/voicevoice
voicevoice setup # VOICEVOX の自動インストールもここでやってくれる
voicevoice on
これだけです。あとは普通に claude を起動すれば、応答が返ってくるたびにずんだもんが読み上げてくれます。
何ができるのか
- Claude Code の応答を 自動で読み上げ
- 50以上のキャラクターボイス に切り替え可能(ずんだもん、四国めたん、青山龍星 etc.)
- 完全ローカル。クラウド API 不要、完全無料
- OFF の時は Claude Code への影響 ゼロ(ファイル1個チェックして即終了、~0.1ms)
-
uninstall一発で 元の環境に完全復帰
使い方
基本
# 読み上げ ON にして Claude を起動
voicevoice on
claude
会話中に切り替えたくなったら:
! voicevoice off # ミュート(Claude の会話中に実行可能)
! voicevoice on # 再開
単体でも使える
Claude Code なしでも普通にテキスト読み上げツールとして使えます。
voicevoice "こんにちは、今日はいい天気ですね"
# パイプも OK
echo "ビルド成功!" | voicevoice
# 男性の声にしたい時
voicevoice -s 13 "お疲れ様です"
声を変える
# 使えるキャラ一覧
voicevoice -l
四国めたん: ノーマル(id=2), あまあま(id=0), ツンツン(id=6), セクシー(id=4), ささやき(id=36), ヒソヒソ(id=37)
ずんだもん: ノーマル(id=3), あまあま(id=1), ツンツン(id=7), セクシー(id=5), ささやき(id=22), ヒソヒソ(id=38), ヘロヘロ(id=75), なみだめ(id=76)
春日部つむぎ: ノーマル(id=8)
青山龍星: ノーマル(id=13), 熱血(id=81), 不機嫌(id=82)
...
50以上のキャラクター x 複数スタイルから選べます。好みの声を保存しておけば、フックからの自動読み上げにも反映されます。
voicevoice config speaker 13 # 青山龍星に変更(保存される)
voicevoice config speed 1.3 # ちょっと速めに
しくみ
Claude Code(応答完了)
↓ Stop フック
voicevoice-hook.sh
↓ 有効かチェック
voicevoice CLI
↓ HTTP(localhost)
VOICEVOX エンジン
↓
音声再生
Claude Code の Stop フック を使っています。応答が完了するたびにフックスクリプトが起動し、最後のメッセージを取り出して VOICEVOX に渡します。
ポイント:
- 読み上げは バックグラウンド実行。再生中でも次の入力がすぐできる
- 長い応答は 500文字で切って「以下省略」
- 複数セッションの音声は ファイルロックで順番待ち。声が重なることはない
- すべて Mac 上で完結。インターネット不要
voicevoice setup の中身
setup コマンドは以下を自動でやってくれます:
- VOICEVOX がなければインストール(DMG をダウンロード → /Applications にコピー)
-
フックスクリプトを生成(
~/.claude/hooks/voicevoice-hook.sh) - Claude Code の settings.json にフック登録
既存の設定は壊しません。2回実行しても重複登録されません。
アンインストール
voicevoice uninstall
これだけで:
- settings.json からフック登録を削除(他の設定はそのまま)
- フックスクリプトを削除
- 設定ファイル・フラグファイルをすべて削除
セットアップ前と完全に同じ環境に戻ります。 試してダメだったら一瞬で消せるので、気軽に入れてみてください。
必要なもの
- macOS 14 以降(Apple Silicon)
- Claude Code
-
VOICEVOX —
voicevoice setupで自動インストール -
jq —
brew install jq
コマンド一覧
| コマンド | 説明 |
|---|---|
voicevoice setup |
初回セットアップ(VOICEVOX 自動インストール含む) |
voicevoice on |
読み上げ ON |
voicevoice off |
読み上げ OFF |
voicevoice status |
現在の状態確認 |
voicevoice config |
設定の確認・変更 |
voicevoice -l |
キャラクター一覧 |
voicevoice uninstall |
完全削除 |
おわりに
コーディング中にずっと画面を見ていなくても、ずんだもんが要点を教えてくれます。
ストレッチしながら、コーヒー入れながら、Claude の応答を聞く。そんな開発体験、わりとアリです。
リポジトリはこちら:
brew install john-rocky/tap/voicevoice
VOICEVOX のキャラクターボイスを公開利用する場合はクレジット表記が必要です(例:VOICEVOX:ずんだもん)。詳しくは VOICEVOX 利用規約 を参照してください。
🐣
最新のAI機能を使ったアプリやサービスを最速で試作したい。
そんなご要望にお応えします。
ご相談はこちらまで。
rockyshikoku@gmail.com