1. Copilot 설치와 설정

코스: GitHub Copilot & Cursor 개발 생산성 차시: 1 / 20 슬러그: ai-dev-copilot

학습 목표

VSCode·JetBrains·Neovim 환경에서 Copilot 확장을 설치하고 로그인 완료까지 15분 안에 끝낸다.
Individual·Business·Enterprise 3개 플랜의 정책 차이(텔레메트리·퍼블릭 코드 매칭·IP 인덤니티)를 설명하고 회사·개인 상황에 맞게 선택한다.
github.copilot.advanced 설정값을 조정해 자동완성 반응 속도와 품질을 제어한다.
.copilotignore로 시크릿·민감 파일을 업스트림 전송에서 제외한다.

도입

Copilot 설정 파일 한 줄 차이가 자동완성 대기 시간 300ms를 좌우합니다. 기본값으로 며칠 써보고 "생각보다 느리다"며 포기하는 개발자가 많은데, 실제로는 listCount·temperature 같은 숨겨진 옵션 세 개만 고치면 체감이 완전히 달라집니다.

또 한 가지 중요한 포인트는 플랜 선택입니다. 회사 코드를 다룰 거라면 Individual은 금기입니다. 학습 데이터 편입 방지, IP 인덤니티, .copilotignore 같은 기능이 Business부터 시작되기 때문입니다. 이번 강의에서는 설치부터 첫 제안을 뽑기까지, 그리고 대부분 모르는 고급 설정까지 한 번에 정리합니다.

핵심 개념

1) 플랜 선택 (2026-04 기준)

플랜	가격	특징
Individual	월 $10 (연 $100)	개인·사이드 프로젝트용, 학습 옵트아웃 가능
Business	유저당 월 $19	퍼블릭 코드 매칭 필터 기본 ON, 프롬프트 비학습, `.copilotignore` 지원
Enterprise	유저당 월 $39	Knowledge base·PR summary·IP 인덤니티 포함

한국 개발자 대부분은 Individual로 시작하되, 회사 코드에 쓸 거면 반드시 Business 이상. 회사 코드가 학습 데이터로 들어가는 걸 막는 duplicationDetectionFilter가 Individual에는 없습니다. Enterprise의 IP 인덤니티는 Microsoft가 저작권 침해 소송 시 법적 책임을 부담하는 조항이며, 대기업·금융권·공공기관에서 필수로 요구합니다.

2) 설치 절차 (VSCode 기준)

# 확장 2개가 한 세트 (Copilot + Copilot Chat)
code --install-extension GitHub.copilot
code --install-extension GitHub.copilot-chat

설치 후 우측 하단 상태바의 Copilot 아이콘 → "Sign in to GitHub" → 브라우저 OAuth. Business 계정은 Organization owner의 seat 배정이 선행돼야 합니다. owner가 Settings → Copilot → Seats에서 본인 계정을 추가해줘야 로그인 가능.

3) 필수 설정값 (settings.json)

{
  "github.copilot.enable": {
    "*": true,
    "plaintext": false,
    "markdown": true,
    "yaml": true
  },
  "github.copilot.advanced": {
    "listCount": 10,
    "inlineSuggestCount": 3,
    "length": 500
  },
  "editor.inlineSuggest.enabled": true,
  "editor.inlineSuggest.suppressSuggestions": false
}

listCount: Ctrl+Enter로 여는 제안 패널의 개수. 기본 3 → 10으로 올리면 한 번에 10개 중 고를 수 있음
inlineSuggestCount: 인라인 제안 후보 수 (Tab으로 스왑)
length: 제안 최대 길이 (토큰 수 기반, 500 적정)

일부 고급 설정은 버전별 변동이 있으니 VSCode 설정 UI에서 실시간 확인.

상세 설명

`.copilotignore` — 시크릿 유출 차단

Copilot 텔레메트리는 프롬프트 내용과 수락 여부를 서버로 전송합니다. 금융권·공공·의료 코드에 붙일 때는 github.copilot.advanced.debug.overrideProxyUrl로 사내 프록시를 지정하거나, .copilotignore 파일(루트 배치)로 특정 파일을 업스트림 전송에서 제외할 수 있습니다.

# .copilotignore (Business 이상)
.env*
secrets/
**/config/production.*
**/*.key
**/*.pem
credentials.json
.aws/

이 패턴은 .gitignore와 동일하며, 지정된 파일은 Copilot이 컨텍스트로 읽지도 전송하지도 않습니다.

JetBrains 환경

IntelliJ·WebStorm·PyCharm 사용자는 Marketplace에서 "GitHub Copilot" 플러그인 설치 후 Settings → Tools → GitHub Copilot에서 로그인. IntelliJ의 기본 자동완성과 충돌하지 않도록 Editor → General → Code Completion의 "Show suggestions as you type"을 병행 사용해도 무방합니다. 오히려 두 엔진이 상호 보완하는 경우가 많습니다.

Neovim 환경

공식 플러그인 github/copilot.vim을 lazy.nvim 등으로 설치 후 :Copilot setup 실행. WSL 환경이라면 Node.js 18 이상 필수.

-- lazy.nvim 설정 예시
{
  "github/copilot.vim",
  config = function()
    vim.g.copilot_no_tab_map = true
    vim.api.nvim_set_keymap("i", "<C-J>", 'copilot#Accept("<CR>")', { silent = true, expr = true })
  end,
}

텔레메트리 정책 확인

본인 플랜의 정책은 반드시 확인:

GitHub.com → Settings → Copilot
"Suggestions matching public code" → Blocked (권장)
"Allow GitHub to use my code for product improvements" → Off (Individual만, Business는 자동 Off)

흔한 실수 5가지와 처방

Individual 플랜으로 회사 코드 — 코드가 학습 데이터에 편입될 리스크. 처방: Business 이상 필수, Org owner에게 요청.
.copilotignore 미사용 — .env 파일이 그대로 Copilot 서버로 전송. 처방: 루트에 .copilotignore 생성, 시크릿 경로 추가.
Copilot Chat 확장 미설치 — 반쪽짜리 경험. 처방: 2개 확장 한 세트로 설치.
listCount 기본값 3 방치 — 한 번에 3개만 보여 선택지 좁음. 처방: 10으로 상향.
상태바 에러 무시 — 인증 만료·프록시 이슈 누적. 처방: 주간 Show Logs로 에러 확인.

실습 체크리스트

본인 IDE에 Copilot + Copilot Chat 확장 2개 모두 설치
플랜 종류(Individual/Business/Enterprise) 확인, 회사 코드 사용 가능 여부 점검
settings.json에 위 3개 옵션 반영
.copilotignore 파일 생성, .env·시크릿 디렉토리 제외
새 파일에서 // fibonacci 함수 작성 주석 뒤 Tab으로 첫 제안 수락
상태바 아이콘 우클릭 → "Show Logs"로 에러 없는지 확인
"Suggestions matching public code" 설정 Blocked 확인

Copilot 첫 30분 체크

설치 직후 꼭 해봐야 할 5가지:

주석 → Tab 테스트: // fibonacci 함수 작성 후 Tab 눌러 자동완성 수락 성공 확인
Chat 열어보기: Cmd+Shift+I (Mac) / Ctrl+Shift+I (Win)로 Chat 패널 활성화, "hello" 같은 간단한 질문
Inline Chat: 코드 선택 후 Cmd+I → "이 함수에 주석 추가해줘"
설정 확인: 상태바 Copilot 아이콘 클릭 → "Show Logs"로 연결 정상 여부
쿼터 확인: Business/Enterprise는 관리자 대시보드, Individual은 GitHub 설정

이 5가지가 모두 성공하면 환경 구축 완료. 실패 시 로그로 원인 파악 (방화벽·프록시·인증 이슈가 대부분).

정리

Copilot은 설치만 끝내도 "된다"고 느끼지만, 진짜 생산성은 플랜·정책·고급 옵션 3단을 맞춘 뒤에 나옵니다. 특히 회사 코드를 다룰 거면 Business 이상 + .copilotignore가 기본값입니다. Individual로 시작해도 무방하지만 회사 코드를 만지는 순간 즉시 업그레이드해야 합니다. 다음 강의에서는 방금 띄운 자동완성과, Copilot Chat이 어떻게 역할이 다른지 — 자동완성·Inline Chat·Chat 패널·@workspace 4가지 모드를 구분해 상황별로 선택하는 법을 다룹니다. 모드 구분 없이 쓰면 하루 10분 이상 손실이 누적되므로 2강은 Copilot 본격 활용의 필수 관문입니다. 오늘 설치한 Copilot 환경을 기반으로, 2강부터는 실무에서 즉시 쓸 수 있는 패턴을 체계적으로 다룹니다.

Copilot 설치와 설정