이 페이지는 Cloud Translation API를 통해 번역되었습니다.

에이전트형 채팅을 페어 프로그래머로 사용하기

이 문서에서는 통합 개발 환경(IDE)에서 Gemini Code Assist 에이전트 모드를 페어 프로그래머로 구성하고 사용하는 방법을 설명합니다.

에이전트 모드를 사용하면 다음 작업을 비롯한 다양한 작업을 할 수 있습니다.

코드에 대해 질문합니다.
컨텍스트와 기본 제공 도구를 사용하여 생성된 콘텐츠를 개선합니다.
MCP 서버를 구성하여 에이전트의 기능을 확장합니다.
복잡한 다단계 작업에 대한 솔루션을 얻습니다.
설계 문서, 문제, TODO 주석으로 코드를 생성합니다.
실행 중에 계획과 도구 사용에 대한 댓글을 달고, 수정하고, 승인하여 에이전트 동작을 제어합니다.

제한사항

표준 Gemini Code Assist 채팅의 일부 기능은 에이전트 모드에서 사용할 수 없거나 표준 채팅에서와 다르게 작동할 수 있습니다.

에이전트 모드에서는 낭독을 사용할 수 없습니다. 에이전트 모드에서는 Gemini가 소스를 인용하지 않으며 인용된 소스와 일치하는 코드 추천을 사용 중지할 수 없습니다.

시작하기 전에

VS Code

IDE에서 사용할 Gemini Code Assist 버전을 설정합니다.
- 개인용 Gemini Code Assist
- Gemini Code Assist Standard 또는 Enterprise

IntelliJ

IDE에서 사용할 Gemini Code Assist 버전을 설정합니다.

에이전트 모드 사용

에이전트 모드에서는 Gemini에게 높은 수준의 목표를 달성하거나 복잡한 작업을 수행하도록 요청할 수 있습니다.

에이전트 모드를 최대한 활용하려면 프롬프트 권장사항을 따르고 최대한 많은 세부정보를 제공하세요.

에이전트 모드로 전환하려면 다음 단계를 따르세요.

VS Code

Gemini Code Assist 채팅을 열려면 IDE의 작업 표시줄에서 spark Gemini Code Assist를 클릭합니다.
에이전트 전환 버튼을 클릭하여 에이전트 모드로 전환합니다. 전환 스위치는 에이전트 모드로 전환되었을 때 강조 표시되고 일반 채팅에서는 회색으로 표시됩니다.
Gemini Code Assist 채팅에 프롬프트를 입력합니다.

Gemini가 프롬프트에 대한 대답을 제공하거나 도구 사용 권한을 요청합니다.

에이전트를 중지하려면 중지를 클릭합니다.

Gemini Code Assist Standard 채팅을 사용하려면 새 채팅을 클릭하여 새 채팅을 만듭니다.

Gemini Code Assist 에이전트 모드는 Gemini CLI를 기반으로 합니다.

IntelliJ

도구 창 모음에서 spark Gemini를 클릭합니다. 메시지가 표시되면 로그인합니다.
에이전트 탭을 선택합니다.
에이전트가 수행할 작업을 설명합니다.
상담사가 작업을 완료하는 단계를 진행하는 동안 변경사항을 검토하고 승인할 수 있습니다.
선택사항: 변경사항을 자동으로 승인하려면 설정 에이전트 옵션을 선택하고 변경사항 자동 승인 옆의 체크박스를 클릭합니다.

주의: 에이전트는 머신의 파일 시스템과 터미널 작업은 물론 사용하도록 구성한 모든 도구에 액세스할 수 있습니다. 변경사항을 자동 승인하는 위치와 시기를 결정할 때는 매우 신중을 기해야 합니다.

에이전트 모드의 도구 구성

도구는 에이전트가 프롬프트에 대답할 때 컨텍스트와 작업을 위해 사용할 수 있는 서비스의 광범위한 카테고리입니다. 예를 들어 grep와 파일 읽기/쓰기와 같은 기본 제공 도구, 로컬 또는 원격 Model Context Protocol (MCP) 서버 및 실행 가능한 함수, 맞춤 서비스 구현 등이 있습니다.

기본 제공 도구 사용 제어

에이전트 모드는 파일 검색, 파일 읽기, 파일 쓰기, 터미널 명령어 등과 같은 기본 제공 도구에 액세스할 수 있습니다.

VS Code

coreTools 및 excludeTools 설정을 사용하여 Gemini가 에이전트 모드에서 액세스할 수 있는 도구를 제어할 수 있습니다.

coreTools: 모델에서 사용할 수 있는 도구 목록을 지정할 수 있습니다. 이를 지원하는 도구의 경우 명령별 제한사항을 지정할 수도 있습니다. 예를 들어 Gemini 설정 JSON에 다음을 추가하면 셸 ls -l 명령어만 실행할 수 있습니다."coreTools": ["ShellTool(ls -l)"].
excludeTools: 모델에서 사용할 수 없도록 할 도구 목록을 지정할 수 있습니다. 이를 지원하는 도구의 경우 명령별 제한사항을 지정할 수도 있습니다. 예를 들어 Gemini 설정 JSON에 다음을 추가하면 rm -rf 명령어의 사용이 차단됩니다. "excludeTools": ["ShellTool(rm -rf)"]

excludeTools 및 coreTools에 모두 나열된 도구는 제외됩니다.

에이전트 모드에서 사용할 수 있는 기본 제공 도구를 구성하려면 다음 단계를 따르세요.

~/.gemini/settings.json에 있는 Gemini 설정 JSON을 엽니다. 여기서 ~는 홈 디렉터리입니다.
에이전트 도구 사용을 승인된 도구 목록으로 제한하려면 Gemini 설정 JSON에 다음 줄을 추가하세요.
```
"coreTools": ["TOOL_NAME_1,TOOL_NAME_2"]
```
TOOL_NAME_1 및 TOOL_NAME_2을 에이전트가 액세스할 수 있는 기본 제공 도구의 이름으로 바꿉니다.

기본 제공 도구는 원하는 만큼 나열할 수 있습니다. 기본적으로 모든 기본 제공 도구는 상담사가 사용할 수 있습니다.
에이전트 도구 사용을 특정 도구 명령어로 제한하려면 Gemini 설정 JSON에 다음 줄을 추가하세요.
```
"coreTools": ["TOOL_NAME(COMMAND)"]
```
다음을 바꿉니다.
- TOOL_NAME: 내장 도구의 이름
- COMMAND: 에이전트가 사용할 수 있도록 하려는 내장 도구 명령의 이름입니다.
에이전트 사용에서 도구를 제외하려면 Gemini 설정 JSON에 다음 줄을 추가하세요.
```
"excludeTools": ["TOOL_NAME_1,TOOL_NAME_2"]
```
TOOL_NAME_1 및 TOOL_NAME_2을 에이전트 사용에서 제외하려는 기본 제공 도구의 이름으로 바꿉니다.
에이전트 사용에서 도구 명령어를 제외하려면 Gemini 설정 JSON에 다음 줄을 추가하세요.
```
"excludeTools": ["TOOL_NAME(COMMAND)"]
```
다음을 바꿉니다.
- TOOL_NAME: 내장 도구의 이름
- COMMAND: 에이전트 사용에서 제외할 기본 제공 도구 명령의 이름입니다.

coreTools 및 excludeTools 구성 설정에 대한 자세한 내용은 Gemini CLI 구성 문서를 참고하세요.

IntelliJ

IntelliJ 또는 기타 JetBrains IDE용 Gemini Code Assist에서는 이 기능이 지원되지 않습니다.

MCP 서버 구성

VS Code

에이전트 모드에서 사용할 수 있는 서버를 제어하려면 서버 문서에 따라 Gemini 설정 JSON에 서버를 추가하세요.

MCP 서버에 필요한 종속 항목을 설치합니다.
~/.gemini/settings.json에 있는 Gemini 설정 JSON을 엽니다. 여기서 ~는 홈 디렉터리입니다.

서버 안내에 따라 Gemini 설정 JSON에 로컬 또는 원격 MCP 서버를 추가합니다.

다음 예에서는 두 개의 원격 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 서버는 에이전트가 에이전트 모드에서 사용할 수 있습니다.

IntelliJ

에이전트 모드에서 사용할 수 있는 서버를 제어하려면 서버를 mcp.json 파일에 추가하고 IDE의 구성 디렉터리에 배치합니다.

MCP 서버에 필요한 종속 항목을 설치합니다.
IDE의 구성 디렉터리에 mcp.json 파일을 만듭니다.

서버 안내에 따라 Gemini 설정 JSON에 로컬 또는 원격 MCP 서버를 추가합니다.

다음 예에서는 원격 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 서버는 에이전트가 에이전트 모드에서 사용할 수 있습니다.

MCP 서버 인증

일부 MCP 서버에는 인증이 필요합니다. 서버 문서를 따라 필요한 사용자 토큰을 만들고 적절하게 지정합니다. 로컬 서버는 환경 변수를 허용할 수 있고 원격 서버는 헤더의 사용자 인증 정보를 허용할 수 있습니다.

VS Code

인증이 필요한 MCP 서버의 경우 Gemini 설정 JSON에 추가할 수 있습니다.

다음 예시에서는 GitHub 로컬 및 원격 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은 사용자의 액세스 토큰입니다.

컨텍스트 파일 만들기

컨텍스트를 사용하면 에이전트가 지정된 프롬프트에 대해 더 나은 대답을 생성할 수 있습니다. 컨텍스트는 IDE의 파일, 로컬 시스템 폴더의 파일, 도구 대답, 프롬프트 세부정보에서 가져올 수 있습니다. 자세한 내용은 에이전트 모드 컨텍스트를 참고하세요.

VS Code

컨텍스트를 적용할 범위와 일치하는 위치에 GEMINI.md라는 파일을 만듭니다. 다음 표에는 다양한 범위의 컨텍스트 파일 위치가 자세히 나와 있습니다.

범위	위치
모든 프로젝트	`~/.gemini/GEMINI.md`
특정 프로젝트	작업 디렉터리나 프로젝트 루트(`.git` 폴더로 식별됨) 또는 홈 디렉터리까지의 상위 디렉터리
프로젝트의 특정 구성요소, 모듈 또는 하위 섹션	작업 디렉터리의 하위 디렉터리

에이전트의 메모리 시스템은 여러 위치에서 컨텍스트 파일을 로드하여 생성됩니다. 특정 구성요소나 모듈의 파일과 같은 더 구체적인 파일의 컨텍스트는 ~/.gemini/GEMINI.md의 전역 컨텍스트 파일과 같은 더 일반적인 컨텍스트 파일의 콘텐츠를 재정의하거나 보완합니다.

에이전트가 마크다운에서 사용할 규칙, 스타일 가이드 정보 또는 컨텍스트를 작성하고 파일을 저장합니다. 자세한 내용은 GitHub의 컨텍스트 파일 예시를 참조하세요.

에이전트는 컨텍스트 파일의 정보와 함께 전송된 프롬프트를 포함합니다.

IntelliJ

프로젝트의 루트에 GEMINI.md 또는 AGENT.md이라는 파일을 만듭니다.
에이전트가 마크다운에서 사용할 규칙, 스타일 가이드 정보 또는 컨텍스트를 작성하고 파일을 저장합니다.

에이전트는 컨텍스트 파일의 정보와 함께 전송된 프롬프트를 포함합니다. @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 모드를 구성하려면 다음 단계를 따르세요.

VS Code 사용자 설정 JSON 파일을 엽니다.
1. 명령어 팔레트(ctrl/command + Shift + P)를 엽니다.
2. 기본 설정: 사용자 설정 열기(JSON)를 선택합니다.

VS Code 사용자 설정 JSON 파일에 다음을 추가합니다.

//other settings...

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

명령어 팔레트를 열고 개발자: 창 새로고침을 선택합니다.

에이전트 모드는 Yolo 모드를 사용하며, 프롬프트를 전송하는 경우 작업을 실행하기 전에 권한을 요청하지 않습니다. 제한된 워크스페이스를 사용하는 경우 이 설정과 관계없이 에이전트가 작업을 실행하기 전에 메시지를 표시합니다.

IntelliJ

변경사항을 자동으로 승인하려면 Gemini Chat 에이전트 탭에서 설정 에이전트 옵션을 선택한 다음 변경사항 자동 승인 옆의 체크박스를 클릭합니다.

에이전트 모드는 모든 요청을 자동으로 승인하며, 프롬프트를 전송하는 경우 작업을 실행하기 전에 권한을 요청하지 않습니다.

추가 프롬프트

다음 프롬프트를 사용하여 자체 정보를 입력해 보세요.

'이 저장소가 어떤 역할을 하는지 아키텍처에 대해 자세히 알려줘.'
'이 [클래스/함수] 는 어떤 역할을 하나요?'
'이 코드베이스('[코드베이스 링크 또는 경로]')에 기능을 추가해 줘.'
'[C]라는 공통 메서드를 사용하도록 [A]와 [B] 함수를 리팩터링해 줘.'
'GitHub 문제[GitHub 문제 링크]를 수정해 줘.'
'[환경]에서 사용자가 [작업]을 할 수 있는 UI로 [목표]를 수행하는 애플리케이션을 빌드해 줘.'
'이 저장소의 라이브러리 버전을 [X]에서 [Y]로 마이그레이션 해줘.'
'이 Go 코드가 더 빠르게 실행되도록 성능을 최적화해 줘.'
'[API 이름]을 사용하여 이 기능을 빌드해 줘.'
'[x], [Y], [Z]를 실행하는 알고리즘을 구현해 줘.'

에이전트형 채팅을 페어 프로그래머로 사용하기 컬렉션을 사용해 정리하기 내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.

제한사항

시작하기 전에

VS Code

IntelliJ

에이전트 모드 사용

VS Code

IntelliJ

에이전트 모드의 도구 구성

기본 제공 도구 사용 제어

VS Code

IntelliJ

MCP 서버 구성

VS Code

IntelliJ

MCP 서버 인증

VS Code

IntelliJ

컨텍스트 파일 만들기

VS Code

IntelliJ

명령어 사용

VS Code

IntelliJ

항상 상담사 작업 허용

VS Code

IntelliJ

추가 프롬프트

다음 단계

에이전트형 채팅을 페어 프로그래머로 사용하기