音声ディクテーション

​

要件

• Claude.ai アカウント：音声テキスト変換サービスは Claude.ai アカウントで認証した場合にのみ利用可能であり、Claude Code が Anthropic API キー、Amazon Bedrock、Google Cloud の Agent Platform、または Microsoft Foundry を直接使用するように設定されている場合は利用できません。
• ローカルマイク：音声ディクテーションは Web 上の Claude Codeや SSH セッションなどのリモート環境では機能しません。
• WSL で Claude Code を実行する場合は WSLg：WSLg は Windows 10 または 11 の Microsoft Store からインストールされた WSL2 に含まれています。WSLg が利用できない場合（例えば WSL1 など）は、代わりにネイティブ Windows で Claude Code を実行してください。

​

音声ディクテーションを有効にする

/voice
Voice mode enabled (hold). Hold space to record. Dictation language: en (/config to change).

{
  "voice": {
    "enabled": true,
    "mode": "tap"
  }
}

​

長押しして録音

> refactor the auth middleware to ▮
  # hold space, speak "use the new token validation helper"
> refactor the auth middleware to use the new token validation helper▮

​

タップして録音して送信

​

録音をキャンセルする

​

音声ディクテーション言語を変更する

{
  "language": "japanese"
}

​

音声ディクテーション キーをリバインドする

{
  "bindings": [
    {
      "context": "Chat",
      "bindings": {
        "meta+k": "voice:pushToTalk",
        "space": null
      }
    }
  ]
}

​

トラブルシューティング

• Voice mode requires a Claude.ai account：API キーまたはサードパーティプロバイダーで認証されています。/login を実行して claude.ai アカウントでサインインしてください。
• Voice mode is disabled by your organization's policy：組織の管理者ポリシーが音声ディクテーションをオフにしています。組織の管理者に連絡して、組織で音声ディクテーションが利用可能かどうかを確認してください。
• Microphone access is denied：システム設定でターミナルにマイク権限を付与してください。macOS では、システム設定 → プライバシーとセキュリティ → マイク に移動してターミナルアプリを有効にしてから、/voice を再度実行してください。Windows では、設定 → プライバシーとセキュリティ → マイク に移動してデスクトップアプリのマイクアクセスをオンにしてから、/voice を再度実行してください。ターミナルが macOS 設定に表示されていない場合は、Terminal not listed in macOS Microphone settings を参照してください。
• Voice mode requires SoX for audio recording on Linux：ネイティブオーディオモジュールを読み込めず、フォールバックがインストールされていません。エラーメッセージに表示されているコマンドで SoX をインストールしてください。例えば sudo apt-get install sox です。
• Voice mode requires a microphone, but SoX could not open an audio capture device：SoX はインストールされていますが、ホストにオーディオキャプチャデバイスがありません。例えば、ヘッドレスサーバーまたはコンテナです。マイクを備えたマシンで Claude Code を実行してください。v2.1.195 以降、Linux 上の Claude Code はこの状況でこのメッセージを報告します。以前のバージョンは、SoX がすでにインストールされている場合でも SoX をインストールするよう求めていました。
• Voice mode could not find a working audio recorder in WSL：WSLg は ALSA デバイスではなく PulseAudio を通じてオーディオをルーティングするため、SoX は PulseAudio バックエンドを明示的にインストールする必要があります。sudo apt install sox libsox-fmt-pulse を実行してください。sox だけをインストールすると ALSA バックエンドが引き込まれますが、WSL では /dev/snd デバイスがないため記録できません。
• Voice input is failing repeatedly and has been paused：音声ディクテーションが 10 秒以内に 3 回の失敗に達しました。Claude Code は最初の失敗から 10 秒が経過するまでディクテーションを一時停止します。これは通常、このホストのマイクまたはオーディオスタックがオーディオをキャプチャできないことを意味します。例えば、ヘッドレスサーバー、オーディオパススルーのないリモートシェル、またはマイク権限が拒否されている場合です。動作する入力デバイスを確認し、上記のエントリから根本原因を修正してから、音声を再度トリガーしてください。v2.1.202 より前は、起動時の失敗のみが一時停止にカウントされていました。
• ホールドモードで Space を押し続けても何も起こらない：押し続けている間、プロンプト入力を監視してください。スペースが蓄積し続ける場合、音声ディクテーションがオフになっている可能性があります。/voice hold を実行して有効にしてください。1 つまたは 2 つのスペースだけが表示されてから何も起こらない場合、音声ディクテーションはオンですがホールド検出がトリガーされていません。ホールド検出はターミナルがキーリピートイベントを送信する必要があるため、OS レベルでキーリピートが無効になっている場合、押し続けているキーを検出できません。キーリピート要件を回避するために /voice tap でタップモードに切り替えてください。
• タップモードで Space をタップするとスペースが入力され、記録されない：最初のタップは、プロンプト入力が空の場合にのみ記録を開始します。入力を最初にクリアするか、/voice tap を実行してタップモードであることを確認してください。
• No audio detected from microphone：記録が開始されましたが、無音がキャプチャされました。正しい入力デバイスがシステムデフォルトとして設定されており、その入力レベルがミュートされていないか、ゼロに近くないことを確認してください。Windows では、設定 → システム → サウンド → 入力 を開いてマイクを選択してください。macOS では、システム設定 → サウンド → 入力 を開いてください。
• Voice connection failed：接続に失敗したため、記録が文字起こしサービスに到達しませんでした。ネットワークを確認して、もう一度試してください。オーディオをキャプチャしない記録は、このメッセージの代わりに No audio detected from microphone を報告します。v2.1.200 より前は、無音マイクが接続失敗を報告する可能性があり、実際の問題が入力デバイスであるのに、ネットワーク問題を示唆していました。
• Voice stream error: WebSocket upgrade rejected with HTTP <status>：サーバーが表示された HTTP ステータスで接続を拒否したため、これはネットワーク障害ではありません。400 範囲のステータスは通常、古いサインイン、またはプロキシもしくはボット保護サービスが文字起こしサービスの代わりに応答していることを意味します。/login を実行してサインインを更新し、ステータスが続く場合はネットワークパス上の VPN またはプロキシを確認してください。拒否が到着したときにまだ記録中の場合、Claude Code は 400 範囲外のステータスを 1 回再試行してからこのメッセージを表示します。400 範囲のステータスは再試行しません。v2.1.229 から v2.1.231 では、ネイティブビルドはこのメッセージを表示しませんでした：Claude Code は記録を続け、ホールドモードフッターは listening… を表示し続け、記録を停止した後に Voice connection failed を報告しました。
• No speech detected：オーディオは文字起こしサービスに到達しましたが、単語は認識されませんでした。マイクに近づいて話し、背景ノイズを減らし、ディクテーション言語 が話している言語と一致することを確認してください。
• 文字起こしが乱れているか、言語が間違っている：ディクテーションはデフォルトで英語です。別の言語でディクテーションしている場合は、最初に /config で設定してください。ディクテーション言語を変更する を参照してください。

​

Terminal not listed in macOS Microphone settings

​

関連項目

• キーボード ショートカットをカスタマイズする: voice:pushToTalk および他の CLI キーボード アクションをリバインドする
• すべての設定: voice、language、およびその他の設定キー
• インタラクティブ モード: キーボード ショートカット、入力モード、およびセッション コントロール
• コマンド: /voice、/config、およびその他すべてのコマンドのリファレンス