본문 바로가기

Copilot

GitHub Copilot 완전 가이드 1편 — 계정 생성부터 VS Code 설치, 첫 자동완성까지 30분 셋업

반응형

 

GitHub Copilot을 한 번도 써본 적 없어도 됩니다. 이 글을 보면서 그대로 따라하면 오늘 바로 쓸 수 있습니다. 계정 만들기부터 VS Code에서 첫 코드 자동완성까지 — 30분이면 됩니다.


핵심 요약

→ GitHub Copilot은 VS Code 등 IDE에서 동작하는 AI 코딩 어시스턴트
현재 Pro/Pro+ 신규 가입 일시 중단 (2026년 4월 20일~, 재개 일정 미정)
Free 플랜은 지금도 가입 가능 — 코드 자동완성 월 2,000회 + AI Credits 기본 제공
→ Free로 시작해서 기능 익힌 뒤 Pro 재개 시 업그레이드하는 게 현재 최선
→ 설치 필요한 것: VS Code(무료) + GitHub 계정(무료) — 둘 다 있으면 5분 셋업
→ 인라인 자동완성(Tab)은 모든 플랜에서 무제한 무료
→ Chat/Agent 기능은 AI Credits 차감
→ 지원 IDE: VS Code, JetBrains(IntelliJ/PyCharm 등), Xcode, Eclipse, Neovim
→ 코드 학습에 사용 안 됨 — Pro/Business/Enterprise 전부 코드 미사용


실전 1 — GitHub 계정 만들기

이미 GitHub 계정이 있으면 실전 2로 건너뛰세요.

Step 1. github.com 접속

브라우저에서 https://github.com 열기 → 우상단 Sign up 클릭

Step 2. 정보 입력

이메일 주소 입력
→ 비밀번호 설정 (8자 이상, 숫자+소문자 포함)
→ 사용자명 입력 (영문+숫자, 나중에 바꾸기 어려우니 신중하게)
→ 이메일 수신 여부 선택 (n 입력해도 무방)
→ 퍼즐 인증 통과
→ Create account 클릭

Step 3. 이메일 인증

가입한 이메일로 인증 코드 발송됨 → 6자리 코드 입력 → 완료

Step 4. 초기 설정 (Skip 가능)

팀 규모, 용도 등 물어보는 화면 → 하단 Skip personalization 클릭해도 됨


실전 2 — Copilot Free 플랜 활성화

현재 상황: Pro/Pro+ 신규 가입 일시 중단 중. Free는 가입 가능.

Step 1. Copilot 설정 페이지 이동

로그인 후 → 우상단 프로필 아이콘 클릭 → Your Copilot 선택

또는 직접 주소 입력: https://github.com/settings/copilot

Step 2. Free 플랜 활성화

"Start using Copilot for free" 또는 "Get Copilot Free" 버튼 클릭
→ 약관 확인 후 동의
→ 완료 — 바로 활성화됨 (카드 정보 불필요)

Free 플랜으로 할 수 있는 것

기능 한도

코드 자동완성 (인라인) 월 2,000회
AI Credits (Chat/Agent) 월 기본 제공량
모델 GPT-4.1 mini, GPT-5 mini 등 기본 모델
IDE 지원 VS Code, JetBrains 등 전체

Pro 플랜은? 현재 신규 가입 중단 상태. GitHub 공식 커뮤니티에서 재개 공지 확인 가능: https://github.com/orgs/community/discussions/192963


실전 3 — VS Code 설치

이미 설치되어 있으면 실전 4로 건너뛰세요.

Step 1. 다운로드

https://code.visualstudio.com 접속 → 운영체제에 맞는 버튼 클릭해서 다운로드

Windows: .exe 파일 다운로드 → 설치 마법사 실행 (기본값으로 Next 클릭)
macOS:   .dmg 파일 다운로드 → Applications 폴더로 드래그
Linux:   .deb 또는 .rpm → 패키지 매니저로 설치
         sudo apt install ./code_xxx.deb  (Ubuntu 기준)

Step 2. 버전 확인

VS Code 열고 → 상단 메뉴 Help → About → 버전 1.95 이상 확인
구버전이면 Help → Check for Updates로 업데이트


실전 4 — Copilot 확장 설치

방법 A: VS Code 내에서 설치 (권장)

VS Code 열기 → 좌측 사이드바에서 블록 4개 모양 아이콘 클릭 (Extensions)

또는 단축키: Ctrl+Shift+X (Windows/Linux) / Cmd+Shift+X (Mac)

검색창에 "GitHub Copilot" 입력
→ "GitHub Copilot" (by GitHub) 선택 — 파란 Install 버튼 클릭
→ 설치 완료되면 자동으로 "GitHub Copilot Chat"도 함께 설치됨

주의: "GitHub Copilot" 하나만 설치해도 됩니다. Chat 기능은 자동으로 포함됩니다.

방법 B: 터미널에서 설치

code --install-extension GitHub.copilot

설치 확인

code --list-extensions | grep copilot
# 출력 결과:
# GitHub.copilot
# GitHub.copilot-chat

실전 5 — GitHub 계정 연결

설치 후 VS Code 우하단 상태바에 Copilot 아이콘(로봇 얼굴)이 생깁니다.

Step 1. 로그인

방법 A: 상태바 Copilot 아이콘 클릭 → "Use AI Features" → "Sign in to GitHub"
방법 B: Ctrl+Shift+P (Cmd+Shift+P) → "GitHub Copilot: Sign in" 입력 → 선택

Step 2. 브라우저 인증

VS Code가 브라우저를 자동으로 엽니다
→ GitHub 로그인 화면 (이미 로그인되어 있으면 스킵)
→ "Authorize GitHub Copilot Plugin for VS Code" 화면
→ 초록색 "Authorize github" 버튼 클릭
→ "Open Visual Studio Code" 팝업 → "열기" 클릭

Step 3. 연결 확인

VS Code 우하단 상태바의 Copilot 아이콘이 활성화됨
→ 아이콘에 X 표시 없이 정상 표시되면 완료

확인 방법:
Ctrl+Shift+P → "GitHub Copilot: Check Status" 입력
→ "Copilot is enabled" 메시지 확인

실전 6 — 첫 자동완성 체험

이제 실제로 써봅니다. 새 파일 만들어서 직접 확인하세요.

Step 1. 새 Python 파일 만들기

Ctrl+N → 새 파일 열림
Ctrl+Shift+P → "Change Language Mode" → "Python" 선택
또는 파일을 test.py로 저장 (Ctrl+S → 파일명 입력)

Step 2. 주석으로 의도 전달 → 자동완성 확인

파일에 아래를 직접 타이핑합니다 (복붙 말고 직접):

# 두 숫자를 더하는 함수

잠깐 기다리면 회색 글씨로 제안이 나타납니다:

# 두 숫자를 더하는 함수
def add(a, b):        ← 이렇게 회색 글씨로 나타남
    return a + b

Tab 키를 누르면 수락됩니다.

Step 3. 함수 이름만 써도 완성

def calculate_fibonacci(

여기까지 타이핑하면 Copilot이 전체 함수를 제안합니다. Tab으로 수락.

Step 4. 더 복잡한 예시

# CSV 파일을 읽어서 딕셔너리 리스트로 반환하는 함수
# 파일이 없으면 빈 리스트 반환
def read_csv(

주석이 구체적일수록 더 정확한 제안이 나옵니다.


실전 7 — 핵심 단축키 (지금 외워야 할 것만)

처음엔 이 6개만 기억하세요. 나머지는 쓰다 보면 자연스럽게 배웁니다.

단축키 (Windows/Linux) 단축키 (Mac) 동작

Tab Tab 제안 전체 수락
Esc Esc 제안 거절
Alt+] Option+] 다음 제안 보기
Alt+[ Option+[ 이전 제안 보기
Ctrl+I Cmd+I 커서 위치에서 인라인 채팅 열기
Ctrl+Alt+I Ctrl+Cmd+I 사이드 채팅 패널 열기

Tab 외에 단어 단위로만 수락하고 싶을 때:

Ctrl+→ (Windows) / Cmd+→ (Mac) — 제안을 한 단어씩만 수락


실전 8 — Chat 기능 첫 사용

인라인 자동완성 다음으로 많이 쓰는 기능입니다.

인라인 채팅 (Ctrl+I): 코드 위에서 바로 질문

def calculate_fibonacci(n):
    result = []
    a, b = 0, 1
    for i in range(n):
        result.append(a)
        a, b = b, a + b
    return result

이 코드를 드래그로 선택 → Ctrl+I → 입력창에:

이 함수에 타입 힌트 추가하고 docstring도 달아줘

결과:

def calculate_fibonacci(n: int) -> list[int]:
    """
    피보나치 수열의 처음 n개 숫자를 반환합니다.
    
    Args:
        n: 반환할 숫자의 개수
    
    Returns:
        피보나치 수열 리스트
    """
    result: list[int] = []
    a, b = 0, 1
    for i in range(n):
        result.append(a)
        a, b = b, a + b
    return result

Accept 버튼 클릭 또는 Enter로 적용.

사이드 채팅 (Ctrl+Alt+I): 자유 대화

채팅 패널 열기 → 아래 슬래시 명령어 바로 써봅니다:

/explain    선택한 코드 설명해줘
/fix        선택한 코드 버그 고쳐줘
/tests      선택한 코드 단위 테스트 만들어줘
/docs       선택한 코드 문서화해줘

실제 예시:

(아무것도 선택하지 않고 채팅창에 입력)

나: Python으로 파일에서 특정 단어 개수 세는 함수 짜줘

Copilot: 
def count_word_in_file(file_path: str, word: str) -> int:
    """파일에서 특정 단어의 출현 횟수를 반환합니다."""
    try:
        with open(file_path, 'r', encoding='utf-8') as f:
            content = f.read()
        return content.lower().split().count(word.lower())
    except FileNotFoundError:
        print(f"파일을 찾을 수 없습니다: {file_path}")
        return 0

채팅창 우상단 Insert into Editor 버튼 클릭 → 현재 커서 위치에 삽입.


실전 9 — 자주 겪는 문제 해결

문제 1: 제안이 안 나와요

확인 순서:
1. 상태바 Copilot 아이콘 → X 표시 없는지 확인
2. Ctrl+Shift+P → "GitHub Copilot: Enable" 입력 → 실행
3. 파일 언어 모드 확인 (우하단 "Plain Text"면 언어 선택)
4. VS Code 재시작
5. 확장 비활성화 확인: Extensions → GitHub Copilot → Enable

문제 2: 로그인이 계속 풀려요

Ctrl+Shift+P → "GitHub Copilot: Sign Out" → 다시 Sign In
또는: File → Preferences → Settings → "github" 검색 → 토큰 확인

문제 3: "Copilot quota exceeded" 오류

Free 플랜 월 한도 소진 → 다음 달 1일 리셋
해결: 채팅에서 더 저렴한 모델 선택 또는 Pro 플랜 가입 대기

문제 4: 제안이 영어로만 나와요

Ctrl+I 또는 채팅창에서 한국어로 질문하면 한국어로 답변
인라인 자동완성은 코드라 언어 무관, 주석은 한글로 써도 됨

실전 10 — 지금 당장 해볼 수 있는 5가지

셋업 완료 후 이 5가지 해보면 Copilot 감이 잡힙니다.

1. 새 .py 파일에서 주석으로 함수 설명 쓰고 Tab으로 완성
   예: "# 이메일 주소 유효성 검사 함수"

2. 기존 코드 선택 → Ctrl+I → "/explain" 입력
   → Copilot이 코드 설명해주는 거 확인

3. 버그 있는 코드 선택 → Ctrl+I → "/fix 입력"
   → 자동 수정 제안 확인

4. 함수 하나 작성 → 선택 → "/tests" 입력
   → 단위 테스트 자동 생성 확인

5. 채팅창에서 "내가 작성한 코드 리뷰해줘" 입력
   → 코드 품질 피드백 받기

마무리

항목 상태

✅ Free 플랜 지금 바로 가입 가능 카드 불필요, 5분 셋업
✅ 인라인 자동완성 무제한 무료 모든 플랜 공통
✅ VS Code + JetBrains 지원 쓰던 IDE 그대로
⚠️ Pro/Pro+ 신규 가입 일시 중단 재개 시점 미정, Free로 먼저 시작
❌ 무료 플랜 Chat 한도 있음 헤비 사용자는 Pro 재개 후 업그레이드

설치하고 첫 Tab 수락하는 순간 바로 체감됩니다. 지금 셋업하세요.

2편에서는 AI Credits 구조를 완전히 해부합니다. 1 크레딧이 $0.01인데, 어떤 모델을 어떻게 쓰면 Pro의 $10이 하루 만에 사라지는지 — 지금 당장 알아야 할 내용입니다.

 

관련 글

 

반응형