コーディング エージェントの設定とデベロッパー向けリソース

AI コーディング エージェントは、特定の日付でカットオフされたトレーニング データに依存しています。このため、エージェントは非推奨のモデル(gemini-1.5)、古い SDK(google-generativeai)、古いコードパターンを提案することがよくあります。

エージェントを公式の Gemini デベロッパー リソースに接続すると、現在のモデル、google-genai SDK、Interactions API を使用して正確なコードを作成できます。

コーディング エージェントを Gemini のドキュメント、ルール、CLI ツールに接続するには、次の 5 つの方法があります。

エージェント リソースの概要

リソース 提供される機能 対象
Gemini Agent Skills 特定の機能(gemini-api-dev、gemini-live-api-dev、gemini-omni-flash-api)のステップバイステップのルール、SDK パターン、ヘルパー スクリプト。 AI Studio Build にプリインストールされています。skills.sh、Context7、またはマネージド エージェントを使用してインストールします。
Gemini Docs MCP サーバー すべてのドキュメントを対象とした Live Search(gemini_search_docs)とページ全体の読み上げ(gemini_get_doc)。 Claude Code、Cursor、OpenAI Codex、VS Code でサポートされています。
Gemini API プラグイン 公式の Gemini スキル、Docs MCP サーバー、API キー ツールを含むバンドル パッケージ。 Antigravity。
機械で読み取り可能なドキュメント Markdown ページと llms.txt インデックスをクリーンアップします。 ai.google.dev/gemini-api/docs のすべてのドキュメント ページ。
Gemini API CLI ステートレス CLI(gemini-api)を使用すると、SDK コードを記述せずに、シェルから生成メディアの生成、ファイルの分析、Managed Agents の実行を行うことができます。 インストール スクリプト、Go、またはビルド済みのバイナリを使用して、macOS、Linux、Windows にインストールします。

Gemini エージェント スキルをインストールする

エージェント スキルは、コーディング エージェントに手続き型ルール、現在のモデル名、SDK コードパターンを提供します。プロンプトに長い指示を追加する代わりに、エージェントは必要なときにのみ各スキルを読み込みます。これにより、エージェントは非推奨の SDK を回避し、最新の Gemini パターンを使用できます。

スキルは Gemini Docs MCP サーバーと連携して動作します。エージェントに MCP サーバーがインストールされていない場合、スキルは llms.txt にフォールバックします。スキルの仕組みの詳細については、Gemini API スキルガイドをご覧ください。

CLI(skills.sh または Context7)を使用してインストールする

skills.sh(推奨)または Context7 を使用してスキルをインストールします。

# List all available skills in the repository
npx skills add google-gemini/gemini-skills --list

# Install a specific skill globally with skills.sh
npx skills add google-gemini/gemini-skills --skill <skill-name> --global

# Or install with Context7
npx ctx7 skills install /google-gemini/gemini-skills <skill-name>

利用可能なスキル

gemini-api-dev

Interactions API と公式の Gemini API SDK(Python 用の google-genai と TypeScript 用の @google/genai)を使用してアプリケーションを構築するスキル。このスキルでは、次の内容を学習します。

  • テキスト生成、マルチターン チャット、ストリーミング、構造化出力、関数呼び出し
  • 画像生成、テキスト読み上げ(TTS)、マルチモーダル入力
  • サーバーサイドの会話状態管理、バックグラウンド実行、Deep Research、マネージド エージェント
  • 現在のモデル名と以前の generateContent または google-generativeai コードの移行
npx skills add google-gemini/gemini-skills --skill gemini-api-dev --global

gemini-live-api-dev

Gemini Live API を使用してリアルタイムの音声と動画のストリーミング アプリケーションを構築するスキル。このスキルでは、次の内容を学習します。

  • WebSocket セッション管理、エフェメラル クライアント トークン、セッションの再開
  • 音声検出(VAD)と割り込みサポートによる音声、動画、テキストのストリーミング
  • バックグラウンド推論(拡張思考)、非ブロッキング非同期ツール呼び出し、音声文字変換、ライブ音声翻訳
npx skills add google-gemini/gemini-skills --skill gemini-live-api-dev --global

gemini-omni-flash-api

Interactions API を使用して Gemini Omni Flash で動画を生成、編集するスキル。ヘルパー スクリプト(upload_file.py、generate_video.py、prep_video.py、inspect_video.py)が含まれており、次の内容をカバーしています。

  • テキストから動画への生成とプロンプトの作成
  • 最初と最後のフレームのトランジションと参照ガイド付き動画生成
  • 動画拡張機能とメディア前処理ワークフロー
npx skills add google-gemini/gemini-skills --skill gemini-omni-flash-api --global

マネージド エージェントにスキルをマウントする

Interactions API を使用してリモート マネージド エージェントを実行する場合は、google-gemini/gemini-skills リポジトリをエージェントのワークスペースにマウントできます。詳細については、Gemini API スキルガイドをご覧ください。

from google import genai

client = genai.Client()

interaction = client.interactions.create(
    agent="antigravity-preview-09-2026",
    input="Build a script that generates a 5-second video of a neon cityscape.",
    environment={
        "type": "remote",
        "sources": [
            {
                "type": "repository",
                "source": "https://github.com/google-gemini/gemini-skills",
                "target": ".agents",
            }
        ],
    },
)

Gemini Docs MCP サーバーを接続する

一般公開の Gemini Docs MCP サーバー(https://gemini-api-docs-mcp.dev)を使用すると、エージェントはドキュメント サイト全体にライブアクセスできます。エージェントは、ドキュメント ページを検索して読み取り、リクエスト スキーマ、モデルの上限、新機能を確認できます。

  • gemini_search_docs: トピックまたはクエリで Gemini API ドキュメントを検索します。
  • gemini_get_doc: 特定のドキュメント ページの Markdown コンテンツ全体を読み取ります。

クイック セットアップ

ターミナルまたはプロジェクトのルートで次のコマンドを実行して、検出されたコーディング エージェントを自動的に構成します。

npx add-mcp "https://gemini-api-docs-mcp.dev"

環境別の構成

Claude Code

ターミナルで次のコマンドを実行します。

$ claude mcp add --transport http geminiDocs https://gemini-api-docs-mcp.dev

Cursor

~/.cursor/mcp.json(グローバル)または .cursor/mcp.json(プロジェクト)に追加します。

{
  "mcpServers": {
    "geminiDocs": {
      "url": "https://gemini-api-docs-mcp.dev"
    }
  }
}

OpenAI Codex

ターミナルで次のコマンドを実行します。

$ codex mcp add geminiDocs --url https://gemini-api-docs-mcp.dev

または ~/.codex/config.toml に追加します。

[mcp_servers.geminiDocs]
url = "https://gemini-api-docs-mcp.dev"

VS Code(Copilot)

ワークスペースの .vscode/mcp.json に追加します。

{
  "servers": {
    "geminiDocs": {
      "type": "http",
      "url": "https://gemini-api-docs-mcp.dev"
    }
  }
}

Gemini API プラグイン

Antigravity を使用している場合は、Gemini API プラグインを使用すると、ワークスペースを最も迅速に設定できます。Gemini Docs MCP サーバー、すべての公式 Gemini スキル(gemini-api-dev、gemini-live-api-dev、gemini-omni-flash-api)、API キー ツールが 1 つのダウンロードにバンドルされています。

  • Antigravity(UI)にインストールする: [設定] > [カスタマイズ] > [Build with Google Plugins] に移動し、Gemini API をダウンロードします。
  • CLI を使用してインストールする: bash agy plugin install https://github.com/google-gemini/gemini-skills

機械で読み取り可能なドキュメント

標準のウェブページには、コンテキスト ウィンドウのスペースを占有する HTML タグ、ナビゲーション バー、スクリプトが含まれています。ai.google.dev は、エージェントとスクリプトがクリーンな Markdown を直接取得できるように、機械で読み取り可能なエンドポイントを提供します。

  • llms.txt インデックス(https://ai.google.dev/gemini-api/docs/llms.txt): すべての Gemini API ドキュメント ページを一覧表示し、各ページへのリンクを提供します。
  • 直接マークダウン URL(.md.txt): ai.google.dev のドキュメント URL(例: https://ai.google.dev/gemini-api/docs/coding-agents.md.txt)に .md.txt を追加して、保存されたプロンプト、AGENTS.md ルール、自動スクリプトのクリーンなマークダウン ソースを取得します。

推奨されるプロジェクト ルール(AGENTS.md)

プロジェクト ルール ファイル(AGENTS.md、.cursorrules、CLAUDE.md)は、すべてのエージェント セッションの開始時に読み込まれるベースライン ルールを設定します。コーディング エージェントがデフォルトで最新のモデルと SDK を使用するように、これらのガイドラインをプロジェクトのルートに追加します。

# Gemini API Guidelines

- Before writing Gemini API code, consult the `geminiDocs` MCP server (`gemini_search_docs` / `gemini_get_doc`) or `https://ai.google.dev/gemini-api/docs/llms.txt`.
- Always use the current Gemini API SDK (`google-genai` for Python, `@google/genai` for TypeScript/JavaScript). Never use legacy SDKs (`google-generativeai` or `@google/generative-ai`).
- Use the Interactions API (`client.interactions.create`) for new applications unless a specific feature requires `generateContent`.
- Use current recommended models (see https://ai.google.dev/gemini-api/docs/models) and avoid deprecated models.

確認とトラブルシューティング

設定を確認する

設定をテストするには、コーディング エージェントに次の質問をします。

Look up the request schema for the Gemini Interactions API in the documentation.

構成されたエージェントは、geminiDocs MCP サーバーで gemini_search_docs を使用し、google-genai または @google/genai SDK で client.interactions.create を使用してコードを記述します。

Status コマンド

環境 MCP の確認 スキルの検証
Claude Code /mcp を実行します /skills を実行します
Cursor [Settings] > [Features] > [MCP] を開きます。 [設定] > [ルール] を開きます。
OpenAI Codex codex mcp list を実行します .codex/skills/ または ~/.codex/skills/ を確認する
Antigravity [カスタマイズ] > [接続] を開きます。 [カスタマイズ] > [ルール] を開くか、/skills list を実行します。
VS Code(Copilot) [拡張機能] > [MCP] または [出力] パネルを開きます。 Copilot Chat で [ツールを選択] をクリックします。

トラブルシューティング

  • スキルまたは MCP サーバーが検出されない: エディタ(Cursor または VS Code)またはターミナル セッション(Claude Code または Codex)を再起動します。ほとんどのエージェントは、起動時にのみ MCP サーバーとスキルを読み込みます。
  • グローバル スキルの競合: エージェントがグローバルにインストールされたスキルを無視する場合は、--global を指定せずにプロジェクトのルートにスキルをインストールします。 bash npx skills add google-gemini/gemini-skills --skill gemini-api-dev
  • ルールが無視される: AGENTS.md、.cursorrules、CLAUDE.md ファイルがプロジェクトのルート ディレクトリにあることを確認します。

次のステップ