마케팅, 세일즈, HR, 기획 등 개발자가 아닌 분들이 GitHub Copilot CLI를 처음 설치하고 실무에 활용하는 방법을 처음부터 끝까지 안내합니다.
터미널이 무엇인지 몰라도 괜찮습니다. 이 문서를 위에서부터 순서대로 따라오시면 됩니다. 명령어는 전부 그대로 복사해서 붙여넣기만 하면 동작하도록 준비되어 있습니다.
- 설치하기
- 첫 실행과 GitHub 로그인
- 5분 만에 배우는 기본 사용법
- 슬래시 명령어와 옵션 치트시트
- 반드시 알아야 할 안전 수칙
- 이 저장소 사용법 (학습 로드맵)
- 자주 하는 실수와 트러블슈팅
- 다음 단계 / 공식 자료
Windows 10/11 에는 기본적으로 winget 이라는 설치 도구가 들어 있습니다. 한 번만 설치하면 됩니다. 다시 설치할 필요 없습니다.
Step 1. 시작 메뉴에서 "Windows Terminal" 또는 "PowerShell" 을 열기
- 반드시 PowerShell 7 이상이어야 합니다. 버전 확인:
$PSVersionTable.PSVersion - 만약 5.x 로 나오면 PowerShell 7 설치 를 먼저 하세요.
Step 2. 아래 명령어를 한 줄 복사해서 붙여넣고 Enter:
winget install GitHub.Copilot
Step 3. 설치가 끝나면 터미널을 완전히 닫았다가 다시 열고 아래로 확인:
copilot --version버전 번호가 나오면 설치 완료입니다.
npm 을 이미 쓰고 계신다면 이 방법도 됩니다:
npm install -g @github/copilot(Node.js 22 이상 필요)
- "command not found" → 터미널을 완전히 닫고 다시 여세요.
- "npm : 이 시스템에서 스크립트 실행이 사용 안 함으로 설정되어 있으므로..." → PowerShell 을 관리자 권한으로 열고 다음 실행:
Set-ExecutionPolicy -Scope CurrentUser RemoteSigned
- npm 이 없다 → Node.js 22 이상 을 설치하세요. LTS 버전을 받으세요.
Step 1. 실행:
copilotStep 2. 처음 실행하면 로그인 안내가 나옵니다. 화면에 나온 대로 /login 을 입력하고 Enter:
> /login
그러면 다음과 비슷한 안내가 나옵니다:
Please visit https://github.com/login/device
and enter code: XXXX-XXXX
Step 3. 브라우저에서 위 주소로 접속 → 코드 입력 → GitHub 로그인 승인.
Step 4. 터미널 창으로 돌아오면 로그인 완료 메시지가 뜹니다. 이제 사용 준비 끝.
한 번 로그인하면 다음부터는 자동 로그인 됩니다. 매번 로그인할 필요 없습니다.
언제 쓰나요? 이것저것 시켜 보고, 결과를 확인하면서 이어서 작업할 때. 처음 배울 땐 무조건 이 모드.
시작:
copilot프롬프트가 나오면 그냥 한국어로 말하세요:
> 이 폴더에 있는 csv 파일 목록을 보여줘
Copilot 이 답을 하고, 필요한 경우 명령을 실행하려고 승인을 요청 합니다:
Copilot would like to run: ls *.csv
1. Yes
2. Yes, and approve this tool for the rest of this session
3. No, and tell Copilot what to do differently
- 1 : 이번 한 번만 실행 허용
- 2 : 이번 세션 동안은 다시 안 물어봄 (권장)
- 3 : 거부하고 다른 방법 요청
끝낼 때:
/exit를 입력하거나Ctrl + C두 번.
대화형 모드 안에서 Shift + Tab 을 누르면 모드가 순환하며 바뀝니다. 지금 어떤 모드인지는 화면 하단에 표시됩니다.
| 모드 | 특징 | 언제 쓰나 |
|---|---|---|
| Ask/Execute (기본) | 명령 실행 전 매번 승인을 물어봄 | 간단한 작업, 처음 배울 때 |
| Plan | 먼저 계획을 세워서 보여주고, 확인받은 후 실행 | 복잡하거나 여러 파일을 건드리는 작업 |
| Autopilot | 승인 없이 알아서 다 실행 | 익숙해진 후, 신뢰할 수 있는 반복 작업 |
모드 전환:
Shift + Tab을 한 번씩 누를 때마다Ask/Execute → Plan → Autopilot → Ask/Execute순서로 바뀝니다.
초보자 팁: 처음엔 무조건 Ask/Execute 로 시작하세요. 복잡한 작업은 Plan 으로 계획부터 확인. Autopilot 은 잘못하면 파일이 지워질 수 있으니 정말 익숙해진 후에만 쓰세요.
대화 중에 / 로 시작하는 명령을 쓰면 특수 기능을 부를 수 있습니다.
| 명령 | 하는 일 |
|---|---|
/help |
도움말 전체 보기 |
/login |
GitHub 로그인 (처음 한 번) |
/logout |
로그아웃 |
/model |
사용 모델 변경 (기본은 Claude Sonnet 4.5, GPT-5 등 선택 가능) |
/context |
현재 대화가 얼마나 긴지, 토큰 사용량 확인 |
/compact |
대화 요약해서 짧게 압축 (길어졌을 때) |
/sandbox enable |
로컬 샌드박스 켜기 (파일/네트워크 접근 제한) |
/mcp |
외부 도구(MCP 서버) 관리 |
/feedback |
피드백 제출 |
/exit |
종료 |
| 옵션 | 하는 일 | 예시 |
|---|---|---|
-p "질문" |
대화 안 하고 한 번만 물어봄 | copilot -p "오늘 요일 알려줘" |
-s |
답만 간결하게 출력 | copilot -sp "..." |
--allow-tool='shell(git)' |
git 명령은 승인 없이 실행 허용 | 반복 작업 자동화용 |
--deny-tool='shell(rm)' |
rm(파일 삭제)은 절대 못 하게 막음 | 안전용, 필수 추천 |
--allow-all-tools |
모든 것 승인 없이 실행 | 위험, 절대 그냥 쓰지 말 것 |
--model MODEL |
사용할 모델 지정 | --model gpt-5 |
copilot --deny-tool='shell(rm)' --deny-tool='shell(git push)'이렇게 실행하면 파일 삭제(rm)와 git push 는 절대 못 함. 나머지는 매번 승인 여부를 물어봅니다. 처음 몇 주는 이렇게 쓰세요.
딱 5가지만 지키면 됩니다. 진지하게 읽어주세요.
Copilot CLI 는 실행한 폴더와 그 하위 파일을 모두 볼 수 있습니다. 홈 폴더에서 실행하면 개인 사진, 카톡 백업, 브라우저 다운로드 등 모든 것에 접근 가능합니다.
항상 작업 전용 폴더를 만들고 그 안에서 실행하세요.
좋은 예: ~/work/marketing-2026-q3-report/
나쁜 예: ~/ 또는 ~/Documents/
첫 실행 때 "이 폴더를 신뢰하시겠습니까?" 라고 물어봅니다.
- 내가 만든 작업 폴더 → Yes
- 모르는 폴더 → No
이 옵션을 켜면 Copilot 이 파일 삭제, git 강제 push, 시스템 명령 실행 을 아무 승인 없이 다 할 수 있습니다. 실수로 소중한 파일이 지워질 수 있습니다.
대신 필요한 것만 골라서 허용:
copilot --allow-tool='shell(ls)' --allow-tool='shell(cat)'Copilot 이 명령을 실행하기 전 이런 창이 뜹니다:
Copilot would like to run: rm -rf ./output
1. Yes
2. Yes, and approve for session
3. No
"Yes" 를 누르기 전에 반드시 명령을 읽고 이해하세요. 모르겠다면 3번을 누르고 "이 명령 뭐 하는 건지 설명해줘" 라고 물어보세요.
Copilot 은 프롬프트 처리를 위해 파일 내용의 일부를 GitHub 서버(그리고 모델 제공사)로 전송 합니다.
- 개인정보, 계약서, 비공개 재무 데이터가 든 폴더에서 실행할 때는 회사 정책을 먼저 확인하세요.
- 회사에 별도 "Copilot 이용 지침" 이 있다면 그것을 우선 따르세요.
- 필요 시
/sandbox enable로 로컬 샌드박스를 켜서 네트워크 접근을 제한하세요.
여기까지 오셨다면 설치와 안전 수칙은 완료. 이제 본인 직군의 폴더로 이동해서 챕터 순서대로 학습하시면 됩니다.
graph TD
A["copilot-cli-guide<br/>(이 저장소)"] --> R["README.md<br/>설치 · 인증 · 안전 수칙 · 학습 로드맵<br/>(지금 이 문서)"]
A --> M["marketing/<br/>마케팅"]
A --> S["sales/<br/>세일즈"]
A --> H["hr-ops/<br/>HR · Ops"]
A --> P["pm-planning/<br/>PM · 기획"]
M --> M0["README.md<br/>챕터 인덱스"]
M --> M1["ch1-basics.md<br/>Ch 1 사용법"]
M --> M2["ch2-application.md<br/>Ch 2 활용"]
M --> M3["ch3-professional.md<br/>Ch 3 현업 활용"]
S --> S0["README.md"]
S --> S1["ch1-basics.md"]
S --> S2["ch2-application.md"]
S --> S3["ch3-professional.md"]
H --> H0["README.md"]
H --> H1["ch1-basics.md"]
H --> H2["ch2-application.md"]
H --> H3["ch3-professional.md"]
P --> P0["README.md"]
P --> P1["ch1-basics.md"]
P --> P2["ch2-application.md"]
P --> P3["ch3-professional.md"]
style R fill:#e1f5ff
style M fill:#ffe1e1
style S fill:#e1ffe1
style H fill:#fff9e1
style P fill:#f0e1ff
각 직군 폴더는 동일한 3-챕터 구조 로 되어 있습니다. 챕터가 올라갈수록 난이도가 올라갑니다.
flowchart LR
Start((시작)) --> Setup["메인 README<br/>1~5장<br/>설치 · 인증<br/>안전 수칙"]
Setup --> Role{"내 직군?"}
Role -->|Marketing| M["marketing/<br/>README.md"]
Role -->|Sales| S["sales/<br/>README.md"]
Role -->|HR · Ops| H["hr-ops/<br/>README.md"]
Role -->|PM · 기획| P["pm-planning/<br/>README.md"]
M --> Ch1["Ch 1<br/>사용법<br/>10분"]
S --> Ch1
H --> Ch1
P --> Ch1
Ch1 --> Ch2["Ch 2<br/>활용<br/>30분"]
Ch2 --> Ch3["Ch 3<br/>현업 활용<br/>60분+"]
Ch3 --> Done((팀 자산화<br/>재사용 프롬프트))
style Setup fill:#e1f5ff
style Ch1 fill:#c8e6c9
style Ch2 fill:#fff9c4
style Ch3 fill:#ffccbc
style Done fill:#f8bbd0
| 챕터 | 난이도 | 소요 시간 | 목표 | 다루는 내용 |
|---|---|---|---|---|
| Ch 1. 사용법 | 초급 ★☆☆ | 10분 | 첫 성공 경험 | Copilot 을 처음 실행해서 3~4개 초간단 명령을 실제로 실행 |
| Ch 2. 활용 | 중급 ★★☆ | 30분 | 반복 업무 자동화 | 여러 단계로 이뤄진 소규모 워크플로우, 결과 파일 생성 |
| Ch 3. 현업 활용 | 고급 ★★★ | 60분+ | 팀 자산화 | 여러 데이터 소스 통합, 정기 리포트, 재사용 프롬프트 |
graph LR
Ch1["Ch 1 · 사용법<br/>★☆☆<br/>10분"]
Ch2["Ch 2 · 활용<br/>★★☆<br/>30분"]
Ch3["Ch 3 · 현업 활용<br/>★★★<br/>60분+"]
Ch1 -->|"기본 명령 익힘"| Ch2
Ch2 -->|"자동화 감 잡음"| Ch3
Ch3 -->|"프롬프트 자산화"| Save["재사용 프롬프트<br/>사내 위키·Notion"]
style Ch1 fill:#c8e6c9
style Ch2 fill:#fff9c4
style Ch3 fill:#ffccbc
style Save fill:#e1f5ff
| 직군 | 폴더 | 대표 사용 사례 |
|---|---|---|
| Marketing — 캠페인 데이터 · 콘텐츠 운영 | marketing/ |
광고 CSV 통합, 이미지 리사이즈, 경쟁사 모니터링, GA4 임원 보고서 |
| Sales — 리드 관리 · 영업 자동화 | sales/ |
CRM 리드 정규화, 견적서 자동 생성, 계약서 조항 추출, 콜드 아웃리치 |
| HR / Ops — 채용 · 운영 | hr-ops/ |
이력서 필드 추출, 폴더 리네이밍, 온보딩 체크리스트 |
| PM / 기획 — 프로젝트 · 데이터 | pm-planning/ |
이슈 → 리포트, 회의록 → 액션 아이템, 릴리스 노트 초안 |
- 이 메인 README 를 1~5장까지 순서대로 읽고 설치·로그인 완료
- 이 단계를 건너뛰면 챕터를 못 따라옵니다. 반드시 완료.
- 본인 직군 폴더로 이동
- 예: 마케터라면
marketing/클릭
- 예: 마케터라면
- 폴더 안
README.md를 열어서 챕터 인덱스 확인- Ch 1 → Ch 2 → Ch 3 순서로 진행
- 각 챕터의 예시를 반드시 터미널에서 실제로 실행
- 눈으로 읽기만 하면 안 됩니다. 손을 움직여야 배웁니다.
- Ch 3 프롬프트는 팀 공유 문서에 저장해서 자산화
- 매주·매월 재사용. 옆자리 동료에게도 공유.
이름만 다를 뿐 실제로 재활용 가능한 프롬프트가 많습니다:
- Marketing 의 "CSV 통합" 프롬프트는 재무팀 월결산에 그대로 쓸 수 있습니다.
- HR 의 "이력서 PDF 필드 추출" 프롬프트는 법무팀 계약서 검토에도 응용됩니다.
- PM 의 "회의록 → 액션 아이템" 프롬프트는 어떤 직군에서든 유용합니다.
| 증상 | 원인 | 해결 |
|---|---|---|
command not found: copilot |
설치 후 터미널 재시작 안 함 | 터미널 완전히 닫고 다시 열기 |
| "Windows PowerShell 5" 에서 실행 | 구버전 PowerShell | PowerShell 7 이상 설치 후 그걸로 실행 |
| 로그인 안 됨 | 회사 조직에서 CLI 를 막아둠 | GitHub 관리자에게 "Copilot CLI 정책 허용" 요청 |
| 매번 승인 요청 나옴 | 세션마다 초기화됨 | 옵션 2 ("approve for this session") 선택 |
| 잘못 실행됨 | 프롬프트가 애매함 | "먼저 계획만 보여줘" 로 다시 요청. Plan 모드 활용 |
| 답변이 지나치게 짧음 | 컨텍스트 부족 | 폴더 안에 관련 파일이 있는지 확인 후 재요청 |
| 요금이 걱정됨 | 모델별 크레딧 소비 상이 | /model 로 저비용 모델 선택. /context 로 사용량 확인 |
- 원본은 건드리지 말 것 을 명시 → "원본 보존, 결과는 별도 파일로"
- 먼저 1건/1페이지만 시연 요청 → "1건만 먼저 만들어 확인받고 진행"
- 결과 검증용 부산물 요청 → "매핑 로그", "change_log.csv", "신뢰도 컬럼"
- 되돌리기 가능성 확보 → "undo 스크립트도 함께 만들어줘"
- 자동화 결과에는 사람 검토 지시 → "발송/제출 전 사람이 반드시 검토"
Q. 회사 비밀 문서를 다뤄도 되나요?
A. 회사 정책을 먼저 확인하세요. Copilot 은 프롬프트/파일 내용의 일부를 서버로 전송합니다. 조직에 별도 "생성형 AI 이용 지침" 이 있으면 그것을 우선 따르세요. 필요 시 로컬 샌드박스(/sandbox enable) 로 네트워크 노출을 제한할 수 있습니다.
Q. 요금이 얼마나 나오나요?
A. Copilot 구독료 안에 포함되며, 요청마다 "프리미엄 요청" 크레딧이 소비됩니다. 자세한 요금은 Copilot 요금 안내 참고. 크레딧 사용량은 /context 로 확인 가능합니다.
Q. 인터넷 없이도 되나요? A. 안 됩니다. AI 모델을 GitHub 서버(또는 지정한 프로바이더)와 통신해서 사용합니다.
Q. 결과가 마음에 안 들면? A. 그 자리에서 "이 부분은 이렇게 바꿔줘" 하고 이어서 대화하면 됩니다. 처음부터 완벽한 프롬프트를 쓰려 하지 말고, 대화로 다듬어 가세요.
Q. 다른 사람이랑 프롬프트를 공유하고 싶어요.
A. 프롬프트를 .md 파일로 저장해서 팀 공유 폴더/Notion 에 올려두세요. .github/copilot-instructions.md 파일을 프로젝트 폴더에 두면 팀 전체가 같은 컨텍스트로 시작할 수 있습니다 (copilot init 로 초기 생성 가능).
Q. 설치한 버전을 최신으로 올리려면?
A. copilot update. 또는 설치할 때 쓴 도구로 업그레이드 (winget upgrade, brew upgrade, npm update).
Q. 다이어그램이 이상하게 보여요. A. 이 문서 안의 그림은 GitHub 웹에서 볼 때 자동으로 그림으로 그려지는 Mermaid 문법입니다. GitHub 웹사이트에서 열면 정상적으로 표시됩니다. 로컬 텍스트 에디터에서 열면 코드로 보일 수 있어요.
이 문서를 다 읽으셨다면 이미 실무의 80% 는 해내실 수 있습니다. 아래는 더 깊이 파보고 싶을 때 참고할 공식 자료입니다.
- GitHub Copilot CLI 소개 — https://docs.github.com/en/copilot/concepts/agents/about-copilot-cli
- 설치 가이드 — https://docs.github.com/en/copilot/how-tos/copilot-cli/set-up-copilot-cli/install-copilot-cli
- 명령어 레퍼런스 — https://docs.github.com/en/copilot/reference/copilot-cli-reference/cli-command-reference
- Getting Started 튜토리얼 — https://docs.github.com/en/copilot/how-tos/copilot-cli/cli-getting-started
- GitHub 공식 저장소 (릴리스 노트) — https://github.com/github/copilot-cli
- Copilot 요금제 — https://github.com/features/copilot/plans
- Discussions — https://github.com/github/copilot-cli/discussions
- Issue 트래커 — https://github.com/github/copilot-cli/issues
이 문서에 추가하고 싶은 실무 시나리오가 있다면 언제든지 Issue 나 Pull Request 로 공유해 주세요. 특히:
- 우리 팀에서 실제로 쓰고 있는 프롬프트
- 실수해서 배운 팁
- 특정 툴 (Salesforce, HubSpot, GA4 등) 연동 예시
를 환영합니다. 팀 전체 자산으로 쌓아 갑시다.
Happy Copiloting.
마지막 업데이트: 2026-07-28 (Copilot CLI 정보 기준: 공식 문서 최신판)