◉ANTIGRAVITY LABEN
記事一覧/Editor View
⟐ Editor View/2026-03-16中級

Aqua Voice — 声だけで開発するセットアップと運用

Aqua Voiceを使用して、キーボードなしで音声コマンドのみでアプリ開発を実行。完全ハンズフリーワークフローの実装とベストプラクティスを解説

Aqua Voice音声コーディングハンズフリー開発音声開発VS Code5Claude Code8Cursor20

取り組みの背景

現代の開発環境では、常にキーボードに向かっていることが前提とされています。しかし Aqua Voice を使用すれば、音声コマンドのみでアプリケーション開発を完結させることが可能です。

本ガイドは、Aqua Voiceを使った完全ハンズフリーワークフローを実現するための実践的な知識をお届けします。既存の音声コーディング概要記事とは異なり、「どのように実務開発を音声で行うか」に焦点を当てています。

Aqua Voice とは

Aqua Voice は、macOS と Windows で動作する高精度音声認識エディタプラグインです。以下の特徴があります：

  • 高精度認識: 自然言語処理による99%以上の精度
  • リアルタイム処理: 遅延最小限の音声入力
  • 複数エディタ対応: VS Code、Cursor、JetBrains IDE など
  • カスタマイズ可能: ユーザー定義コマンドと略語設定
  • オフライン動作: インターネット接続不要（ローカル処理）

セットアップ

macOS での設定

1. システムマイク権限の付与

# Aqua Voice にマイクアクセス権を付与
# システム設定 > セキュリティとプライバシー > マイク
# Aqua Voice をリストに追加

2. Aqua Voice のインストール

brew install aqua-voice

または、公式サイト からダウンロード。

3. VS Code 拡張のインストール

  1. VS Code を開く
  2. 拡張機能 (Cmd+Shift+X) から「Aqua Voice」を検索
  3. 「Install」をクリック

4. 初期設定

aqua-voice setup --platform macos

対話的に以下を設定：

  • マイク選択（外部マイク推奨）
  • 言語（日本語または英語）
  • ホットキー（例: Option+V で起動）

Windows での設定

1. システムマイク権限の付与

設定 > プライバシーとセキュリティ > マイク > アプリのマイクアクセスを許可

2. Aqua Voice のインストール

choco install aqua-voice

または、公式サイトからダウンロード。

3. VS Code 拡張のインストール

  1. VS Code を開く
  2. 拡張機能 (Ctrl+Shift+X) から「Aqua Voice」を検索
  3. 「Install」をクリック

4. 初期設定

aqua-voice setup --platform windows

音声コマンドの基本

起動と停止

「リッスン開始」 → マイクアイコンが赤色に変わり、音声入力待機状態に
「リッスン終了」 → マイク停止

ファイル操作

ファイル作成

「新規ファイル」+ 「ファイル名は index.js」
→ index.js が作成される

ファイルを開く

「ファイルを開く」+ 「App.tsx」
→ App.tsx が VS Code で開かれる

ファイル保存

「保存」
→ 現在のファイルが保存される

「全て保存」
→ 全ファイルが保存される

ファイル削除

「削除」+ 「確認」
→ 現在のファイルが削除される

ナビゲーション

行番号への移動

「ゴー トゥ ライン」+ 「42」
→ 42行目に移動

シンボルへジャンプ

「ゴー トゥ シンボル」+ 「handleClick」
→ handleClick 関数に移動

検索

「検索」+ 「useState」
→ useState をプロジェクト内で検索

置換

「置換」+ 「oldName」+ 「newName」
→ oldName を newName に置換

エディタ操作

カーソル移動

「カーソル ライン エンド」→ 行末に移動
「カーソル ライン スタート」→ 行頭に移動
「カーソル ワード フォワード」→ 次の単語に移動
「カーソル ワード バック」→ 前の単語に移動

選択

「セレクト ライン」→ 現在行を選択
「セレクト ワード」→ 現在の単語を選択
「セレクト オール」→ 全て選択

コピー・ペースト・削除

「コピー」→ 選択テキストをコピー
「カット」→ 選択テキストをカット
「ペースト」→ クリップボードから貼り付け
「デリート」→ 選択テキストを削除
「アンドゥ」→ 操作を戻す
「リドゥ」→ 操作をやり直す

VS Code / Cursor との統合設定

Aqua Voice の設定ファイル編集

# 設定ファイルを開く
aqua-voice config edit

JSON 形式の設定例：

{
  "language": "ja",
  "editor": "vscode",
  "hotkey": "alt+v",
  "autoCommit": true,
  "suggestions": true,
  "customCommands": [
    {
      "voice": "コンポーネント作成",
      "action": "create-react-component"
    },
    {
      "voice": "テスト実行",
      "action": "run-tests"
    }
  ]
}

Cursor への統合

Cursor（Claude が統合されたエディタ）使用時：

  1. Aqua Voice 拡張をインストール
  2. Cursor 設定ファイルを編集：
{
  "aqua-voice.enabled": true,
  "aqua-voice.language": "ja",
  "aqua-voice.claudeIntegration": true
}
  1. Aqua Voice コマンドから Claude に指示を直接送信可能：
「Claude に聞く」+ 「このコンポーネントのリファクタリング提案をして」
→ Claude がコード解析と提案を実行

カスタムホットキー設定

aqua-voice hotkey set --trigger "cmd+shift+v" --action "voice-input"

音声でのコード記述テクニック

変数名の発音方法

プログラミングの変数名は、特殊なルールで音声入力します：

キャメルケース

「キャメル handleButtonClick」
→ handleButtonClick が入力される

「キャメル getUserData」
→ getUserData が入力される

スネークケース

「スネーク user_profile」
→ user_profile が入力される

「スネーク max_width」
→ max_width が入力される

パスカルケース

「パスカル UserProfile」
→ UserProfile が入力される

括弧とブレースの指定

「オープンパレン」→ (
「クローズパレン」→ )
「オープンブレース」→ {
「クローズブレース」→ }
「オープンブラケット」→ [
「クローズブラケット」→ ]

演算子とシンボル

「プラス」→ +
「マイナス」→ -
「アスタリスク」→ *
「スラッシュ」→ /
「イコール」→ =
「ダブルイコール」→ ==
「トリプルイコール」→ ===
「ノットイコール」→ !=
「アンドアンド」→ &&
「オアオア」→ ||
「パイプ」→ |
「ドット」→ .
「セミコロン」→ ;
「コロン」→ :
「コンマ」→ ,
「アット」→ @
「ハッシュ」→ #

改行とインデント

「改行」→ Enter キーを押す（新規行に移動）
「インデント」→ Tab キーを押す（インデント追加）
「アウトデント」→ Shift+Tab（インデント削除）

Claude Code との連携

音声指示による自動コード生成

Cursor または Claude Code 統合環境では、音声で Claude に直接指示を送信できます：

「Claude に聞く」+ 「React の Counter コンポーネント作成」
→ Claude がコンポーネント実装を自動生成

「Claude に聞く」+ 「useEffect で API 呼び出し追加」
→ Claude が該当部分を修正・追加

複数ファイルの同時操作

「複数ファイル編集開始」
「App.tsx に import 追加」
「utils.ts に関数作成」
「編集完了」
→ 複数ファイルが一括更新される

コード生成後の確認

音声で Claude に生成内容の確認を依頼：

「Claude に聞く」+ 「このコードでエラーはないか確認」
→ Claude が静的解析と提案を実行

デバッグ・テスト実行を声だけで

テストの実行

「テスト実行」→ npm test が実行される
「テスト App」→ App.test.js が実行される
「カバレッジ」→ coverage レポートが生成される

ビルド実行

「ビルド」→ npm run build が実行される
「ビルド プロダクション」→ 本番ビルドが実行される

デバッガーの起動

「デバッガー開始」→ VS Code デバッガーが起動
「ブレークポイント」+ 「現在行」→ 現在行にブレークポイント設定
「コンティニュー」→ 実行を再開
「ステップオーバー」→ 次のステップに進む
「ステップイン」→ 関数内に入る
「ステップアウト」→ 関数から抜ける

サーバー起動

「サーバー開始」→ npm start が実行される
「サーバー停止」→ サーバーが停止される

実践例：React コンポーネント作成フロー

では、実際に音声だけで React コンポーネントを作成するの全体フローを見てみましょう。

ステップ 1: ファイル作成

「新規ファイル」+ 「ファイル名は Counter.jsx」

VS Code に Counter.jsx が作成されます。

ステップ 2: インポート文の追加

「タイプ」+ 「import React, { useState } from 'react';」

または Claude に委譲：

「Claude に聞く」+ 「必要な import を追加して」

ステップ 3: コンポーネント骨組みの作成

「Claude に聞く」+ 「Counter という関数コンポーネントの基本構造を作成」

Claude が自動的に以下を生成：

export default function Counter() {
  const [count, setCount] = useState(0);
 
  return (
    <div>
      <p>Count: {count}</p>
      <button onClick={() => setCount(count + 1)}>
        Increment
      </button>
    </div>
  );
}

ステップ 4: スタイル追加

「クローズブレース」→ } の前に移動
「改行」+ 「改行」
「タイプ」+ 「const styles = { ... }」

または：

「Claude に聞く」+ 「Tailwind CSS でコンポーネントをスタイル」
→ className 属性が自動追加される

ステップ 5: テストファイル作成

「新規ファイル」+ 「ファイル名は Counter.test.jsx」
「Claude に聞く」+ 「Counter コンポーネントの単体テストを生成」

ステップ 6: テスト実行

「テスト実行」
→ npm test が実行され、テスト結果が表示される

ステップ 7: ファイル保存

「全て保存」

ステップ 8: 動作確認

「サーバー開始」
→ npm start が実行され、ブラウザで動作確認可能

この一連の流れがすべて音声コマンドで完結します。

音声開発のベストプラクティス

マイク選択

  1. 外部マイク推奨: 内蔵マイクより高精度
  2. ノイズキャンセリング機能: 背景音の除去
  3. マイク位置: 口から 15-20cm の距離が最適

推奨モデル：

  • Blue Yeti（USB）
  • Audio-Technica AT2020
  • Shure SM7B

発音のコツ

  • はっきり話す: 機械的になりすぎず、自然な発音
  • ポーズを入れる: 複雑なコマンドは句切りを挟む
  • 方言を避ける: 標準日本語または標準英語

効率的なワークフロー設計

  1. 声で効率的な操作: 複雑な入力は Claude に委譲
  2. 複数コマンドの組み合わせ: マクロ機能で高速化
  3. 定期的なBreak: 音声入力は疲労しやすい

認識エラー時の対応

「訂正」+ 「正しいテキストを入力」
→ 直前の入力が修正される

「最後を削除」
→ 直前に入力したテキストを削除

「やり直し」
→ 最後のコマンドを取り消す

音声開発の限界と注意点

認識の正確性に依存

完全な音声開発は理想的ですが、以下のシナリオでは音声入力の精度が低下します：

  • 特殊文字が多い: 正規表現やシェルスクリプト
  • 複数言語の混在: コード内の日本語コメントと英語キーワード
  • 背景雑音: カフェやオフィスなど

パフォーマンスへの影響

長時間の音声入力は CPU 負荷を増加させます：

  • 音声認識エンジンが常に稼働
  • エディタの反応速度が若干低下することがある

音声疲労

  • 8 時間連続の音声開発は現実的ではない
  • 1-2 時間ごとの休息が推奨される
  • 音声コマンドと手入力のハイブリッドが最適

セキュリティ考慮

  • 公開環境では API キーを声で読まない
  • マイクが常時リッスン状態でないことを確認
  • 機密情報の入力は手入力で実施

トラブルシューティング

マイクが認識されない

# macOS
defaults read com.apple.speech.synthesis.general
aqua-voice test-mic
 
# Windows
aqua-voice test-mic --verbose

音声認識精度が低い

  1. マイクを再配置（口から 15-20cm）
  2. バックグラウンドノイズを減らす
  3. マイク入力レベルを調整：
aqua-voice config set --microphone-level 75
  1. 言語モデルを再トレーニング：
aqua-voice train-model --language ja

エディタが反応しない

# Aqua Voice を再起動
aqua-voice restart
 
# VS Code との接続をリセット
aqua-voice reset-connection

まとめ

Aqua Voice による完全ハンズフリー開発は、以下のような利点をもたらします：

  • 姿勢の自由度向上: キーボード作業の物理的負担を軽減
  • 集中力の維持: 手の動きを最小化し、思考に集中
  • アクセシビリティ向上: キーボード操作が困難なユーザーに対応

ただし、現状では音声のみでの完全開発よりも、音声とキーボードのハイブリッドアプローチが最も実用的です。

Claude Code との組み合わせにより、音声で高レベルな指示を出し、Claude が詳細な実装を担当するというワークフローが、最も効率的で快適な開発体験をもたらします。

関連リソース

エージェント運用で学んだ、責任範囲の切り分け方

シェア

お読みいただきありがとうございます

Antigravity Lab は広告なしで運営しており、サーバー費用などの運営コストはメンバーシップのご支援で賄っています。実装コード・ベンチマーク・本番設計パターンなど、実務でお役立ていただける記事を毎日更新しています。もし読んでよかったと感じていただけましたら、ぜひご覧ください。

  • ✦コピー&ペーストで使える実装コード付き
  • ✦毎日新しい上級ガイドを追加
  • ✦¥580/月 または ¥1,480 の永久アクセス
メンバーシップを見る →

もしこの記事がお役に立ちましたら、チップ（¥150）で応援いただけると大変励みになります。広告なしでの運営を続けるため、皆さまのご支援が大きな力になっています。

関連記事

⟐ Editor View2026-05-24
VS Code 1.121 と Agent Host Protocol ― リモートでエージェントが住み続ける時代の、エディタ周辺で起きていることの整理
VS Code 1.121 で導入された Remote agents と Agent Host Protocol（AHP）、Claude Agent の Auto モードや BYOK の拡張、Markdown プレビューの Mermaid 標準対応まで。Antigravity ユーザーの視点から、エディタの境界がどう動いているかを 1 本で整理します。
⟐ Editor View2026-04-28
GitHub Copilot BYOK で複数AI モデルを使い分ける開発環境の構築
2026年、GitHub Copilot の BYOK（Bring Your Own Key）機能が拡張されました。Anthropic、Google、OpenAI、OpenRouter など複数の LLM プロバイダーのキーを VS Code に設定し、コードを書く時にモデルを使い分ける開発環境を整えるガイドです。
⟐ Editor View2026-03-16
Antigravity Lab — Cursor から Antigravity への乗り換えガイド 2026
2026年、Cursor から Antigravity への移行が加速。機能比較、移行ステップ、よくある課題の解決法を完全ガイド。Cursor代替として Antigravity が選ばれる理由。
📚RECOMMENDED BOOKS
大規模言語モデル入門
山田育矢
LLM開発
生成AIプロンプトエンジニアリング入門
我妻幸長
プロンプト
Claude CodeによるAI駆動開発入門
平川知秀
AI駆動開発
※ アフィリエイトリンクを含みます
もっと見る →