AI コーディングのための音声入力: タイピングせずに Cursor と Claude Code に音声プロンプト
変更をタイプする代わりに説明できると、vibe コーディングが速くなる。6 つの作例、私たちが収束したプロンプトパターン、そして多言語識別子の扱い方。
TL;DR
Cursor 音声プロンプトの方法、あるいは識別子をいちいち綴らずに Claude Code ディクテーションを正しく行う方法を探しているなら、これが実践ガイドです。AI コーディングのための音声入力が機能するのは、プロンプトの大半が散文だからです。コンテキスト、意図、制約、テスト期待値。Loqua はマルチモーダル画面コンテキスト、構造化プロンプトフォーマット、技術用語の扱い、文中 EN+中混合を加えます。最も報われる vibe コーディング音声ワークフロー: 長い Cursor プロンプト、Claude Code デバッグ、リファクタ仕様、テスト記述。短い「これを直して」プロンプトは音声でも速くないことが多く、勝利は密度の高い指示にあります。
Loqua は Mac 向けのコンテキスト認識型音声入力ツールで、あなたが作業しているものを見て、それに応じて出力を整形します。AI コーディングに特化して言えば、Cursor のチャットパネル、Claude Code のターミナル、ChatGPT のプロンプトボックスを検出し、それらのツールが最もよく扱う構造でプロンプトを生成できるということです。
これは生産性リスティクルのピッチではありません。私たちは自分たちの AI コーディングに毎日音声を使っていて、長い指示ではプロンプト作成時間を約半分に削減しています。そこが最大の勝利です。短いプロンプト(「これを直して」)は引き分け。長く構造化されたプロンプト(リファクタ仕様、複数ファイル変更、デバッグの語り)こそが音声が真価を発揮するところです。
なぜ音声が AI コーディングに合うのか
AI コーディングプロンプトの形はコードの形とは異なります。良いプロンプトには次のものがあります: コンテキストブロック(自分がどこにいるか、何を見ているか、何を試したか)、指示ブロック(何をしてほしいか)、制約(X を変えるな、Y を保持、Z テストに合格しなければならない)。これは散文であって構文ではありません — そして散文こそ音声が得意とするものです。
あなたはタイプするより速く考えます — 散文では簡単に 2 倍速いです。ボトルネックはあなたの思考モデルではなく、キー打鍵のコストです。複雑な状況を LLM に説明するプロンプトでは、この差が効きます。Loqua は基本的なディクテーションに三つを加えます: IDE 状態を見る(コンテキストブロックが自動で書ける)、プロンプトを構造的にフォーマットする(system + user、またはブレットステップリスト)、識別子をあなたに綴らせずに技術用語を扱う。
AI コーディング向けセットアップ
このセクションは Loqua がインストール済みであることを前提とします (Mac でコードをディクテーションするセットアップガイド参照)。AI コーディング固有の設定は一つだけ、Loqua のアクセシビリティ権限を付与することです。これによりアクティブアプリの選択範囲と近接テキストを読めるようになります。macOS アクセシビリティは developer.apple.com に文書化されています。スクリーンリーダーや自動化ツールが使うのと同じ API です。
身につける三つの習慣:
- ディクテーション前に選択する。 プロンプトに特定のブロックを対象にさせたければ、先に選択してください。Loqua は選択をコンテキストとして渡します。
- チャットパネルをインラインで開く。 Cursor ではチャットパネルが可視であることが、編集ではなくプロンプト中だと Loqua に伝えます。
- 構造的区切りのために一時停止。 半秒の停止はプロンプト内の段落区切りとして読まれます — コンテキストを指示から分離するのに有用です。
効くプロンプト構造
何ヶ月もの音声プロンプティングの末に、最もクリーンな LLM 挙動を生む三つの構造に収束しました。Loqua は発話開始のフレーミングを読んで、それに応じて出力を整形します。
| 最初に言うフレーミング | 出力形状 |
|---|---|
| 「これをリファクタして...」 | リファクタ: [ゴール]。制約: [選択から暗黙]。出力: [コード]。 |
| 「これをデバッグして — X すると Y が起きるが Z を期待していた」 | ステップ、期待、実際の物語的バグレポート。 |
| 「...の仕様を書いて」 | 構造化仕様: Goal / Inputs / Outputs / Edge cases / Tests。 |
| 「...のテストを追加して」 | テスト記述 + 受け入れ基準。 |
| 「なぜこのコードが...」 | 平易な散文、技術レジスタ。 |
6 つの作例
AuthClient を使うようにリファクタしてください。レガシーフォールバック経路を削除してください — コードベースの他では未使用と確認済み。パブリック関数シグネチャを保持してください。ステップ:
1. POST /search に
{ "query": "" } をボディとして送信2. サーバーが 500 を返す (期待: 空配列で 200)
仮説: 空文字列経路がアーリーリターンをスキップして、無効クエリでインデクサーに到達している。
修正: 空クエリ用のアーリーリターンを追加。
**Goal:** ユーザーが検索クエリを保存して後で再読み込みできる。
**Inputs:** 検索クエリ(文字列)、user id、オプションの名前(文字列、デフォルトはクエリの最初の N 文字)。
**Behavior:**
- ユーザーの saved-searches コレクションに永続化。
- 既存の user-data sync 経由でデバイス間同期。
- 名前で検索可能(大文字小文字無視のサブストリングマッチ)。
**Edge cases:** 名前重複 → インデックスサフィックス、ユーザー削除 → カスケード削除。
- 60 秒ウィンドウで 10 リクエスト送信 — すべて成功。
- 11 回目のリクエストは 429 を返すべき。
- レスポンスには残り秒数を含む
Retry-After ヘッダが含まれるべき。- 時間制御には既存のテストフィクスチャを使用。
userController.ts を三つのモジュールに分割 — authController、profileController、preferencesController。パブリック API 表面は不変に保ってください。新しい場所からインポートするようルーターを更新してください。動作変更なし。これは構造的リファクタのみ。merge 関数の現在の挙動をカバーするリグレッションテストを追加してください。リファクタが導入する可能性のあるドリフトを検出できるよう、既存の出力をスナップショットするテストにしてください。Loqua にファイルコンテキストを見せる
選択なしで「これをリファクタして」と言うと、Loqua は指示のみを送信します。テキストを選択していると、Loqua は何が選択されたかを説明する短いコンテキストブロック — ファイル名、行、周辺識別子 — を指示の前に含めます。コンテキストをディクテーションする必要はありません。マルチモーダルレイヤーがそれを読みます。
これは明示的コンテキストから恩恵を受ける AI ツール(特に Claude Code はファイルパスと行番号から恩恵を受ける)にとって重要です。Loqua のオムニモーダルスタックがこれを可能にします — 研究レベルの直観が欲しければ、より深いノート 音声と視覚の出会い: オムニモーダルディクテーション を参照してください。
文中 EN+中
私たちのエンジニアリングチームの議論の多くは、英語の技術用語を混ぜた中国語で行われます。このレジスタで AI ツールに音声プロンプトを送ることは日常活動です。Loqua はコードスイッチングをモード切り替えなしで扱います:
ツール横断での再利用
同じ音声フレーズを異なる AI ツールにディクテーションすると、適切に異なるプロンプトが生成されます。私たちは再フレーミングしません — Loqua がやります:
| ツール | Loqua が生成するプロンプト形状 |
|---|---|
| Cursor (チャットパネル) | 暗黙のファイルコンテキストを持つ会話的指示 |
| Claude Code (ターミナル) | 明示的ファイルパスと簡単な計画を持つ構造化指示 |
| ChatGPT (Web) | セクション付きの Markdown フォーマットプロンプト |
| Aider (ターミナル) | 対象パス付きの直接ファイル編集指示 |
声で一度書く。Loqua が宛先ごとに整形し直します。
落とし穴
- コードを文字単位でディクテーションしない。 音声はプロンプトの散文部分用です。コードは LLM に生成させてください。コードを文字単位でディクテーションしようとすると、本来の意義が失われます。
- 選択が重要。 選択コードを Loqua にコンテキストとして含めさせたければ、ディクテーション前に選択してください。そうしなければ指示のみが送信されます。
- 長い停止はディクテーションを終了させる。 1.5 秒の沈黙は発話終了として読まれます。文中で考えているときは、フィラーワードを使ってください — Loqua はフィラーを出力から取り除きますが、録音を開いたままにするために使います。
- Cursor のチャットパネル状態が重要。 パネルが可視でないと、Loqua はあなたのディクテーションをプロンプトではなくコード編集として扱う可能性があります。先にパネルを開いてください。
- 識別子を盲目的にディクテーションしない。 一般的でないカスタムライブラリ名がある場合は、設定の Personal Dictionary に追加するか、一つの単語として発音してください。
総合効果: 長い指示でのプロンプト作成時間が約半分になり、変更を命名するだけでなく意図を説明することを音声形式が促すので、プロンプト自体も良くなります。これが生のスピードよりも重要な部分です。より広い音声 AI コーディングパターン — Cursor 音声プロンプトフロー、Claude Code ディクテーション、長いセッション中にキーボードから手を離し続ける方法 — については、上記のコンパニオンガイドを参照してください。
音声が AI 業務に合う理由のより長い見解については、AI と一緒に考えるためにキーボードがなぜ間違った道具なのかを参照してください。
Frequently asked questions
Try Loqua today
Free to start. Mac native. Built by algorithm researchers who use it every day.
Download for Mac