トラブル解決Mac10 分で読めます
VS Code・ターミナルで音声入力できないときの対処法
VS Code やターミナルで音声入力できないのは、Electron アプリがクリップボードを遅れて読み、一部のターミナルが擬似キー入力を無視するためです。
Petal の開発元、Optimal Apps が公開しています。
このページの内容
VS Code、ターミナル、Claude Code で音声入力できない場合、原因はほぼ 2 つのどちらかです。1 つ目は、VS Code、Cursor、Slack などの Electron アプリがクリップボードを遅れて読み込む ことです。そのため、音声入力アプリが元のクリップボードを早く戻しすぎると、古い内容が貼り付けられます。2 つ目は、一部のターミナルやターミナルのアプリが擬似的なキー入力を無視する ことです。そのため、テキストを「打ち込む」タイプの音声入力アプリでは、何も入りません。対処法は、貼り付けに時間の余裕を持たせるか、音声入力アプリの入力方法を打ち込みからクリップボードの貼り付けに切り替えることです。
このガイドでは、2 つの原因を説明し、Superwhisper、VoiceInk、Wispr Flow、Aqua Voice の対処法を紹介してから、Petal がコードエディタをどう扱うかを説明します。
VS Code やターミナルで音声入力できないときのチェックリスト
| 症状 | 原因 | 対処法 |
|---|---|---|
| VS Code や Cursor に以前のクリップボードの内容が貼り付けられる | アプリが読み込む前にクリップボードが戻された | 復元の待ち時間を長くするか、文字起こしをクリップボードに残す |
| ターミナルに何も貼り付けられない | ターミナルが擬似的なキー入力を無視する | クリップボードの貼り付けか、アプリの「直前の文字起こしを貼り付け」のショートカットを使う |
| エディタには入るが、統合ターミナルには入らない | フォーカスが別のパネルにある | 音声入力の前にターミナルのパネルをクリックする |
| テキストが 2 回入る | 打ち込みと貼り付けの両方が実行された | そのアプリで「キー入力をシミュレート」をオフにする |
| ホットキーのあとに変な文字が入る、または貼り付けられない | Command-V のときに修飾キーが押されたまま | 貼り付けの前にすべてのキーを離す |
| どこにも貼り付けられない | アクセシビリティの許可がない | アプリのアクセシビリティを再設定する |
原因 1:Electron アプリがクリップボードを遅れて読み込む
ほとんどの Mac の音声入力アプリは、次の 4 つの段階で貼り付けます。
- 現在のクリップボードを保存する。
- 文字起こしをクリップボードに入れる。
- 手前のアプリに Command-V を送る。
- 元のクリップボードを戻す。
テキストエディットなどのネイティブアプリは、Command-V を受け取るとすぐにクリップボードを読み込みます。VS Code、Cursor、Slack、Discord などの Electron アプリは、少し遅れて読み込むことがあります。先に段階 4 が実行されると、アプリは元のクリップボードを貼り付けます。その結果、「VS Code で音声入力すると違うテキストが貼り付けられる」ように見えます。
クリップボードの遅い読み込みに対する各社の対処法
Superwhisper。 貼り付けのガイドでは、次のように案内しています。
- Settings > Configuration > Advanced settings を開き、Text input までスクロールします。
- Clipboard content を Replace with dictation にします。初期設定の Keep what I have copied は、貼り付けのあとに元のクリップボードを戻します。
- テストします。音声入力のたびに、それまでのクリップボードの内容は消えます。
同じページでは、エディタをクリックし、音声入力が終わるまでフォーカスを保つこと、モードの自動貼り付けが Default か On になっていることを確認するよう案内しています。
VoiceInk。 クリップボードのガイドでは、次のように案内しています。
- Settings > Pasting を開きます。
- Keep Clipboard Content をオンのままにします。
- Restore Delay を長くします。初期値は 2 秒で、250 ms から 5 秒の範囲で設定できます。
詳しくは VoiceInk で貼り付けられないとき を参照してください。
Aqua Voice。 Aqua の変更履歴には、v0.11.6 で VS Code と Cursor の貼り付けの不具合を修正したと書かれています。最新のバージョンにアップデートしてください。
Superwhisper で起きる同じ問題については、Superwhisper で以前のクリップボードの内容が貼り付けられるとき を参照してください。
原因 2:ターミナルが擬似的な入力を無視する
一部の音声入力アプリは、貼り付けをしません。擬似的なキーイベントでテキストを「打ち込み」ます。一部のターミナルのアプリは、本物のキー入力か本物の貼り付けだけを受け付け、それ以外を無視します。
anthropics/claude-code のリポジトリの GitHub の issue #51725 がその例です。報告者は Windows 11 で、Cursor の統合ターミナル(PowerShell)で Aqua Voice v0.14.2 を使っていました。音声入力したテキストは、通常の PowerShell のプロンプトでは入力できたのに、Claude Code のプロンプトでは何も表示されずに失われました。報告者の推測(確認はされていません)では、Aqua は擬似的なキー入力を送り、Claude Code はブラケットペーストだけを受け付けます。クリップボードを使う Aqua の Paste Last Transcript は動きました。この issue は、Windows での擬似的な貼り付けに関する別の報告の重複として閉じられました。
同じ考え方は Mac にも当てはまります。テキストが打ち込まれたキーとして届き、ターミナルのアプリがそれを無視する場合は、クリップボードの貼り付けに切り替えてください。
ターミナルに対する各社の対処法
Aqua Voice。 音声入力してから Paste Last Transcript を押します。Aqua の変更履歴によると、Mac の初期設定は Control-Command-V で、Settings で変更できます。
Wispr Flow。 Control-Command-V を押すと、直前の文字起こしを貼り付けます。Wispr のガイドでは、一部のターミナルや IDE は Control-Shift-V や右クリックでの貼り付けなど別の貼り付けのコマンドを使うので、ターミナルの貼り付けのコマンドを確認するよう案内しています。
Superwhisper。 貼り付けをブロックするターミナルでは、Text input で Simulate keypresses をオンにするようガイドで案内しています。仮想キーボードで結果を打ち込む設定です。試験的な機能で、US QWERTY 配列にのみ対応し、普通に貼り付けられるアプリでは 2 回貼り付けられることがあります。そのため、貼り付けに失敗するときだけオンにしてください。日本語入力を含む US QWERTY 以外の配列では、正しく動かない可能性があります。
VoiceInk。 標準の貼り付けで何も起きない場合は、Settings > Pasting > Paste Method を AppleScript にします。
原因 3:フォーカスと修飾キー
貼り付けの不具合のように見える小さな問題が 2 つあります。
- フォーカス。 VS Code では、エディタ、統合ターミナル、チャットのパネルはそれぞれ別の入力欄です。音声入力の前に使いたいパネルをクリックし、テキストが入るまでほかの場所をクリックしないでください。
- 押されたままの修飾キー。 音声入力のホットキーに Option や Control を使っていて、アプリが Command-V を送るときにまだ押していると、アプリは Option-Command-V や Control-Command-V を受け取ります。これは別のショートカットです。文字起こしができる前に、すべてのキーを離してください。
原因 4:アクセシビリティ
どのアプリにも何も貼り付けられない場合は、音声入力アプリにアクセシビリティの許可がありません。まずこれを直してください:Mac でアクセシビリティの許可が効かないとき。
Petal の VS Code、ターミナル、コーディングエージェントへの対応
Petal for macOS は、音声モデルを Mac 上で動かす、無料でオープンソースの音声入力アプリです。貼り付けの段階は、Electron アプリとターミナルを考慮して作られています。アプリのコードにもとづく動作は次のとおりです。
- 700 ms の復元の待ち時間。 Petal は文字起こしをクリップボードに入れて Command-V を送り、700 ms 後に元のクリップボードを戻します。コードのコメントには理由が書かれています。「Electron apps such as VS Code read the clipboard some time after Command-V, so an early restore pastes the old content.」
- 新しくコピーした内容を上書きしない。 その 700 ms の間に何かをコピーした場合、Petal は新しいコピーを残します。
- 打ち込みではなく本物の貼り付け。 Petal は Command-V を送るので、貼り付けを受け付けるターミナルのアプリには、貼り付けとしてテキストが届きます。
- 修飾キーが離されるのを待つ。 Petal は Command-V を送る前に、Option や Control などのキーが離されるまで最大 400 ms 待ちます。
- Restore Clipboard のスイッチ。 それでも古い内容が貼り付けられるアプリがある場合は、Settings > Recording で Restore Clipboard をオフにします。文字起こしはクリップボードに残ります。
コードエディタには Router を使う
Settings > Router では、アプリや Web サイトごとにルートを追加できます。ルートごとに別のスタイルを設定できます。
- As Said は、整形をせず、話したとおりの言葉を貼り付けます。書き換えによってコマンドが変わる可能性があるターミナルに使ってください。
- AI Prompt は「AI エージェント向けのプロンプトを書く」スタイルです。Claude Code、Codex、エディタのチャットのパネルに使ってください。
- Custom では、「コードの用語とファイル名は話したとおりに残す」などの独自の指示を書けます。
整形は、Petal W1 や Apple Intelligence で Mac 上で実行するか、自分のキーでクラウドのモデルを使って実行できます。詳しくは Mac でアプリごとに音声入力の整形を変える方法 を参照してください。
2 つ目のキーを押さずに送信する
Settings > General の Send Now を使うと、録音中に Control-X、続けて Control-S を押せます。Petal は録音を止めて貼り付け、Return キーを押します。ターミナルでは、これでプロンプトが実行されます。貼り付けに失敗したときのために、同じ画面で Paste Last Transcription のショートカットを登録しておくと、直前の文字起こしをもう一度貼り付けられます。
Aqua Voice を使っていてターミナルで失敗する場合は、Aqua Voice が使えないとき も参照してください。
よくある質問
VS Code で音声入力すると、以前のクリップボードの内容が貼り付けられるのはなぜですか?
多くの音声入力アプリは、文字起こしをクリップボードに入れて Command-V を送り、そのあと元のクリップボードを戻します。VS Code などの Electron アプリは、元に戻されたあとにクリップボードを読み込むことがあり、その結果、古い内容が貼り付けられます。アプリの復元の待ち時間を長くするか、文字起こしをクリップボードに残す設定にしてください。
Claude Code に音声入力したテキストが表示されないのはなぜですか?
GitHub の issue #51725 では、Windows の Claude Code で Aqua Voice のテキストが何も表示されずに失われたと報告されています。報告者は、Aqua が送る擬似キー入力を Claude Code が受け付けず、クリップボードからの貼り付けは動くと考えました。Paste Last Transcript など、貼り付けを使う方法を使ってください。
Mac のターミナルで Apple の音声入力は使えますか?
Apple の音声入力は、ターミナルを含むほとんどのアプリで、フォーカスがある入力欄に文字を入力します。ただし、ターミナルのアプリでは結果が安定しません。テキストが表示されない場合は、別のアプリに音声入力して貼り付けるか、Command-V で貼り付ける音声入力アプリを使ってください。
コードエディタだけ別の音声入力のスタイルを使えますか?
Petal の Router では、アプリごとに整形の方法を設定できます。ターミナルやエディタを As Said にすると、話したとおりに貼り付けます。コーディングエージェントには AI Prompt のプリセットを使えます。