方法 A: ワンコマンドセットアップ（推奨）

お好きな場所にクローンしてください。おすすめ:

• macOS / Linux: ~/Projects/ または ~/dev/
• Windows: C:\Users\<ユーザー名>\Projects\

macOS / Linux:

# 1. Star する（必須） → https://github.com/kubouchiyuya/claude-voice-notify
# 2. 好きなディレクトリに移動（例: ~/Projects）
cd ~/Projects

# 3. クローン
git clone https://github.com/kubouchiyuya/claude-voice-notify.git

# 4. ディレクトリに入る
cd claude-voice-notify

# 5. セットアップ実行（あとは全自動）
./setup.sh

Windows:

cd %USERPROFILE%\Projects
git clone https://github.com/kubouchiyuya/claude-voice-notify.git
cd claude-voice-notify
setup.bat

setup.sh / setup.bat が自動で行うこと：

セットアップ後にやること：

# 6. VOICEVOX を起動（まだの場合）
# 7. Claude Code Hooks を ~/.claude/settings.json にコピペ（画面の指示に従う）
# 8. テスト
./notify.sh "テスト成功"

# 9. 設定パネルでカスタマイズ（キャラ・速度・音量・エンジン）
./settings.sh

# 10. 完了！Claude Code が音声で通知してくれます

方法 B: 手動セットアップ

1. リポジトリを clone してビルド

git clone https://github.com/kubouchiyuya/claude-voice-notify.git
cd claude-voice-notify
npm install
npm run build

2. VOICEVOX をインストール（任意）

macOS:

# 公式サイトからダウンロード
open https://voicevox.hiroshiba.jp/

Windows:

# winget でインストール
winget install Hiroshiba.VOICEVOX

# または公式サイトからダウンロード
# https://voicevox.hiroshiba.jp/

インストールしなくても macOS say / Windows SAPI で動作します。

3. Claude Code Hooks を設定（再起動不要）

~/.claude/settings.json の hooks に追加：

macOS / Linux:

{
  "hooks": {
    "Stop": [
      {
        "matcher": "",
        "hooks": [
          {
            "type": "command",
            "command": "/path/to/claude-voice-notify/notify.sh 'タスクが完了しました' complete"
          }
        ]
      }
    ],
    "Notification": [
      {
        "matcher": "",
        "hooks": [
          {
            "type": "command",
            "command": "/path/to/claude-voice-notify/notify.sh '確認をお願いします' confirm"
          }
        ]
      }
    ]
  }
}

Windows:

{
  "hooks": {
    "Stop": [
      {
        "matcher": "",
        "hooks": [
          {
            "type": "command",
            "command": "powershell -ExecutionPolicy Bypass -File C:\\path\\to\\claude-voice-notify\\notify.ps1 'タスクが完了しました' complete"
          }
        ]
      }
    ],
    "Notification": [
      {
        "matcher": "",
        "hooks": [
          {
            "type": "command",
            "command": "powershell -ExecutionPolicy Bypass -File C:\\path\\to\\claude-voice-notify\\notify.ps1 '確認をお願いします' confirm"
          }
        ]
      }
    ]
  }
}

4. (任意) MCP サーバーも追加

~/.claude.json の mcpServers に追加すると、Claude が状況に応じたカスタムメッセージを読み上げられます：

{
  "mcpServers": {
    "voice-notify": {
      "command": "node",
      "args": ["/path/to/claude-voice-notify/dist/index.js"],
      "env": {
        "NOTIFY_PROVIDER": "voicevox",
        "VOICEVOX_SPEAKER": "1"
      }
    }
  }
}

5. テスト

# 直接テスト（即実行）
./notify.sh "テスト成功"

# Claude Code 経由（MCP設定後）
# → 「notify_test を実行して」

音量・速度調整

# 音量調整（0.0〜1.0、デフォルト: 1.0）
./notify.sh set-volume 0.5    # 半分の音量
./notify.sh set-volume 0.3    # 控えめ（会議中のお隣さん対策）
./notify.sh set-volume 1.0    # 最大音量

# 速度調整（0.5〜2.0、デフォルト: 1.0）
./notify.sh set-speed 1.2     # やや速め
./notify.sh set-speed 0.8     # ゆっくり

# 設定パネル（GUIライクな対話式メニュー）
./settings.sh

キャラクター管理

# 一覧表示（★ = 現在のデフォルト）
./notify.sh list

# デフォルトキャラを変更
./notify.sh set-speaker 8    # 春日部つむぎ

# 一時的に別キャラで喋らせる（デフォルトは変えない）
./notify.sh "メッセージ" complete 8

VOICEVOX キャラクター一覧（主要）

100+ キャラクターが利用可能。./notify.sh list で全一覧を確認できます。

共通

VOICEVOX

COEIROINK

AivisSpeech

Style-Bert-VITS2

Fish Audio

ElevenLabs

OpenAI TTS

Google Cloud TTS

Google Cloud TTS は月100万文字まで無料。./notify.sh set-provider google で切り替え。

1. Style-Bert-VITS2 をセットアップ
2. 自分の音声データで学習
3. 環境変数を設定：

{
  "env": {
    "NOTIFY_PROVIDER": "style_bert_vits2",
    "STYLE_BERT_VITS2_MODEL": "my-voice"
  }
}

Udemy や動画制作で使った自分の声をそのまま通知音声にすることもできます。

プロジェクトの CLAUDE.md に以下を追加すると、Claude Code が自動的に音声通知を使うようになります。 templates/CLAUDE.md を参照してください。

クローンした人はワンコマンドで最新版に更新できます：

./update.sh

• 更新内容を確認 → 確認後に git pull & npm run build を自動実行
• リリース通知を受け取るには、リポジトリを Watch > Releases only に設定してください

claude-voice-notify/
├── notify.sh          ← 音声通知の本体（bashから直接呼べる）
├── settings.sh        ← 設定パネル（キャラ・速度・音量・エンジン）
├── setup.sh           ← 初回セットアップ（自動インストール）
├── update.sh          ← ワンコマンド更新
├── .voice-config      ← 設定ファイル（自動生成・gitignore済み）
├── .voice-enabled     ← ON/OFF状態（自動生成）
├── src/               ← MCP サーバー本体（TypeScript）
│   ├── index.ts       ← MCPエントリーポイント
│   ├── provider-base.ts ← 音声再生共通処理
│   └── providers/     ← 各プロバイダー実装
├── dist/              ← ビルド済み（npm run build で生成）
├── templates/
│   └── CLAUDE.md      ← プロジェクトに組み込むテンプレート
├── vscode-extension/  ← VS Code 拡張機能
└── CLAUDE.md          ← Claude Code 用の設定指示

設定ファイル（.voice-config）の保存場所：

• クローンしたディレクトリ直下に自動生成されます
• Git にはコミットされません（.gitignore 済み）
• 手動で編集も可能（key=value 形式）