Mac で Claude Code の /voice を設定し、送信前に確認する方法。Space、マイク、SSH の問題と、標準の音声入力や ListenIn の使い分けを解説します。
要点
Claude Code の /voice は Claude.ai 認証、ローカルマイク、クラウドでの文字起こしが必要です。送信前に確認するなら hold モードで自動送信を無効にします。別の Mac 入力アプリが必要かは、言語・入力先・データ処理の条件で判断できます。
音声会話と音声入力を分けて考える
音声入力は発話を文字のプロンプトにします。双方向の音声会話では回答も読み上げます。Anthropic の説明は両者を区別しています。ここでは Claude Code CLI の /voice を扱い、Claude の全アプリのマイク機能を同一視しません。
Mac で送信前に確認できる設定
- ローカルのターミナルで Claude Code を開き、Claude.ai アカウントで認証して
/voice holdを実行します。 - ターミナルへのマイク許可を与え、
/configで話す言語を設定します。 - 入力欄で Space を押し続け、録音表示を確認してから、機密情報を含まない短い指示を話して放します。
- 文字を確認してから Enter で送信します。次の設定を
~/.claude/settings.jsonに既存の設定を残して統合すると、自動送信を明示的に無効化できます。
{
"voice": {
"enabled": true,
"mode": "hold",
"autoSubmit": false
}
}
公式の音声入力ガイドによると、hold は通常下書きを残します。tap は3語以上の文字起こしを自動送信する場合があり、15 秒の無音または合計2分で停止します。文字起こしは /usage の対象外ですが、送信後のエージェント処理は別です。API キー直接利用や第三者プロバイダー構成は、この音声サービスの対象ではありません。
反応しないときの確認順序
| 症状 | 最初に確認すること |
|---|---|
/voice が使えない・認証を求められる | 使用中の認証方式と組織のポリシー。業務用設定を安易に消さない |
| Space で空白だけが増える | hold の有効化とターミナルのキーリピート |
| tap が始まらない | 開始時は入力欄を空にする。自動送信にも注意 |
| マイク拒否・無音 | ターミナルの権限と macOS の「サウンド → 入力」を別々に確認 |
| SSH・VS Code Remote | 標準の録音にはローカルマイクが必要。手元で作った文字を貼り付ける方法を検討 |
2026 年 10 月 21 日確認の公式一覧には日本語、韓国語、フランス語、ドイツ語、スペイン語があります。中国語は記載されていません。中国語で回答できることと中国語の文字起こしは別です。日本語が目的なら、まず標準機能が要件に合うか試せます。
ListenIn を選ぶ場面
単純な文字入力なら Apple の音声入力も候補です。アプリをまたぐ共通キー、口述した要求の整理、中国語と英語の混在が必要なら、独立した ListenIn を検討できます。公開版は 2026 年 10 月 17 日の v0.3.8(ビルド 45)で、macOS 14 以降が必要です。同一音声による速度・精度比較は行っておらず、用語の完全な認識を保証しません。
説明用の例として、Mac の SSH クライアントで Claude Code の入力欄に「失敗したテストの理由を説明して。ファイルは変更しないで」と入力し、制約を確認して送信します。マイク転送ではなくローカルからの文字入力です。コピー用カードが出たら正しい欄を選び、手動で貼り付けます。折りたたまれた貼り付け表示だけで欠落と判断せず、下書きを確認してください。
ローカル音声とクラウド処理の境界
ListenIn の音声認識は Mac 上で行います。標準の文章整理は文字をサービスとモデル提供者に送ります。ローカル Ollama モデルとオフラインモードなら端末内で整理できますが、モデルの取得、Ollama のクラウド機能無効化、サービスの起動が前提です。Claude Code に送信した後は、そのデータ方針が適用されます。英語のデータ処理説明も確認してください。記事の日本語化は、アプリ画面やすべての認識モデルの日本語対応を意味しません。
Mac 版をダウンロードして、実際の入力欄で非機密の指示を一つ試し、語句・制約・入力先を確認して判断できます。