Claude Code ガイド

Appearance

原文（日本語に翻訳） ​

Linux の音声モードを改善: SoX がインストールされているがオーディオキャプチャデバイスが存在しない場合に、「マイクなし」と「SoX 未インストール」を区別するようになった

原文（英語） ​

Improved voice mode on Linux: now distinguishes "no microphone" from "SoX not installed" when SoX is present but no audio capture device exists

概要 ​

Linux 環境での Claude Code 音声モードのエラーメッセージが改善されました。以前は SoX がインストールされていてもオーディオキャプチャデバイス（マイク）がない場合に、「SoX が未インストール」と誤ったエラーが表示されていました。修正後は「マイクが見つかりません」と正確なエラーメッセージが表示され、問題の特定と解決が容易になります。

基本的な使い方 ​

bash
# Linux での SoX インストール確認
which sox
sox --version

# マイクデバイスの確認
arecord -l          # ALSA デバイスの一覧
pactl list sources  # PulseAudio ソースの一覧

# Claude Code の音声モード起動（音声入力ショートカット使用）
claude

実践例 ​

エラーメッセージによるトラブルシューティング ​

修正前のエラー（誤ったメッセージ）:
"SoX がインストールされていません。音声入力を使用するには SoX をインストールしてください。"
→ SoX をインストールしようとしたが既にインストール済みで混乱する

修正後のエラー（正確なメッセージ）:
"マイクが見つかりません。オーディオキャプチャデバイスを接続してください。"
→ 正しい原因（マイク未接続）を特定して即座に対処できる

SoX のインストールとマイク確認 ​

bash
# Ubuntu/Debian での SoX インストール
sudo apt-get install sox

# インストール確認
sox --version
# Output: SoX v14.4.x ...

# マイクデバイスの確認
arecord -l
# card 0: PCH [HDA Intel PCH], device 0: ALC287 Analog [ALC287 Analog]
#   Subdevices: 1/1
#   Subdevice #0: subdevice #0

ヘッドレスサーバー環境での音声設定 ​

bash
# マイクなしのサーバー環境で音声入力を試みた場合の正確なエラー表示
# 仮想マイクデバイスのセットアップ例（必要な場合）
sudo modprobe snd-dummy

# 確認
arecord -l
# card 0: Dummy [Dummy], device 0: Dummy PCM [Dummy PCM]

Fedora/RHEL でのセットアップ ​

bash
# Fedora での SoX インストール
sudo dnf install sox

# マイクデバイスの確認
pactl list sources short
# 出力例: マイクデバイスが存在しない場合は空になる

注意点 ​

  • Linux 固有の改善です（macOS・Windows には適用されません）
  • SoX のインストール方法:
    • Ubuntu/Debian: sudo apt-get install sox
    • Fedora/RHEL: sudo dnf install sox
    • Arch Linux: sudo pacman -S sox
  • マイクが認識されない場合は ALSA や PulseAudio の設定を確認してください
  • 仮想環境やコンテナ環境では音声デバイスが利用できない場合があります

関連情報 ​