GitHub Copilot 셋업 — Claude Code · Cursor와의 역할 분담

AI 코딩 도구 3강 시대다. Claude Code는 long-context 다파일 작업, Cursor는 inline 편집 + repo 인식, GitHub Copilot은 가장 빠른 한 줄 자동완성. 셋 다 동시에 쓰는 사람이 늘고 있다. 이 가이드는 Copilot을 30분 안에 셋업하고, 나머지 둘과 역할 분담하는 방법을 정리한다.

대상은 이미 Claude Code 또는 Cursor를 쓰는 개발자. Copilot 단독으로 시작하려는 사람은 Cursor 셋업을 먼저 보는 것이 빠를 수 있다.

TL;DR

1. GitHub Pro 또는 Copilot 구독 ($10/월 또는 학생 무료) — gh auth status 로 로그인 확인
2. VS Code: GitHub Copilot 확장 + GitHub Copilot Chat 확장 한 쌍 설치
3. JetBrains: Settings → Plugins → GitHub Copilot → 로그인
4. Inline 자동완성 (Tab) + Chat 패널 (Ctrl+I) — 두 가지만 익혀도 충분
5. 역할 분담: Copilot = 키 입력 보조, Claude Code = 멀티파일 작업, Cursor = 둘 사이

사전 조건

• GitHub 계정 + Copilot 구독 (Pro/Business/Enterprise 중 하나)
• VS Code 1.95+ 또는 JetBrains 2024.2+
• 인터넷 (Copilot 자체는 클라우드 호출)

1. Copilot의 위치 — 무엇이 강점인가

Copilot이 잘하는 것

• 한 줄 ~ 한 함수 자동완성 — 가장 빠른 응답 (200~500ms)
• 반복 패턴 — 비슷한 함수 5개 작성할 때 다음 함수의 본문 추론
• Boilerplate — JSDoc 주석, getter/setter, 단순 mapper 함수
• 이미 작성한 패턴 따라가기 — 파일 위쪽의 스타일을 아래쪽에 일관 적용

Copilot의 한계

• 다파일 작업 — 같은 파일 안의 컨텍스트만 강함. 다른 파일 영향 약함
• 아키텍처 변경 — 함수 시그니처 변경 후 호출처 일괄 수정 같은 작업은 못함
• 긴 사고 필요한 작업 — "이 함수 왜 느린가?"에 대답하는 능력 약함
• 장문 자연어 협업 — Chat은 있지만 Claude/Cursor만큼 깊이 없음

Copilot은 타이핑 보조 도구라고 생각하면 정확하다. Claude Code/Cursor가 협업자라면 Copilot은 자동완성.

2. 설치 — VS Code

2.1 확장 설치

VS Code Extensions (Ctrl+Shift+X):

1. GitHub Copilot — inline 자동완성 (Tab)
2. GitHub Copilot Chat — Chat 패널 + inline edit (Ctrl+I)

둘 다 필수. Copilot만 깔면 Chat 기능 없음.

또는 CLI:

code --install-extension GitHub.copilot
code --install-extension GitHub.copilot-chat

2.2 로그인

설치 후 우하단 톱니바퀴 → Sign in to GitHub → 브라우저에서 인증 → VS Code로 복귀.

확인:

View → Output → "GitHub Copilot" 채널 선택
→ "User: <your-username>" 출력되면 OK

2.3 첫 사용

새 파일에서 함수 시그니처 한 줄 쓰면 회색 텍스트로 본문 제안 → Tab 수락, Esc 거절.

def calculate_total(items: list[dict]) -> float:
    # Copilot이 회색으로 구현 제안 → Tab

3. 설치 — JetBrains (IntelliJ, PyCharm, WebStorm 등)

3.1 플러그인

Settings → Plugins → Marketplace:

• GitHub Copilot (한 패키지에 inline + Chat 통합)

설치 → IDE 재시작.

3.2 로그인

Tools → GitHub Copilot → Log in to GitHub → 브라우저 → 코드 입력 → 인증 완료.

확인: 우하단 상태바에 Copilot 아이콘.

3.3 단축키

• 자동완성 수락: Tab
• 다음 제안: Alt + ]
• 이전 제안: Alt + [
• Chat 열기: Ctrl + Shift + I (Windows/Linux) / Cmd + Shift + I (Mac)

4. 핵심 기능 4가지

4.1 Inline 자동완성 (Tab)

기본. 함수 시그니처·주석을 단서로 본문 추론. 다음 줄에서 멈췄을 때 자동 발동.

팁: 함수 위에 짧은 주석 한 줄(# returns the largest item by price)을 쓰면 정확도 크게 상승.

4.2 Chat 패널 (사이드바)

VS Code: Ctrl + Alt + I / JetBrains: Ctrl + Shift + I. 자연어 질문 + 코드 블록 인용 가능.

자주 쓰는 패턴:

• "이 함수 시간 복잡도?" — 코드 선택 후 chat에 붙여넣기
• "여기에 단위 테스트 짜줘" — 현재 파일 컨텍스트 자동 첨부
• "이 SQL 쿼리 EXPLAIN 결과 해석해줘"

4.3 Inline Edit (Ctrl+I)

VS Code: 코드 선택 후 Ctrl + I → 자연어 명령 → diff 보고 수락.

# 선택 후 Ctrl+I → "convert to async"
def fetch_user(id):
    return db.query(id)
# ↓ 변환
async def fetch_user(id):
    return await db.query(id)

Cursor의 inline edit과 유사하나 컨텍스트 범위는 좁음.

4.4 Slash 명령 (Chat)

Chat 입력에서 /:

• /explain — 선택한 코드 설명
• /fix — 에러/lint 자동 수정
• /tests — 단위 테스트 생성
• /doc — JSDoc / docstring 생성
• /optimize — 성능 개선 제안

5. 다른 도구와의 역할 분담

세 도구를 모두 켜놓고 쓰는 일이 점점 일반화. 충돌 방지·역할 명확화 핵심.

충돌: VS Code에서 Copilot + Cursor 동시 설치 시 inline 자동완성이 경쟁. Cursor를 우선 쓸 거면 Copilot의 inline 자동완성을 비활성화하고 Chat·Slash만 사용 가능.

6. 설정 — 자주 쓰는 옵션

6.1 특정 언어에서 끄기

VS Code settings.json:

{
  "github.copilot.enable": {
    "*": true,
    "plaintext": false,
    "markdown": false,
    "yaml": false
  }
}

이유: yaml/markdown에서 Copilot이 부정확한 제안을 자주 함. 끄는 것이 흐름에 좋음.

6.2 자동완성 동작 미세 조정

{
  "editor.inlineSuggest.enabled": true,
  "github.copilot.editor.enableAutoCompletions": true,
  "github.copilot.advanced": {
    "length": 500,            // 최대 토큰
    "temperature": "0.1"      // 더 보수적 (낮을수록 안전)
  }
}

6.3 GitHub 워크플로 통합

• PR 본문 자동 생성 — github.com PR 페이지의 Copilot 아이콘
• 이슈 → PR Connect — GitHub UI에서 자동 제안
• Code review — Copilot Workspace (Enterprise)

7. 라이센스 / 요금 (2026-05 기준)

학생/오픈소스 메인테이너는 GitHub Education으로 Pro 무료.

확인:

gh auth status
# Logged in to github.com as <username>
# Active account: true (...)

또는 github.com/settings/copilot.

8. 검증

# 1. 인증
gh auth status
 
# 2. VS Code 확장
code --list-extensions | grep -i copilot
# GitHub.copilot
# GitHub.copilot-chat
 
# 3. 빈 함수에서 Tab — 자동완성 떠야 함
echo 'def hello(name):' > /tmp/test.py && code /tmp/test.py
 
# 4. Chat 동작 — Ctrl+Alt+I 후 "say hi"

9. 트러블슈팅

자동완성이 안 나옴

• 우하단 상태바 Copilot 아이콘 클릭 → "Enable for this file" 확인
• Network proxy 환경: http.proxy VS Code 설정 확인. 회사 프록시는 별도 인증서 필요
• 사용량 한도 (Free 플랜): github.com/settings/copilot/usage 에서 확인

Copilot: GitHub authentication failed

Cmd Palette → "GitHub: Sign Out" → "GitHub Copilot: Sign In"

토큰 만료 또는 권한 변경 시 재로그인.

Chat이 빈 응답

• 인터넷 연결 확인 (ping github.com)
• 회사 방화벽이 *.githubcopilot.com 차단했을 수 있음
• VS Code → Output → "GitHub Copilot Chat" 채널 로그 확인

Cursor와 함께 쓰면 자동완성이 두 개 뜸

Cursor의 Settings → Models → Disable Copilot inline suggestions 또는 Copilot의 github.copilot.editor.enableAutoCompletions = false. 한 쪽만 inline 담당.

제안이 너무 길고 산만함

• github.copilot.advanced.length 를 300 정도로 낮춤
• 함수 위 주석을 짧게 (한 줄)
• 빈 줄을 사이에 두면 종종 더 짧은 제안이 나옴

회사 정책으로 private repo가 학습됨

Business/Enterprise 플랜: Settings → Copilot → Disable code referencing. Pro는 옵션 없음 (학습은 GitHub 정책 기본 OFF로 변경된 지 오래).

10. 다음 단계

• Cursor 셋업 — /ai-agents/cursor-setup
• Claude Code 셋업 — /ai-agents/claude-code
• 세 도구 같이 쓰는 워크플로 — (예정) /ai-agents/multi-tool-workflow

참고

• GitHub Copilot 공식 문서
• Copilot 요금제
• GitHub Education — 학생 무료
• VS Code Copilot 가이드

변경 이력

• 2026-05-16: 첫 작성. Copilot 설치 + 4기능 + Claude Code/Cursor 역할 분담 표 + 트러블슈팅 6종.