/posts/jetbrains-github-copilot-ai-agent-workflow-refactoring

JetBrains IDE에서 GitHub Copilot 에이전트 활용 워크플로우: 코드 작성부터 리팩토링까지

JetBrains IDE에 통합된 GitHub Copilot 에이전트 이해하기

이 글에서는 JetBrains IDE에 통합된 GitHub Copilot 에이전트를 활성화하고, 실제 개발 워크플로우에 적용하는 구체적인 방법을 다룹니다. 코드 작성부터 리팩토링까지 각 단계에서 AI 에이전트를 어떻게 활용할 수 있는지 안내합니다.

JetBrains IDE는 2026년 6월부터 GitHub Copilot 에이전트를 JetBrains AI Assistant 내 기본 에이전트 옵션으로 제공하고 있습니다.1 이는 JetBrains와 GitHub의 협력을 통해 이루어진 네이티브 통합으로, 별도의 ACP(Agent Client Protocol) 설정 없이 바로 사용할 수 있습니다.2

기존 GitHub Copilot 플러그인은 코드 완성, 인라인 채팅, 코드 리뷰, 커밋 메시지 생성 등 포괄적인 기능을 제공합니다. 반면 JetBrains AI Assistant 내의 GitHub Copilot 에이전트는 주로 대화형 채팅 및 에이전트 기능에 집중합니다.3 에이전트 모드에서는 사용자의 요청을 이해하고, 파일을 읽고 수정하며, 명령을 실행하는 다단계 작업을 수행합니다.4 두 방식의 기능 범위가 다르므로, 어떤 방식을 사용하고 있는지 먼저 파악하는 것이 중요합니다.

GitHub Copilot 에이전트 기능을 사용하려면 활성 GitHub Copilot 구독이 필요합니다.5 JetBrains AI 구독과는 별개이며, GitHub 계정을 통한 OAuth 인증으로 활성화할 수 있습니다. JetBrains AI Assistant 내 에이전트 선택기에서 GitHub Copilot을 선택하면 됩니다.2

기본 워크플로우: 코드 작성 및 이해

대화형 코드 작성

GitHub Copilot 에이전트는 대화형 방식으로 복잡한 기능 구현을 돕습니다. 에이전트 모드에서 특정 기능 구현을 요청하면, Copilot은 필요한 단계를 파악하고 코드를 생성하거나 수정하는 다단계 작업을 수행합니다.

python
# 기존 파일: data_processor.py
# 사용자 요청 (Copilot Chat):
# "data_processor.py에 JSON 문자열을 받아 'items' 키의 리스트를 반환하는
# process_json_data 함수를 추가해줘. 유효성 검사도 포함해줘."

자동 컨텍스트 수집 활용

GitHub Copilot 에이전트는 현재 열린 파일, 선택된 텍스트, 코드 편집 세션 등 IDE의 컨텍스트를 자동으로 수집하여 요청에 활용합니다.5 덕분에 매번 수동으로 컨텍스트를 첨부하지 않아도 현재 작업 중인 코드에 대한 질문이나 요청을 자연스럽게 이어갈 수 있습니다.

코드 이해 및 최적화 요청

Copilot Chat을 통해 작성된 코드의 작동 방식이나 특정 로직의 목적을 파악하는 데 도움을 받을 수 있습니다. 비효율적인 코드 부분을 지적하고 최적화를 요청하는 것도 가능합니다.

python
# 최적화를 요청할 코드 예시
data = [i for i in range(1000)]
squared_data = []
for x in data:
    squared_data.append(x * x)

# 사용자 요청 (Copilot Chat):
# "이 코드를 더 효율적으로 리팩토링할 수 있을까?
# 특히 squared_data 부분을 개선하고 싶어."

명령어 기반 상호작용

GitHub Copilot 에이전트는 채팅에서 직접 입력할 수 있는 /commands를 지원합니다.5 예를 들어 /session 명령어로 현재 에이전트 세션 정보를 확인하거나, /help로 사용 가능한 명령어 목록을 볼 수 있습니다.

고급 워크플로우: 리팩토링 및 다중 파일 편집

Copilot Edits를 활용한 리팩토링

2025년 3월 JetBrains IDE에서 Copilot Edits 기능이 일반 출시되었습니다.6 이 기능은 단일 파일 또는 여러 파일에 걸쳐 코드를 리팩토링하고 최적화하는 작업을 지원합니다.6 예를 들어 특정 클래스의 메서드 이름을 일관성 있게 변경하거나, 여러 파일에 분산된 기능을 모듈화하는 작업을 위임할 수 있습니다.

java
// 사용자 요청 (Copilot Chat):
// "UserService.java 파일의 getUserById 메서드 이름을 findUserById로 변경하고,
// 이 메서드를 호출하는 다른 모든 파일에서도 변경 사항을 반영해줘."

변경 사항 미리보기 및 제어

Copilot Edits는 제안된 변경 사항을 적용하기 전에 미리 볼 수 있는 기능을 제공합니다.6 개발자는 제안된 내용을 상세히 검토하고 개별적으로 수락하거나 거부할 수 있습니다. AI의 제안을 그대로 수용하기보다 개발자가 최종 통제권을 갖고 코드 품질을 유지할 수 있도록 돕는 기능입니다.

사용자 정의 에이전트 및 서브 에이전트 활용

JetBrains IDE용 GitHub Copilot에는 사용자 정의 에이전트(Custom Agents) 및 서브 에이전트(Subagents) 기능이 도입되었습니다.7 이를 통해 특정 언어 스타일 가이드를 따르도록 에이전트를 구성하거나, 특정 라이브러리 사용 패턴에 맞춘 서브 에이전트를 설정할 수 있습니다. 다만 이 기능은 현재 공개 프리뷰 상태로 제공되고 있어 향후 변경될 수 있습니다.8

플랜 모드(Plan Mode)로 복잡한 작업 처리

플랜 모드는 복잡한 개발 작업을 단계별로 계획하고 실행하는 데 도움을 줍니다.7 큰 작업을 작은 하위 작업으로 분해하고, 각 단계에 대한 설명을 생성하며, 필요한 경우 코드를 생성하거나 수정하는 과정을 안내합니다. 새로운 기능 개발이나 대규모 리팩토링처럼 여러 단계를 거쳐야 하는 작업에서 특히 유용합니다.

활용 팁

효율적인 프롬프트 작성

AI 에이전트의 결과 품질은 프롬프트의 구체성에 크게 좌우됩니다. 다음 원칙을 참고하시기 바랍니다.

  • 목표 명확화: "A 기능을 구현해줘"보다는 "사용자가 입력한 문자열을 검증하고, 유효하면 데이터베이스에 저장하는 Python 함수를 작성해줘"처럼 구체적으로 요청합니다.
  • 컨텍스트 제공: 필요한 경우 관련 코드 스니펫이나 파일 경로를 명시합니다.
  • 제약 조건 포함: 성능 요건, 사용할 라이브러리, 에러 처리 방식 등을 함께 명시합니다.
  • 예시 제시: 원하는 출력 형식이나 코드 스타일의 예시를 제공하면 더 적합한 결과를 얻을 수 있습니다.

제안된 코드 검토 전략

AI의 제안은 유용한 도구이지만, 항상 면밀히 검토해야 합니다.

  • 정확성 확인: 생성된 로직이 의도한 대로 작동하는지 검토합니다.
  • 보안 취약점 검토: 잠재적인 보안 문제가 없는지 확인합니다.
  • 스타일 일관성: 프로젝트의 코딩 스타일 가이드라인을 따르는지 확인합니다.
  • 성능 분석: 제안된 코드가 성능 측면에서 비효율적이지 않은지 검토합니다.

무료 플랜 활용

2026-07 작성 시점 기준으로, JetBrains IDE용 GitHub Copilot은 제한된 코드 완성 및 채팅 요청을 포함하는 무료 플랜을 제공하는 것으로 알려져 있습니다.9 구체적인 사용량 한도는 변동될 수 있으므로 최신 정보는 공식 페이지에서 확인하시기 바랍니다. 구독 없이도 에이전트의 기본 기능을 먼저 경험해 보고 도입 여부를 판단하는 데 활용할 수 있습니다.

결론

JetBrains IDE 내 GitHub Copilot 에이전트는 코드 작성부터 다중 파일 리팩토링까지 다양한 개발 작업을 보조하는 실용적인 도구입니다. 자동 컨텍스트 수집, Copilot Edits, 플랜 모드 등의 기능은 기존 JetBrains 사용자가 AI 기반 개발을 시작하는 데 낮은 진입 장벽을 제공합니다.

다만 몇 가지 한계를 인지해야 합니다. 기존 GitHub Copilot 플러그인과 JetBrains AI Assistant 내 Copilot 에이전트는 기능 범위가 다르므로, 어떤 방식을 사용하는지 명확히 파악하고 활용해야 합니다. AI가 생성한 코드는 프로젝트의 복잡성이나 컨텍스트에 따라 품질이 달라질 수 있으며, 항상 개발자의 검토가 필요합니다. 사용자 정의 에이전트 등 일부 기능은 아직 공개 프리뷰 단계입니다.8 요금제 및 기능 세부 사항은 작성 시점(2026-07) 이후 변경될 수 있으므로 공식 문서를 함께 확인하시기 바랍니다.


출처

  1. GitHub Copilot now an Integrated Agent in JetBrains IDEs - The JetBrains Blog

  2. Access GitHub Copilot in JetBrains - GitHub Copilot Is Now a Native Agent in JetBrains AI Assistant - Microsoft for Java Developers 2

  3. Using GitHub Copilot in JetBrains IDEs - GitHub Enterprise Cloud Docs

  4. Major agentic capabilities improvements in GitHub Copilot for JetBrains IDEs - GitHub Changelog

  5. JetBrains IDE에서 GitHub Copilot 사용 - GitHub Enterprise Cloud Docs 2 3

  6. Enhance your productivity with Copilot Edits in JetBrains IDEs - GitHub Changelog 2 3

  7. Major agentic capabilities improvements in GitHub Copilot for JetBrains IDEs - GitHub Changelog 2

  8. Major agentic capabilities improvements in GitHub Copilot for JetBrains IDEs - GitHub Changelog 2

  9. Free Plan Support for GitHub Copilot Available on JetBrains IDEs - Microsoft for Java Developers