Claude Voicevox — Development skill for Claude Code

claude-voicevox

Claude Code の応答を [VOICEVOX](https://voicevox.hiroshiba.jp/) で読み上げる CLI とフック。 **話速の調整**と、**複数ターミナルで同時に喋らないための読み上げキュー**を備えています。

ターミナルを注視していられないときに、Claude Code が何を返したかを耳で追うための道具です。

flowchart LR
    A["Claude Code
応答完了"] --> B["Stop フック
voicevoice-hook.sh"]
    B --> C{"有効化フラグ
~/.voicevoice_enabled"}
    C -->|なし| Z["即終了"]
    C -->|あり| D["transcript から
最後の応答を抽出"]
    D --> E["Markdown 除去
コード・表・URL"]
    E --> F{"長文?"}
    F -->|要約フィルタあり| G["VV_SUMMARIZER"]
    F -->|なし| H["500 文字で打ち切り"]
    G --> I["vv"]
    H --> I
    I --> J["VOICEVOX
audio_query → speedScale → synthesis"]
    J --> K{"他が読み上げ中?"}
    K -->|はい| L["順番待ち"]
    K -->|いいえ| M["afplay で再生"]
    L --> M

できること

機能	説明
話速の調整	VOICEVOX の speedScale を直接指定する (0.5〜2.0)
読み上げキュー	複数のターミナルから同時に呼ばれても、先着順に1つずつ読み上げる
セッション単位の打ち切り	同じセッションで新しい応答が来たら古い読み上げを止める。他の窓は止めない
読み上げ用の整形	コードブロック・表・URL・見出しなど、音声に向かない記法を落とす
要約フィルタの差し込み	VV_SUMMARIZER に任意のコマンドを設定すると、読み上げ前に要約できる

必要なもの

• macOS (Apple Silicon で確認。afplay を使用)
• VOICEVOX — 起動してエンジンが 127.0.0.1:50021 で待ち受けていること
• jq (brew install jq)
• curl / python3 / perl — macOS 標準で入っています
• Claude Code — 自動読み上げを使う場合のみ

インストール

git clone https://github.com/BoxPistols/claude-voicevox.git
cd claude-voicevox
./install.sh

インストーラは次を行います。

1. 依存コマンドと VOICEVOX エンジンの疎通を確認する
2. bin/vv を ~/.local/bin/vv に配置する
3. hooks/voicevoice-hook.sh を ~/.claude/hooks/ に配置する
4. ~/.claude/settings.json の Stop フックに登録する (元の設定は .bak に退避)
5. ~/.config/voicevoice/config.json を作成する (既存があれば維持)

何が起きるかだけ見たい場合は `./install.sh --dry-run`、 リポジトリ