1. GitHub Copilot CLI란?
2. 사전 준비 & 설치
3. 첫 번째 체험 — 3가지 데모
4. 3가지 모드 — Interactive · Plan · Autopilot
5. 컨텍스트 & 대화 — @ 문법 마스터
6. 5대 개발 워크플로우
7. 에이전트 — 나만의 AI 전문가 만들기
8. 스킬 — 반복 작업 자동화
9. MCP 서버 — 외부 도구 연결
10. 실전 베스트 프랙티스
11. 참조 링크 모음
1. GitHub Copilot CLI란?
GitHub Copilot CLI는 터미널(명령줄)에서 직접 AI와 대화하면서 코딩하는 도구입니다. 브라우저나 IDE를 왔다갔다 하지 않고, 터미널 하나로 코드 리뷰, 설명, 생성, 디버깅, 테스트까지 전부 처리할 수 있습니다.
한마디로 정의하면:
이 코스의 대상:
- 터미널 중심 워크플로우를 선호하는 개발자
- AI 경험 없이 터미널만 쓸 줄 아는 사람이면 OK
- 팀 단위 AI 코드 리뷰 표준화를 원하는 조직
코스 전체에서 Python 도서 관리 앱이라는 하나의 샘플 프로젝트를 사용하며, 챕터가 진행될수록 AI로 이 앱을 점진적으로 개선합니다.
2. 사전 준비 & 설치
시작하기 전에 필요한 것:
| 항목 | 설명 |
|---|---|
| GitHub 계정 | 무료로 생성 가능 |
| Copilot 액세스 | 무료 플랜, 월간 구독, 또는 학생/교사 무료 |
| 터미널 기초 | cd, ls 등 기본 명령어 사용 가능 |
| Python 3.10+ | 샘플 앱 실행 시 필요 (JS, C# 샘플도 있음) |
설치 방법
⏱️ 설치 시간: 약 2~5분, 인증까지 포함하면 총 5~7분
방법 A — GitHub Codespaces (추천, 설치 없음)
가장 쉬운 방법입니다. 아무것도 설치하지 않아도 됩니다.
- 저장소를 Fork한다
- Code > Codespaces > Create codespace on main 클릭
- 자동으로 환경이 셋업됨 — 바로 시작!
방법 B — 로컬 설치
npm (모든 플랫폼):
npm install -g @github/copilot
macOS / Linux (Homebrew):
brew install copilot-cli
Windows (WinGet):
winget install GitHub.Copilot
인증:
copilot auth login
브라우저가 열리면 GitHub에 로그인하고 권한을 승인하면 완료됩니다.
3. 첫 번째 체험 — 3가지 데모
설치가 끝났으면, 바로 3가지 핵심 용도를 체험할 수 있습니다.
1 코드 리뷰 — 몇 초 만에 전문가 리뷰
copilot > Review @samples/book-app-project/book_app.py for code quality issues and suggest improvements
@ 기호로 파일을 지정하면 Copilot이 해당 파일을 읽고 코드 품질 이슈를 자동으로 분석합니다.
2 코드 설명 — 복잡한 코드를 쉽게 이해
> Explain what @samples/book-app-project/books.py does in simple terms
코드를 읽고 "디지털 책장"이라는 비유를 들어 구조와 함수를 친절하게 설명합니다.
3 코드 생성 — 구글링 15분을 몇 초로
> Write a Python function that takes a list of books and returns statistics: total count, number read, number unread, oldest and newest book
완전히 동작하는 함수를 즉시 생성합니다. 복사-붙여넣기-실행만 하면 됩니다.
4. 3가지 모드 — Interactive · Plan · Autopilot
Copilot CLI는 상황에 따라 3가지 모드를 전환하며 사용합니다. Shift+Tab으로 모드를 순환할 수 있습니다.
| 모드 | 비유 | 용도 |
|---|---|---|
| Interactive | 🍽️ 웨이터와 대화 | 탐색, 반복 작업, 멀티턴 대화 |
| Plan | 🗺️ 여행 전 경로 계획 | 복잡한 작업의 단계별 계획 수립 |
| Autopilot | 🤖 동료에게 일 맡기기 | 계획 승인 후 자동 실행 |
Interactive 모드 (기본값, 여기서 시작)
copilot > Review @samples/book-app-project/utils.py and suggest improvements > Add type hints to all functions > Make the error handling more robust > /exit
핵심 포인트: 이전 대화의 컨텍스트가 유지됩니다. 매번 처음부터 설명할 필요 없이, 마치 동료와 연속 대화하듯이 작업합니다.
Plan 모드 — 먼저 계획, 그 다음 실행
copilot > /plan Add a "mark as read" command to the book app
AI가 4단계 구현 계획을 먼저 제시하고, 사용자가 승인하면 그때 코드를 작성합니다. 복잡한 기능을 추가할 때 특히 유용합니다.
5. 컨텍스트 & 대화 — @ 문법 마스터
Copilot CLI의 핵심 무기는 @ 기호입니다. 이것으로 어떤 파일(들)을 참조할지 정확하게 지정합니다.
| 패턴 | 용도 |
|---|---|
| @파일명.py | 단일 파일 참조 |
| @파일1.py @파일2.py | 여러 파일 동시 참조 |
| @디렉토리/ | 전체 디렉토리 참조 |
실전 활용 예시
크로스 파일 버그 추적:
> Find bugs that span across @book_app.py @books.py @utils.py
코드베이스 60초 이해:
> Explain the architecture of @samples/book-app-project/ in simple terms
세션 관리
Copilot CLI는 대화 세션을 자동 저장합니다. 다음에 이어서 작업할 수 있습니다.
# 가장 최근 세션 이어서 시작 copilot --resume # 특정 세션 이어서 시작 copilot --resume SESSION_ID
6. 5대 개발 워크플로우
이 코스에서 가르치는 5가지 핵심 워크플로우입니다. 목수의 도구상자에 비유하면, 각각 다른 상황에 맞는 전문 도구입니다.
| 번호 | 워크플로우 | 핵심 명령 |
|---|---|---|
| 🔍 | 코드 리뷰 | /review, 인라인 리뷰, 체크리스트 |
| 🔧 | 리팩토링 | 관심사 분리, 에러 핸들링, 문서화 |
| 🐛 | 디버깅 | Bug Detective — 관련 버그 자동 탐지 |
| 🧪 | 테스트 생성 | 2개 → 15개+ 테스트 자동 확장 |
| 📝 | Git 워크플로우 | 커밋 메시지, PR 설명, /delegate |
코드 리뷰 예시
# Git 변경사항 전체 리뷰 > /review # 특정 파일 리뷰 > Review @book_app.py for security issues, especially around input validation
실전 버그 수정 전체 워크플로우
# 1단계: 버그 조사 > Look at @book_app.py — when I run "search" with no arguments, it crashes # 2단계: 수정 요청 > Fix the crash and add input validation # 3단계: 테스트 추가 > Write tests for the fix # 4단계: 커밋 > Generate a commit message for these changes
7. 에이전트 — 나만의 AI 전문가 만들기
에이전트(Agent)는 특정 분야의 전문가를 고용하는 것과 같습니다. 범용 Copilot 대신, Python 리뷰어, 보안 감사관, 테스트 엔지니어 같은 전문 에이전트를 만들 수 있습니다.
에이전트 만들기
프로젝트 루트에 .github/agents/ 디렉토리를 만들고 YAML 파일을 추가합니다:
# .github/agents/python-reviewer.yml name: python-reviewer description: Python 코드 품질 전문 리뷰어 instructions: | You are a senior Python developer. Review code for: - PEP 8 compliance - Type hint completeness - Error handling patterns - Performance issues
에이전트 사용법
# Interactive 모드에서 copilot > @python-reviewer Review @book_app.py # Programmatic 모드에서 echo "Review @book_app.py" | copilot --agent python-reviewer
범용 Copilot vs 전문 에이전트 차이:
| 항목 | 범용 Copilot | 전문 에이전트 |
|---|---|---|
| 리뷰 깊이 | 일반적인 코드 품질 | PEP 8, type hint, 성능 이슈까지 |
| 일관성 | 매번 프롬프트 입력 필요 | 항상 동일한 기준 적용 |
| 팀 공유 | 개인 설정 | Git으로 팀 전체 공유 가능 |
8. 스킬 — 반복 작업 자동화
스킬(Skill)은 에이전트가 사용하는 "전동 공구"입니다. 에이전트가 누구인지 정의한다면, 스킬은 에이전트가 무엇을 하는지 정의합니다.
스킬 vs 에이전트 vs MCP 비교
| 구분 | 에이전트 | 스킬 | MCP |
|---|---|---|---|
| 비유 | 전문가 | 전동 공구 | 외부 서비스 연결 |
| 정의 | 누구인가 (역할) | 무엇을 하는가 (작업) | 외부 데이터/도구 접근 |
| 범위 | 프로젝트/글로벌 | 프로젝트/글로벌/커뮤니티 | 외부 API/DB |
스킬 만들기 예시
# .github/skills/pr-review/SKILL.md --- name: pr-review description: 팀 PR 리뷰 체크리스트 자동 적용 --- PR을 리뷰할 때 다음 항목을 반드시 확인하세요: 1. 보안: SQL 인젝션, XSS 취약점 2. 성능: N+1 쿼리, 불필요한 루프 3. 테스트: 새 코드에 대한 테스트 존재 여부 4. 문서: README 업데이트, 인라인 주석
이렇게 정의하면, 팀 전체가 동일한 기준으로 PR을 리뷰할 수 있습니다.
스킬 관리 명령어
# 로드된 스킬 확인 > /skills # 스킬 새로고침 (파일 수정 후) > /skills reload
9. MCP 서버 — 외부 도구 연결
MCP(Model Context Protocol)는 Copilot CLI를 GitHub, 데이터베이스, API 등 외부 서비스와 연결하는 표준 프로토콜입니다.
MCP를 사용하면:
- GitHub 이슈/PR을 터미널에서 조회·관리
- 데이터베이스에 직접 쿼리
- 외부 API와 연동하여 데이터 수집
# MCP 서버 관리 > /mcp
10. 실전 베스트 프랙티스
코스 마지막 챕터에서 강조하는 4가지 황금 규칙입니다.
1 분석 전에 컨텍스트를 먼저 제공하라
@로 관련 파일을 먼저 로드한 뒤, 질문이나 리뷰를 요청하세요. 컨텍스트 없이 질문하면 일반적인 답변만 돌아옵니다.
2 에이전트·스킬·커스텀 인스트럭션을 구분하라
에이전트 = 누구(역할), 스킬 = 무엇을(능력), 커스텀 인스트럭션 = 프로젝트 규칙. 각각 다른 목적입니다.
3 세션을 집중시켜라
하나의 세션에서 너무 많은 주제를 다루지 마세요. 버그 수정, 새 기능, 리팩토링은 별도 세션에서 진행합니다.
4 워크플로우를 재사용 가능하게 만들어라
자주 쓰는 리뷰 기준, 테스트 패턴을 스킬(.md)로 저장하면, 매번 반복 프롬프트를 입력하지 않아도 됩니다.
보너스: 프로덕션 패턴
# PR 설명 자동 생성 > Generate a PR description for these changes # CI/CD 연동 — 커밋 전 자동 리뷰 > /review > Generate commit message for these changes
11. 참조 링크 모음
| 링크 | 설명 |
|---|---|
| GitHub 코스 저장소 | 전체 코스 원본 (MIT 라이선스) |
| 공식 문서 | GitHub Copilot CLI 공식 가이드 |
| 명령어 레퍼런스 | 전체 CLI 명령어 목록 |
| Copilot 요금제 | 무료 플랜 포함 가격 비교 |
| 학생/교사 무료 | GitHub Education Pack |
— 이 글은 GitHub 공식 저장소 github/copilot-cli-for-beginners를 기반으로 작성되었습니다. —