Copy That
Claude Code · 音声入力のエラー

Claude Code の音声入力が使えない?すべてのエラーと解決方法。

Claude Code に表示されたメッセージを下から探してください。メッセージごとに原因が異なり、ほとんどは 1 分以内に解決できます。

すぐできる対処法
  1. /voice を使うにはClaude.ai アカウントでのサインインが必要です。API キー、Bedrock、Vertex、Foundry では使えません。
  2. Claude Code が動いているマシンで録音するため、SSH 経由では使えません。VS Code Remote やクラウドセッションでも同様です。
  3. ふたを閉じた後、デバイスを変えた後、アップデートの後は新しいセッションを開始してください。
すべての原因と解決方法
  1. Unknown command: /voice または Voice mode requires a Claude.ai account

    Claude.ai でサインインしていないか、API キーやプロバイダの設定が優先されています。/login を実行し、ANTHROPIC_API_KEY、ANTHROPIC_AUTH_TOKEN、apiKeyHelper を削除して、Claude Code を再起動してください。

    出典:Claude Code のドキュメント。

  2. Voice mode is disabled by your organization’s policy

    管理者が音声入力をオフにしています。管理者に相談するか、Claude Code 以外の音声入力ツールを使ってください。

    出典:Claude Code のドキュメント。

  3. Microphone access is denied

    システム設定 → プライバシーとセキュリティ → マイク でターミナル(または VS Code)を許可します。一覧にない場合は、許可をリセットし、⌘Q で終了してから再度開きます。

    # Terminal: com.apple.Terminal · iTerm2: com.googlecode.iterm2
    # Ghostty: com.mitchellh.ghostty · Warp: dev.warp.Warp-Stable · VS Code: com.microsoft.VSCode
    tccutil reset Microphone com.apple.Terminal
    
    # Not sure of the bundle ID? Ask macOS:
    osascript -e 'id of app "iTerm"'

    出典:Claude Code のドキュメント。

  4. No audio detected from microphone

    無音が録音されています。多くの場合、セッションが変わってしまったデバイスやバイナリに紐づいています。新しいセッションを開始してください。すべての原因と解決方法 →

  5. No speech detected

    音声は届いたものの言葉が認識されていません。マイクに近づく、雑音を減らす、/config で言語を設定する。詳しく →

  6. Voice input is failing repeatedly and has been paused

    10 秒間に 3 回の失敗。たいていはマイクがない(SSH、コンテナ)か、許可が拒否されています。詳しく →

  7. Voice connection failed または Voice stream error: WebSocket upgrade rejected

    録音が文字起こしサービスに届いていません。ネットワークを確認してください。4xx ステータスの場合は、もう一度 /login を実行し、VPN やプロキシが邪魔していないか確認します。

    出典:Claude Code のドキュメント。

  8. Voice mode requires SoX for audio recording または could not find a working audio recorder in WSL

    Linux と WSL のみ。SoX をインストールします。WSL では SoX 用の PulseAudio フォーマットも必要です。

    sudo apt-get install sox                    # Linux
    sudo apt install sox libsox-fmt-pulse       # WSL with WSLg

    出典:Claude Code のドキュメント。

  9. Space を長押ししてもスペースが入力されるだけ

    スペースがたくさん入力される場合は、音声入力がオフです:/voice hold を実行します。1〜2 個しか入らない場合は OS のキーリピートがオフなので、代わりに /voice tap を使います。タップモードでは、最初のタップで録音を始めるにはプロンプトが空である必要があります。

    出典:Claude Code のドキュメント。

2026 年 10 月時点。Claude Code のドキュメントと GitHub の issue より。

または Mac のマイクを使わない

iPhone や Apple Watch をマイクに。

Copy That は iPhone や Apple Watch で録音し、Mac 上の Whisper で文字起こしして Claude Code に貼り付けます。Mac は何も録音しないので、ふた、AirPods、入力デバイス、Mac のマイク許可は関係なくなります。

Claude Code の音声入力 →

よくある質問
Claude Code の音声入力は API キー、Bedrock、Vertex で使える?
いいえ。音声入力には Claude.ai アカウントでのログインが必要です。Copy That はテキストを Claude Code に貼り付けるだけなので、どのログイン方法でも使えます。
Claude Code の音声入力はローカルで処理される?
いいえ。音声は文字起こしのために Anthropic にストリーミングされ、プロジェクト名と git ブランチがヒントとして送信されます。トークンは消費せず、使用量の上限にもカウントされません。Copy That は Mac 上の Whisper で文字起こしします。
VS Code Remote や SSH 経由で Claude Code の音声入力は使える?
いいえ。音声入力は Claude Code が動いているマシンで録音します。Copy That は、SSH で接続しているものも含め、Mac の目の前にあるどのターミナルにも貼り付けます。
こうしたエラーをまるごと避ける方法は?
Mac 以外のマイクを使うことです。Copy That は iPhone や Apple Watch で録音し、Mac 上の Whisper で文字起こしして Claude Code に貼り付けるので、Mac の入力デバイス、ふた、マイクの許可は関係ありません。
その他の対応ツール