目次

概要

要点

Googleの新しいエージェント型IDE「Antigravity」を使って個人開発に挑戦する人が増えています。UIの自動生成の完成度には驚かされる一方で、実際にアプリを動かそうとした段階で多くの人がつまずくポイントがあるようです。

UIは完璧、でも動かない

ある「失敗ログ」によると、Antigravityで作ったアプリはUI自体が完璧に自動生成されたものの、いざ動かそうとすると外部APIのAPIキー設定や環境変数の受け渡し部分でエラーが多発し、地獄を見たという体験が語られています。見た目は完成しているのに実際には動かないというギャップは、初めてAntigravityを使う人にとって精神的なダメージも大きそうです。9割の人がこの「APIキー設定」でつまずくという指摘もあり、決して珍しい失敗ではないようです。

なぜAPIキーでつまずくのか

AIがコードを自動生成する際、UIのデザインやロジックの部分は得意とする一方で、外部サービスとの接続に必要な認証情報の管理は、環境ごとに異なるルールがあり、AIが自動で完璧に処理しきれない領域だと考えられます。開発環境と本番環境でキーを使い分ける必要がある場合や、環境変数ファイルの置き場所・読み込み方法が想定と違う場合など、細かな食い違いがエラーにつながりやすいようです。

APIキーの正しい扱い方

ポイント

APIキーの罠を避けるための具体的な手順も見ておきましょう。基本は、コードの中にキーを直接書き込む(ハードコーディングする)のではなく、プロジェクトのルートに「.env」というファイルを作り、そこにキーをまとめて記載する方法です。作成した.envファイルは、誤って外部に公開してしまわないよう、必ず.gitignoreに追加してバージョン管理の対象から外しておく必要があります。あわせて、実際の値は書かず変数名だけを示した「.env.example」というファイルを別途用意し、そちらはリポジトリに含めておくと、他の人(または未来の自分)が何の変数が必要かを一目で把握できるようになります。

さらに注意したいのが、テスト用の緩い権限のキーと、本番用の重要なキーを同じ.envファイルに混在させないことです。Antigravityの作業フォルダに置く.envには、影響の小さいテスト用の値だけを置き、本番用の重要なキーは別の場所で管理する、という切り分けが安全です。また、AIエージェントが.envファイルの中身を解釈する際、実際のプログラムが読み込むルール(dotenvパッケージの仕様など)とAI側の解釈がわずかに食い違うことがあり、引用符や空白の扱いの差が原因で「AIは正しいと思っているのに実際には反映されていない」という静かなバグにつながるケースも報告されています。値を書き換えたら、AIの説明を鵜呑みにせず、実際に動作確認まで行う習慣をつけておくと安心です。

成功パターン：3ツールの役割分担

具体例

一方で、うまくいっている個人開発の事例を見ると、共通して「複数のツールに役割を分担させる」という工夫が見られます。具体的には、要件定義や仕様のすり合わせはGeminiとの対話で行い、UIデザインの叩き台はGoogle AI Studioで生成し、実際のコーディングとデータ層の実装はAntigravityに任せる、という3段階の役割分担です。ひとつのツールに全工程を任せきるのではなく、それぞれの強みを活かして組み合わせることで、手戻りの少ない開発が実現しやすくなりそうです。

「言語化力」より「PM視点」

ある開発事例では、Antigravityでの個人開発を通じて「言語化力よりPM(プロダクトマネージャー)視点が重要だ」という気づきが語られています。要件定義はGemini、実装はAntigravity、そして計画のレビューを再びGeminiに任せるという循環、いわば「AI同士のピンポン」によって、人間がすべての仕様を細部まで言語化しなくても、AI同士のやり取りの中で不明点が自然と浮き彫りになり、結果的に手戻りが減るという発見です。

実際の開発事例

ブログ用のキャプチャ画像を編集するプログラムを、Antigravityと最新モデルを組み合わせて開発した事例では、Antigravityが自律的にブラウザを操作しながら動作確認まで行う様子が確認されています。単なるコード生成ツールにとどまらず、実際に動かして確認するところまでを自律的にこなす点が、従来のコーディング支援ツールとの違いとして評価されているようです。

まとめ：APIキー設定で失敗しないためのチェックリスト

Antigravityで個人開発を始める前に、次の点を意識しておくと失敗を避けやすそうです。

  1. APIキーや環境変数の設定は、AIに任せきりにせず自分でも内容を確認する
  2. 開発環境と本番環境でキーを取り違えていないか、事前にチェックする
  3. 要件定義・UI設計・実装という工程を、Gemini・AI Studio・Antigravityに役割分担させる
  4. 「言語化しきる」ことにこだわりすぎず、AI同士のやり取りを通じて仕様を固めていく
注意

見た目の完成度の高さに油断せず、接続部分こそ丁寧に確認する。この一手間が、9割の人がハマる罠を避ける最大のポイントになりそうです。

関連記事