Claude Code ガイド

Appearance

原文（日本語に翻訳） ​

音声起動に失敗した後（モジュール読み込みの競合状態、コールド GrowthBook による）、音声のスペースバーが動かなくなっていた問題を修正しました

原文（英語） ​

Fixed voice space bar getting stuck after a failed voice activation (module loading race, cold GrowthBook)

概要 ​

Claude Code の音声入力機能では、スペースバーを押して音声録音を開始できます。音声モジュールの読み込み中の競合状態（race condition）や GrowthBook（機能フラグサービス）のコールドスタート時に音声起動が失敗すると、スペースバーが反応しなくなる（スタック状態になる）バグがありました。修正後は音声起動に失敗してもスペースバーが正常な状態に戻ります。

基本的な使い方 ​

bash
# 音声機能を使用（スペースバーを押して話す）
claude

# スペースバーを押す → 音声録音開始
# スペースバーを離す → 音声認識して送信

# 修正後: 音声起動に失敗してもスペースバーが正常に動作する

実践例 ​

音声入力の基本的な使い方 ​

Claude Code での音声入力:
1. スペースバーを押したままにする → 録音開始
2. 話す:「このファイルをリファクタリングしてください」
3. スペースバーを離す → 音声認識・送信

修正前:
- 音声起動に失敗した後、スペースバーが反応しなくなる
- Claude Code を再起動しないと解消できなかった

修正後:
- 音声起動に失敗しても、スペースバーが正常な状態に戻る
- 再起動不要

音声起動が失敗しやすい状況 ​

bash
# 音声起動失敗の原因:
# 1. 初回起動時（モジュールのコールドロード）
# 2. GrowthBook 機能フラグサービスの応答遅延
# 3. マイクの権限エラー
# 4. オーディオデバイスの接続問題

# 修正後: これらの状況で失敗してもスペースバーは正常に使える

音声機能のトラブルシューティング ​

bash
# 音声機能が使えない場合の確認事項
# 1. マイクのアクセス権限を確認（macOS）
#    システム設定 → プライバシーとセキュリティ → マイク

# 2. 音声機能が有効になっているか確認
/voice
# または設定を確認

注意点 ​

  • 音声機能はすべての環境で利用できるわけではありません（機能フラグによる制御）
  • スペースバーがスタックした場合、修正前はアプリの再起動が必要でした
  • GrowthBook は Claude Code の機能フラグを管理するサービスで、初回アクセス時に若干の遅延があります
  • 音声機能はアクセシビリティや手放し操作のために有用です

関連情報 ​