エージェント チャットをペア プログラマーとして使用する

VS Code

1. IDE で使用する Gemini Code Assist のエディションを設定します。
   • 個人向け Gemini Code Assist
   • Gemini Code Assist Standard または Enterprise

IntelliJ

IDE で使用する Gemini Code Assist のエディションを設定します。

• 個人向け Gemini Code Assist
• Gemini Code Assist Standard または Enterprise

VS Code

1. Gemini Code Assist チャットを開くには、IDE のアクティビティ バーで spark [Gemini Code Assist] をクリックします。
2. [エージェント] 切り替えをクリックして、エージェント モードに切り替えます。エージェント モードに切り替えると切り替えボタンがハイライト表示され、通常のチャットではグレー表示になります。
3. Gemini Code Assist チャットにプロンプトを入力します。

Gemini がプロンプトにレスポンスするか、ツールの使用許可をリクエストします。

エージェントを停止するには、[stop停止] をクリックします。

標準の Gemini Code Assist チャットを使用するには、[add新しいチャット] をクリックして新しいチャットを作成します。

Gemini Code Assist エージェント モードは、Gemini CLI によって動作します。

IntelliJ

1. ツール ウィンドウ バーの spark [Gemini] をクリックします。ログインを促すメッセージが表示された場合はログインします。
2. [エージェント] タブを選択します。
3. エージェントに実行させたいタスクを記述します。

4. エージェントがタスクを完了する手順を進めるにつれて、変更を確認して承認するオプションが表示されます。

5. 省略可: 変更を自動的に承認するには、[設定] [エージェント オプション] を選択し、[変更を自動的に承認] の横にあるチェックボックスをオンにします。

VS Code

coreTools と excludeTools の設定を使用すると、エージェント モードで Gemini がアクセスできるツールを制御できます。

coreTools

: モデルで使用可能にするツールのリストを指定できます。また、対応するツールでは、コマンド固有の制限を指定することもできます。たとえば、Gemini 設定の JSON に次の行を追加すると、シェル ls -l コマンドのみが実行可能になります。"coreTools": ["ShellTool(ls -l)"]。

excludeTools

モデルで使用できないようにするツールのリストを指定できます。また、対応するツールでは、コマンド固有の制限を指定することもできます。たとえば、Gemini 設定の JSON に "excludeTools": ["ShellTool(rm -rf)"] を追加すると、rm -rf コマンドの使用がブロックされます。

excludeTools と coreTools の両方に記載されているツールは除外されます。

エージェント モードで使用できる組み込みツールを構成する手順は次のとおりです。

1. ~/.gemini/settings.json にある Gemini 設定 JSON を開きます。ここで、~ はホーム ディレクトリです。

2. エージェント ツールの使用を承認済みツールのリストに制限するには、Gemini 設定の JSON に次の行を追加します。

   "coreTools": ["TOOL_NAME_1,TOOL_NAME_2"]
   

   TOOL_NAME_1 と TOOL_NAME_2 は、エージェントにアクセス権を付与する組み込みツールの名前に置き換えます。

   組み込みツールはいくつでもリストに含めることができます。デフォルトでは、すべての組み込みツールがエージェントで使用できます。

3. エージェント ツールの使用を特定のツールコマンドに制限するには、Gemini 設定の JSON に次の行を追加します。

   "coreTools": ["TOOL_NAME(COMMAND)"]
   

   次のように置き換えます。

   • TOOL_NAME: 組み込みツールの名前
   • COMMAND: エージェントが使用できるようにする組み込みツール コマンドの名前。

4. エージェントでの使用からツールを除外するには、Gemini 設定の JSON に次の行を追加します。

   "excludeTools": ["TOOL_NAME_1,TOOL_NAME_2"]
   

   TOOL_NAME_1 と TOOL_NAME_2 は、エージェントの使用から除外する組み込みツールの名前に置き換えます。

5. エージェントによる使用からツールコマンドを除外するには、Gemini 設定の JSON に次の行を追加します。

   "excludeTools": ["TOOL_NAME(COMMAND)"]
   

   次のように置き換えます。

   • TOOL_NAME: 組み込みツールの名前
   • COMMAND: エージェントの使用から除外する組み込みツール コマンドの名前。

coreTools と excludeTools の構成設定の詳細については、Gemini CLI 構成のドキュメントをご覧ください。

IntelliJ

この機能は、IntelliJ やそのほかの JetBrains IDE の Gemini Code Assist ではサポートされていません。

VS Code

エージェント モードで使用できるサーバーを制御するには、サーバーのドキュメントに従って、Gemini 設定の JSON にサーバーを追加します。

1. MCP サーバーに必要な依存関係をインストールします。
2. ~/.gemini/settings.json にある Gemini 設定 JSON を開きます。ここで、~ はホーム ディレクトリです。

3. サーバーの手順に沿って、ローカルまたはリモートの MCP サーバーを Gemini 設定の JSON に追加します。

   次の例では、リモート Cloudflare MCP サーバーを 2 つ追加し、ローカルマシンに GitHub サーバーと GitLab サーバーをインストールします。

   {
     "mcpServers": {
       "github": {
         "command": "npx",
         "args": ["-y", "@modelcontextprotocol/server-github"],
         "env": {
           "GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_example_personal_access_token12345"
         }
       },
       "gitlab": {
         "command": "npx",
         "args": ["-y", "@modelcontextprotocol/server-gitlab"]
       },
       "cloudflare-observability": {
         "command": "npx",
         "args": ["mcp-remote", "https://observability.mcp.cloudflare.com/sse"]
       },
       "cloudflare-bindings": {
         "command": "npx",
         "args": ["mcp-remote", "https://bindings.mcp.cloudflare.com/sse"]
       }
     }
   }
   

4. コマンド パレットを開き、[デベロッパー: ウィンドウの再読み込み] を選択します。

構成した MCP サーバーは、エージェント モードでエージェントが使用できます。

IntelliJ

エージェント モードで使用できるサーバーを制御するには、mcp.json ファイルにサーバーを追加して、IDE の構成ディレクトリに配置します。

1. MCP サーバーに必要な依存関係をインストールします。
2. IDE の構成ディレクトリに mcp.json ファイルを作成します。

3. サーバーの手順に沿って、ローカルまたはリモートの MCP サーバーを Gemini 設定の JSON に追加します。

   次の例では、リモート Cloudflare MCP サーバーを追加し、ローカルマシンに GitHub サーバーと GitLab サーバーをインストールします。

   {
     "mcpServers": {
       "github": {
         "command": "npx",
         "args": ["-y", "@modelcontextprotocol/server-github"],
         "env": {
           "GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_example_personal_access_token12345"
         }
       },
       "gitlab": {
         "command": "npx",
         "args": ["-y", "@modelcontextprotocol/server-gitlab"]
       },
       "cloudflare-observability": {
         "command": "npx",
         "args": ["mcp-remote", "https://observability.mcp.cloudflare.com/sse"]
       },
       "cloudflare-bindings": {
         "command": "npx",
         "args": ["mcp-remote", "https://bindings.mcp.cloudflare.com/sse"]
       }
     }
   }
   

構成した MCP サーバーは、エージェント モードでエージェントが使用できます。

VS Code

認証が必要な MCP サーバーは、Gemini 設定の JSON に追加できます。

次の例は、GitHub のローカル MCP サーバーとリモート MCP サーバーの個人アクセス トークンを指定する方法を示しています。

{
  "mcpServers": {
    "github-remote": {
      "httpUrl": "https://api.githubcopilot.com/mcp/",
      "headers": {
        "Authorization": "Bearer ACCESS_TOKEN"
      }
    },
    "github-local": {
      "command": "/Users/username/code/github-mcp-server/cmd/github-mcp-server/github-mcp-server",
      "args": ["stdio"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "ACCESS_TOKEN"
      }
    }
  }
}

ここで、ACCESS_TOKEN はユーザーのアクセス トークンです。

IntelliJ

認証が必要な MCP サーバーは、mcp.json ファイルに追加できます。

次の例では、GitHub ローカル サーバーの個人アクセス トークンを追加します。

{
  "mcpServers": {
    "github-local": {
      "command": "/Users/username/code/github-mcp-server/cmd/github-mcp-server/github-mcp-server",
      "args": ["stdio"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "ACCESS_TOKEN"
      }
    }
  }
}

ここで、ACCESS_TOKEN はユーザーのアクセス トークンです。

VS Code

1. コンテキストを適用するスコープと一致するロケーションに、GEMINI.md という名前のファイルを作成します。次のテーブルに、さまざまなスコープのコンテキスト ファイルのロケーションの詳細を示します。

   範囲	場所
   すべてのプロジェクト	~/.gemini/GEMINI.md
   特定のプロジェクト	作業ディレクトリ、またはプロジェクト ルート（.git フォルダで識別）またはホーム ディレクトリまでの親ディレクトリ。
   プロジェクトの特定のコンポーネント、モジュール、サブセクション	作業ディレクトリのサブディレクトリ。

   エージェントのメモリシステムは、複数のロケーションからコンテキスト ファイルを読み込むことで作成されます。特定のコンポーネントやモジュール用のファイルなど、より具体的なファイルからのコンテキストは、~/.gemini/GEMINI.md のグローバル コンテキスト ファイルなど、より一般的なコンテキスト ファイルのコンテンツをオーバーライドまたは補完します。

2. エージェントに使用させたいルール、スタイルガイド情報、コンテキストを Markdown で記述し、ファイルを保存します。詳細については、GitHub のコンテキスト ファイルの例をご覧ください。

エージェントは、コンテキスト ファイル内の情報と、送信されたプロンプトを組み合わせて使用します。

IntelliJ

1. プロジェクトのルートに、GEMINI.md または AGENT.md という名前のファイルを作成します。

2. エージェントに使用させたいルール、スタイルガイド情報、コンテキストを Markdown で記述し、ファイルを保存します。

エージェントは、コンテキスト ファイル内の情報と、送信されたプロンプトを組み合わせて使用します。@FILENAME 構文を使用してファイルを手動で含めることで、コンテキストを追加することもできます。ここで、FILENAME は、含めるコンテキスト情報を含むファイルの名前です。

VS Code

エージェント モードでは、次の Gemini CLI コマンドを使用できます。

• /tools: エージェント モード セッションで使用可能なツールのリストを表示します。
• /mcp: 構成済みの Model Context Protocol（MCP）サーバー、接続ステータス、サーバーの詳細、使用可能なツールを一覧表示します。

Gemini CLI コマンドの詳細については、Gemini CLI コマンドをご覧ください。Gemini CLI コマンドの一部はエージェント モードでは使用できません。

IntelliJ

この機能は、IntelliJ やそのほかの JetBrains IDE の Gemini Code Assist ではサポートされていません。

VS Code

yolo モードを使用すると、すべてのエージェント アクションを自動的に許可できます。Yolo モードは、信頼できるワークスペースでのみ使用できます。

yolo モードを構成するには:

1. VS Code のユーザー設定の JSON ファイルを開きます。

   1. コマンド パレット（ctrl/command + Shift + P）を開きます。
   2. [設定: ユーザー設定を開く（JSON）] を選択します。

2. VS Code のユーザー設定の JSON ファイルに以下を追加します。

   //other settings...
   
   "geminicodeassist.agentYoloMode": true,
   //other settings...
   

3. コマンド パレットを開き、[デベロッパー: ウィンドウの再読み込み] を選択します。

エージェント モードは yolo モードを使用します。プロンプトを送信すると、アクションを実行する前に権限を求めることはありません。制限付きワークスペースを使用している場合、この設定に関係なく、エージェントはアクションを実行する前にプロンプトを表示します。

IntelliJ

変更を自動的に承認するには、Gemini Chat エージェントのタブで、[設定] [エージェント オプション] を選択し、[変更を自動的に承認] の横にあるチェックボックスをオンにします。

エージェント モードでは、すべてのリクエストが自動的に承認されます。プロンプトを送信すると、アクションを実行する前に権限を求めることはありません。