Claude Code ガイド

Appearance

原文（日本語に翻訳） ​

マイクが無音をキャプチャした場合のエラーメッセージを改善し、「音声が検出されませんでした」との区別ができるようにしました。

原文（英語） ​

Improved error message when microphone captures silence to distinguish from "no speech detected"

概要 ​

音声モードを使用する際、マイクが無音を検出した場合と「音声が検出されない」場合で異なるエラーが発生しますが、以前はどちらも同様のメッセージで表示されていました。今回の改善により、「マイクが無音を検出した（マイクは動作しているが音が入力されていない）」と「音声認識で音声が検出されなかった」のメッセージが明確に区別されるようになり、問題の診断が容易になりました。

基本的な使い方 ​

bash
claude --voice

# 改善前:
# マイクが無音の場合: "No speech detected" → 原因が不明確
# 音声認識失敗の場合: "No speech detected" → 同じメッセージで混乱

# 改善後:
# マイクが無音の場合: "Microphone captured silence - check if microphone is working"
#                    （マイクが無音をキャプチャ - マイクが動作しているか確認してください）
# 音声認識失敗の場合: "No speech detected" → 音声認識の問題と明確に区別

実践例 ​

マイクの無音検出時のメッセージ ​

bash
claude --voice

# push-to-talkキーを押して話す
# → マイクが接続されているが音量が低い場合:

# 改善後のエラーメッセージ:
# "Microphone captured silence — please speak louder or check microphone input level"
# （マイクが無音を検出しました。大きな声で話すか、マイクの入力レベルを確認してください）

# vs. 音声認識の問題:
# "No speech detected — please try again"
# （音声が検出されませんでした。もう一度お試しください）

トラブルシューティングでの活用 ​

bash
# エラーメッセージで問題を判断する

# "Microphone captured silence" が表示される場合:
# → マイクは認識されているが音が入力されていない
# → 対処法: マイクの音量を上げる、マイクに近づく、マイクのミュートを解除する

# "No speech detected" が表示される場合:
# → 音は入力されたが音声認識に失敗した
# → 対処法: よりはっきり話す、ノイズの少ない環境で使用する

音声モードの設定確認 ​

bash
# 音声入力の問題が続く場合の確認手順

# 1. マイクの入力レベルを確認（OS設定）
# macOS: システム設定 > サウンド > 入力
# Windows: 設定 > システム > サウンド > 入力デバイス

# 2. エラーメッセージで問題の種類を特定
claude --voice
# → "Microphone captured silence": ハードウェア/設定の問題
# → "No speech detected": 音声認識の問題

# 3. 適切な対処を実施

注意点 ​

  • エラーメッセージは英語で表示されますが、今後ローカライズされる可能性があります
  • 「Microphone captured silence」はマイクが物理的に接続されていて動作しているが、音入力がない状態を示します
  • 「No speech detected」は音声データは受信したが、音声認識エンジンが音声パターンを検出できなかった状態です
  • 周囲のノイズが大きい場合、実際の音声が検出されにくくなることがあります
  • Windowsでの音声モードの問題は別の修正（2.1.70-windows-voice-mode-fix）も参照してください

関連情報 ​