ブログ

MacのCursorで音声入力する方法:コードを壊さず指示を詳しく伝える

Mac版Cursorでプロンプトを音声入力し、説明とコードを分け、正確なコンテキストを追加して、実行前に安全に確認する方法を解説します。

執筆 tsuvic公開 読了約3分

Cursorでは、音声入力を使うとプロンプトの背景や制約を詳しく伝えやすくなります。ただし、音声に向いているのは意図、症状、期待する動作、変更してはいけない条件などの自然言語です。コード、ファイルパス、識別子、コマンド、エラー全文は、入力または貼り付ける方が安全です。

実用的なのは、音声とキーボードを分担する方法です。Cursorのチャット欄にカーソルを置き、問題を話し、正確な技術情報はCursorのコンテキスト機能で追加し、送信前に全体を読み直します。

コードではなく問題の説明を話す

音声は、なぜ変更が必要なのかを説明するときに強みがあります。現在の動作、望ましい動作、制約、試したこと、完了条件を話すと、短い命令だけでは失われる背景を残せます。

一方で、ファイルパス、関数名、パッケージのバージョン、正規表現、シェルコマンド、環境変数、スタックトレース、コンパイル対象のコードは音声認識に任せない方がよい情報です。一文字違うだけで、別のファイルや危険なコマンドを示す可能性があります。

たとえば「ログインコールバックはローカルでは成功するが、デプロイ後に失敗する。既存のセッション形式とDBスキーマは変更しない」と話します。その後、正確なエラーを貼り付け、関連コードを選択してコンテキストへ追加します。

入力と実行の間に確認を置く

Cursorの公式ショートカット資料では、チャット入力と、送信、キュー追加、変更の承認・拒否、生成コマンドの実行が別の操作として整理されています。キーバインドは変更できるため、環境によって操作が異なる場合もあります。

音声入力は、実行操作の前に終了させます。録音キーを離し、文章が正しい欄に入ったか、不要な言い直しが残っていないか、入力欄にフォーカスがあるかを確認してから送信します。

依存関係の変更、マイグレーション、削除、広範囲なリファクタリングを依頼するときは、この確認が特に重要です。音声は指示作成を速くするために使い、エージェントが動く前の確認工程を消すためには使いません。

正確なコンテキストはCursorの機能で渡す

長い説明だけでは、対象コードを正確に特定できません。Cursorでは、選択したコード、ファイル、クリップボードの内容などをチャットへ追加できます。Agentは探索、編集、ツール実行が可能で、Askは読み取り中心の調査に向いています。

音声では目的と判断基準を伝えます。選択範囲、ファイル参照、ログ、モード選択では、Cursorに与える証拠と権限を制御します。

原因がまだ不明ならAskで調査を始め、変更内容が明確になってからAgentへ移る方が安全です。

長い指示は短い区切りに分ける

長いプロンプトは、問題、期待する動作、制約、関連ファイル、検証方法のような短い区切りにすると確認しやすくなります。

各区切りを一回ずつ話し、見出し、ファイル名、コマンド、テスト名は入力します。一本の長い文字起こしよりも、後から追加した例外や禁止事項を見落としにくくなります。

「検証:既存の認証テストを実行し、スナップショットは更新しない」のように終了条件を明記すると、結果の評価もしやすくなります。

プロジェクト情報を話す前にプライバシーを確認する

Cursorは、AIリクエストがCursorのバックエンドを経由すると説明しています。現在のデータ利用資料では、Privacy Modeを有効にすると顧客データを学習に使用せず、文書化された安全上の例外を除いてモデル提供者とのゼロデータ保持契約を適用するとしています。Privacy Modeは無料・有料ユーザーのどちらでも利用できます。

ただし、設定が有効でも、秘密鍵、APIキー、アクセストークン、顧客の個人情報、本番認証情報、組織がAI送信を禁止するコードを話してよいわけではありません。チームの規則も確認します。

音声入力サービスには、Cursorへ届く前の音声・文字起こし処理があります。音声入力側とCursor側を別々に評価してください。

TalkTalkTypeを入力レイヤーとして使う

TalkTalkTypeはOption-Spaceを押している間に録音し、フォーカスされていた欄へ結果を戻します。Cursorでは、別の文字起こし画面を経由せず、現在のチャット欄に下書きを残せます。

Cleanは内容とトーンを保ちながら自然言語を軽く整え、Rawは元の文字起こしを多く残します。どちらもコードや識別子を推測して修正するためのモードではありません。正確な技術情報は後から貼り付け、結合したプロンプトを送信前に確認します。

Macのすべてのアプリで使える音声入力では、フォーカス欄への入力とクリップボードへのフォールバックを説明しています。

説明がボトルネックのときに音声を使う

Cursorで音声入力が役立つのは、バグがなぜ重要か、許容できるトレードオフ、変更してはいけないもの、成功の確認方法といった文脈を伝える場面です。

構文が中心の作業では、音声の利点は小さくなります。理由は話し、正確な文字列は入力し、証拠を添付し、送信前に確認する。この分担なら、詳細を失わずプロンプト作成を速くできます。

ブログ