3
4

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

Claude Code の応答をずんだもんが読み上げてくれる CLI を作った

3
Posted at

ずんだもんに読み上げてもらう

Claude Code、便利ですよね。ただ、長い応答が返ってくると画面を凝視し続けることになります。

「これ、読み上げてくれたら画面見なくていいのでは?」

そう思って作りました。Claude Code の応答をリアルタイムで読み上げる CLI ツール voicevoice です。

デフォルトの声は ずんだもん。あの声で Claude の応答を読んでくれます。

デモ動画はこちら(GitHub)

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 コマンドは以下を自動でやってくれます:

  1. VOICEVOX がなければインストール(DMG をダウンロード → /Applications にコピー)
  2. フックスクリプトを生成~/.claude/hooks/voicevoice-hook.sh
  3. Claude Code の settings.json にフック登録

既存の設定は壊しません。2回実行しても重複登録されません。

アンインストール

voicevoice uninstall

これだけで:

  • settings.json からフック登録を削除(他の設定はそのまま)
  • フックスクリプトを削除
  • 設定ファイル・フラグファイルをすべて削除

セットアップ前と完全に同じ環境に戻ります。 試してダメだったら一瞬で消せるので、気軽に入れてみてください。

必要なもの

  • macOS 14 以降(Apple Silicon)
  • Claude Code
  • VOICEVOXvoicevoice setup で自動インストール
  • jqbrew 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

Twitter
Medium
GitHub

3
4
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
3
4

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?