GitHub Copilot CLI란?
GitHub Copilot CLI는 GitHub가 게시한 명령줄 AI 코딩 에이전트로, 공식 제품 페이지에서 설명하고 있습니다. 에디터가 아닌 터미널 내에서 실행되며, 저장소를 읽고, 변경을 제안하고, 승인한 셸 명령을 실행하고, 채팅 형태의 인터페이스로 코드베이스에 대한 질문에 답할 수 있습니다. 기본적으로 이러한 모든 요청은 GitHub 인프라에서 호스팅되는 모델이 처리하며, GitHub 자격 증명을 통해 네트워크로 접근합니다 — CLI는 모델 가중치를 배포하거나 로컬에서 실행하지 않습니다.
- 핵심 기능: 터미널에 상주하는 에이전트형 코딩 어시스턴트 — 프로젝트 파일을 읽고, 변경을 제안 및 적용하며, 확인 후 명령을 실행할 수 있음
- 기본 추론: GitHub Copilot 구독 등급에 따라 결정되는, GitHub 자체가 호스팅하는 모델을 통한 클라우드 기반 처리
- 선택적 로컬 경로: BYOK 설정(4개의 환경 변수)으로 모델 호출을 자신의 기기나 네트워크에 있는 자체 호스팅 서버 — Ollama, vLLM, Foundry Local, 또는 호환 엔드포인트 — 로 리다이렉션 가능
- 개발사: GitHub(Microsoft의 자회사)
- 배포 방식: npm 패키지
@github/copilot, Homebrew와 WinGet으로도 이용 가능
Copilot CLI의 배경
GitHub Copilot CLI는 GitHub의 기존 Copilot 제품군을 터미널로 확장한 것으로, 에디터 및 채팅 통합과 동일한 계정 및 구독 모델을 따릅니다.
- 1Copilot CLI가 터미널 기반 코딩 에이전트로 출시
Why it matters: GitHub는 Copilot을 에디터 너머로 확장하여, npm, Homebrew, WinGet으로 설치 가능하고 기존 GitHub 자격 증명으로 인증되는 독립형 명령줄 에이전트를 제공했습니다. - 2BYOK 및 커스텀 모델 프로바이더 지원 추가
Why it matters: GitHub는 환경 변수를 통해 Copilot CLI를 자체 호스팅 모델 서버 — Ollama, vLLM, Foundry Local — 에 연결하는 문서를 게시하여, 기본 클라우드 모델과 별개로 CLI에 선택적 로컬 추론 경로를 제공했습니다. GitHub의 [BYOK 문서](https://docs.github.com/en/copilot/how-tos/copilot-cli/customize-copilot/use-byok-models) 참조. - 3AI Credits가 Copilot 전반의 사용량 계산을 통합
Why it matters: GitHub는 사용량 계산을 통합하여, 유료 개인 요금제에서 Copilot Chat, 에이전트 모드, 코드 리뷰, Copilot CLI가 모두 동일한 월간 AI Credits 할당량에서 소비되도록 했습니다. CLI 사용량을 별도로 측정하지 않습니다.
GitHub Copilot CLI로 무엇을 할 수 있나요?
- 에이전트형 터미널 채팅 — 파일을 읽고, 여러 파일에 걸친 변경을 제안하고, 코드를 설명할 수 있는 터미널 내 대화형 인터페이스로
copilot명령으로 실행 - 승인 후 명령 실행 — Copilot CLI는 셸 명령을 제안하고 실행할 수 있지만, 시스템이나 저장소를 변경하는 작업을 실행하기 전에는 확인을 요청
- 저장소 인식 — 일반적인 제안이 아니라 실제 코드베이스에 근거한 답변과 변경을 위해 프로젝트 파일과 구조를 읽음
- 기본 클라우드 모델 — 기본 상태에서 요청은 GitHub 계정과 구독 등급을 통해 인증된 GitHub 자체 호스팅 모델이 처리
- BYOK / 커스텀 모델 프로바이더 — 4개의 환경 변수(
COPILOT_PROVIDER_BASE_URL,COPILOT_MODEL,COPILOT_PROVIDER_TYPE,COPILOT_PROVIDER_API_KEY)로 자체 호스팅 로컬 서버를 포함한 다른 모델 백엔드로 Copilot CLI를 리다이렉션 가능 - 지원되는 로컬 프로바이더 — GitHub의 BYOK 문서에는 Ollama, vLLM, Foundry Local이 명시적으로 언급되며, 그 외 "OpenAI Chat Completions API 호환 엔드포인트"도 포함
- BYOK 모델 요구사항 — Copilot CLI를 연결하는 모델은 도구 호출과 스트리밍을 지원해야 하며, 신뢰할 수 있는 에이전트 동작을 위해 GitHub는 128k 토큰 컨텍스트 윈도우를 권장
사용 예시: Copilot CLI를 사용하는 세 가지 방법
다음은 GitHub 자체 문서를 기반으로 한 구체적인 워크플로이며, 가정적인 사용 사례가 아닙니다.
기본 클라우드 모델로 Copilot CLI 사용하기
npm install -g @github/copilot로 설치하고, copilot을 실행한 다음, 기존 GitHub 계정으로 인증합니다. 이 시점부터 모든 요청은 네트워크를 통해 GitHub가 호스팅하는 모델로 전송됩니다 — 이것이 기본 동작이며, 추가 설정은 필요 없고 CLI 접근이 포함된 GitHub Copilot 구독 등급만 있으면 됩니다.
BYOK를 통해 Copilot CLI를 로컬 Ollama 모델에 연결하기
Ollama를 실행하고 도구 호출과 스트리밍을 지원하는 모델을 로드합니다(128k 컨텍스트 모델 권장). COPILOT_PROVIDER_BASE_URL을 로컬 Ollama 엔드포인트로, COPILOT_MODEL을 모델 이름으로 설정합니다. 로컬 Ollama 인스턴스에는 COPILOT_PROVIDER_API_KEY가 필요하지 않습니다. copilot을 실행하면 — 요청이 이제 GitHub의 클라우드 모델 대신 로컬 Ollama 서버로 전송됩니다.
자체 호스팅 vLLM 또는 Foundry Local 서버에 Copilot CLI 연결하기
자신의 하드웨어나 네트워크에서 vLLM 또는 Foundry Local을 실행하여 OpenAI 호환 엔드포인트를 노출합니다. COPILOT_PROVIDER_BASE_URL을 해당 엔드포인트로, COPILOT_MODEL을 서빙되는 모델 이름으로 설정합니다. 엔드포인트가 기본적으로 OpenAI 호환이 아닌 경우에만 COPILOT_PROVIDER_TYPE을 설정합니다. 이렇게 하면 추론이 GitHub가 아닌 자신의 인프라 내에 머무릅니다.
Copilot CLI 설치 및 시작하기
Copilot CLI는 다운로드형 앱이 아니라 명령줄 패키지로 설치됩니다. GitHub의 문서에 따라 npm, Homebrew, WinGet 중 하나로 설치한 다음, 기존 GitHub 계정으로 인증하세요.
방법 | 명령어 / 참고사항 |
|---|---|
| npm(모든 플랫폼) | npm install -g @github/copilot |
| Homebrew(macOS/Linux) | Homebrew를 통해 이용 가능 — 정확한 포뮬러는 GitHub 설치 문서 참조 |
| WinGet(Windows) | WinGet을 통해 이용 가능 — 정확한 패키지 ID는 GitHub 설치 문서 참조 |
| 실행 | copilot(기존 GitHub 자격 증명으로 인증) |
어느 경우든 GitHub 계정이 필요합니다. 기본 클라우드 모델을 사용하려면 CLI 접근이 포함된 GitHub Copilot 구독 등급이 추가로 필요합니다(Free 등급으로도 가능하며, 사용량은 제한됨). 로컬/BYOK 경로를 설정하려면 Ollama, vLLM, Foundry Local 중 하나를 직접 실행해야 합니다 — Copilot CLI는 로컬 모델 서버를 설치하거나 관리해주지 않습니다.
GitHub Copilot CLI 가격
Copilot CLI 접근은 GitHub Copilot 구독에 따라 결정되며, 별도로 판매되지 않습니다. 아래 등급은 GitHub가 공개한 개인용 및 비즈니스 요금제를 반영합니다. 등급과 크레딧 할당량이 변경될 수 있으므로 결정하기 전에 github.com/features/copilot/plans에서 현재 가격을 확인하세요.
Free
- 가격:
- 0달러
- AI Credits / 포함 내용:
- 월 2,000회 코드 완성과 월 50회 채팅 요청; Copilot CLI 접근이 포함되며 이 할당량으로 제한됨
Pro
- 가격:
- 월 10달러
- AI Credits / 포함 내용:
- 월 15달러 상당의 AI Credits, Copilot Chat, 에이전트 모드, 코드 리뷰, Copilot CLI 간 공유
Pro+
- 가격:
- 월 39달러
- AI Credits / 포함 내용:
- 월 70달러 상당의 AI Credits, 동일한 기능 세트에서 공유
Max
- 가격:
- 월 100달러
- AI Credits / 포함 내용:
- 월 200달러 상당의 AI Credits, 동일한 기능 세트에서 공유
Business
- 가격:
- 사용자당 월 19달러
- AI Credits / 포함 내용:
- 팀 단위 요금제; 현재 AI Credits 할당량은 GitHub 요금제 페이지 확인
Enterprise
- 가격:
- 사용자당 월 39달러
- AI Credits / 포함 내용:
- 조직 단위 요금제; 현재 AI Credits 할당량은 GitHub 요금제 페이지 확인
AI Credits는 유료 개인 요금제당 하나의 공유 풀입니다 — Copilot CLI를 많이 사용하면 Copilot Chat, 에이전트 모드, 코드 리뷰와 동일한 할당량을 소비하며, CLI 전용 별도 예산이 아닙니다. BYOK/로컬 모델 경로는 GitHub가 모델을 실행하지 않으므로 GitHub의 AI Credits를 전혀 소비하지 않지만, 자신의 Ollama, vLLM, Foundry Local 설정에 드는 호스팅 비용은 스스로 부담해야 합니다. 이 수치는 리뷰 작성 시점 기준으로 정확했습니다. GitHub는 이전에도 Copilot 가격을 변경한 적이 있으며 앞으로도 변경할 수 있으므로 — 이 표를 영구적인 것으로 여기지 말고 위 링크에서 확인하세요.
GitHub Copilot CLI vs. Aider
GitHub Copilot CLI와 Aider는 둘 다 터미널 기반 AI 코딩 에이전트이지만, 추론이 어디서 일어나고 비용을 어떻게 지불하는지에 대한 기본값이 거의 정반대입니다.
기본 추론
- GitHub Copilot CLI:
- GitHub가 호스팅하는 모델을 통한 클라우드
- Aider:
- 설정한 API 키를 통한 클라우드 — 또는 Ollama 등을 통한 완전한 로컬 실행
로컬 모델 경로
- GitHub Copilot CLI:
- Ollama, vLLM, Foundry Local을 가리키는 선택적 BYOK 설정(4개 환경 변수)
- Aider:
- Ollama 및 기타 OpenAI 호환 서버를 통한 로컬 모델의 네이티브 지원, 별도 BYOK 모드 불필요
라이선스
- GitHub Copilot CLI:
- 독점, 비공개 소스
- Aider:
- 오픈소스(Apache-2.0); PromptQuorum의 Aider 리뷰 참조
접근 / 가격
- GitHub Copilot CLI:
- GitHub Copilot 구독에 따라 결정, Free부터 월 100달러까지
- Aider:
- 도구 자체는 무료; 사용하는 API나 로컬 컴퓨팅 비용만 지불
GitHub 통합
- GitHub Copilot CLI:
- GitHub 계정 및 저장소와의 네이티브, 퍼스트파티 통합
- Aider:
- 모든 Git 저장소에서 작동; GitHub 전용 통합 불필요
완전한 로컬, 오프라인 가능 워크플로가 우선순위라면, Aider는 이를 선택적 설정 단계가 아니라 최우선 기본값으로 다룹니다 — 정확한 로컬 모델 설정은 PromptQuorum의 Aider 리뷰를 참조하세요.
GitHub Copilot CLI는 누구에게 적합한가요?
Copilot CLI가 적합한지는 기본 클라우드 추론에 대한 편안함, 그리고 로컬 모델을 원할 경우 BYOK 경로에 얼마나 노력을 들일 의향이 있는지에 달려 있습니다.
다음의 경우 GitHub Copilot CLI를 사용하세요
- 코드와 워크플로가 이미 GitHub에 있고, 해당 계정에 직접 연결된 터미널 에이전트를 원하는 경우
- 기본적으로 클라우드 호스팅 추론이 괜찮고, 추가 설정 없이 GitHub 자체 모델을 사용하고 싶은 경우
- 컴플라이언스나 오프라인 사유로 로컬 Ollama, vLLM, Foundry Local 서버에 연결하는 BYOK 경로가 구체적으로 필요하고, 직접 환경 변수를 설정하는 데 문제가 없는 경우
- 이미 GitHub Copilot 구독료를 지불하고 있거나 Free 등급 자격을 갖추고 있으며, 동일한 요금제에 CLI 접근이 포함되기를 원하는 경우
다음의 경우 기다리거나 다른 곳을 찾아보세요
- 로컬 및 오프라인 추론을 선택적 설정 단계가 아니라 기본값으로 다루는 도구를 원하는 경우 — 위의 Aider와의 비교 참조
- 기반이 되는 에이전트의 소스 코드가 검사를 위해 공개되어 있기를 원하는 경우 — Copilot CLI는 비공개 소스임
- 클라우드 모델을 사용하는 CLI 이용량을 GitHub의 AI Credits 계산에서 완전히 분리하고 싶은 경우 — Copilot CLI에는 공유 크레딧 풀과 별도인 클라우드 전용 등급이 없음
- 자신의 Ollama, vLLM, Foundry Local 서버를 직접 실행하고 유지관리할 의향이 없는 경우 — Copilot CLI는 사용자를 위해 로컬 모델 실행 환경을 관리해주지 않음
경쟁 제품 및 대안
GitHub Copilot CLI는 여러 다른 터미널 기반 AI 코딩 에이전트와 동일한 세그먼트에 속합니다. 이 리뷰는 로컬 LLM 소프트웨어 디렉터리의 GitHub Copilot CLI 항목을 보완하는 심층 리뷰입니다 — 전체 카탈로그는 해당 페이지를 참고하세요.
- Aider — 로컬 모델을 선택 사항이 아닌 최우선 옵션으로 다루는 오픈소스 터미널 코딩 에이전트. Aider 리뷰와 위의 직접 비교 참조.
- OpenCode — 또 다른 터미널 기반 코딩 에이전트. PromptQuorum의 OpenCode 리뷰 참조.
- Shell-GPT — 더 가벼운 명령줄 AI 어시스턴트. Shell-GPT 리뷰 참조.
- Tabby — 자신의 인프라에서 완전히 실행되도록 설계된 자체 호스팅 AI 코딩 어시스턴트. Tabby 리뷰 참조.
GitHub Copilot CLI 평가 시 흔한 실수
Copilot CLI에 대한 대부분의 혼란은 인터페이스가 실행되는 위치와 AI 모델이 실행되는 위치를 혼동하거나, 공유 AI Credits와 BYOK 요구사항이 작동하는 방식을 오해하는 데서 비롯됩니다.
실수 1: "로컬 터미널에서 실행된다"를 "로컬 추론을 실행한다"로 착각하기
Copilot CLI의 인터페이스는 자신의 기기에서 실행되지만, 기본적으로 모델 자체는 네트워크를 통해 접근하는 GitHub의 서버에서 실행됩니다. 로컬 추론은 BYOK 경로(4개 환경 변수)를 설정하여 Copilot CLI를 Ollama처럼 직접 운영하는 서버로 향하게 할 때만 일어납니다. 그렇게 설정하기 전까지는 기본 설정을 AI 모델을 로컬에서 실행하는 것으로 설명하지 마세요.
실수 2: BYOK가 어떤 모델과도 작동할 것이라고 기대하기
BYOK를 통해 Copilot CLI를 연결하는 모델은 도구 호출과 스트리밍을 지원해야 합니다. GitHub는 128k 토큰 컨텍스트 윈도우를 권장합니다. 도구 호출을 지원하지 않는 모델은 엔드포인트 자체는 성공적으로 연결되더라도 Copilot CLI의 에이전트 기능과 제대로 작동하지 않습니다.
실수 3: 유료 요금제에서 Copilot CLI 사용량이 무제한이라고 생각하기
유료 개인 등급은 Copilot Chat, 에이전트 모드, 코드 리뷰가 사용하는 것과 동일한 월간 AI Credits 풀에 대해 Copilot CLI 사용량을 측정합니다. 같은 청구 기간에 다른 Copilot 기능도 사용하고 있다면, CLI를 많이 사용할 경우 이 공유 할당량이 예상보다 빨리 소진될 수 있습니다.
실수 4: Copilot CLI에 유료 구독이 필요하다고 가정하기
GitHub Copilot의 Free 등급에는 월 2,000회 코드 완성 및 월 50회 채팅 요청과 함께 Copilot CLI 접근이 포함되어 있습니다 — CLI를 사용해보는 데 유료 요금제가 엄격히 필요한 것은 아니며, 이러한 사용량 한도를 높이려는 경우에만 필요합니다.
자주 묻는 질문
GitHub Copilot CLI란 무엇인가요?
GitHub Copilot CLI(github.com/features/copilot/cli)는 GitHub의 명령줄 AI 코딩 에이전트입니다. 터미널에서 실행되며, 저장소를 읽고, 채팅 형태의 인터페이스로 변경을 제안하고 승인한 명령을 실행할 수 있습니다.
GitHub Copilot CLI는 기본적으로 AI 모델을 로컬에서 실행하나요?
아니요. 기본적으로 요청을 네트워크를 통해 GitHub 자체가 호스팅하는 모델로 전송합니다. 로컬 터미널에서 실행되지만, 이는 로컬 추론을 실행하는 것과는 다릅니다.
GitHub Copilot CLI는 Ollama 같은 로컬 모델을 사용할 수 있나요?
네, 4개의 환경 변수로 설정하는 BYOK(bring-your-own-key) 구성을 통해 가능합니다: COPILOT_PROVIDER_BASE_URL과 COPILOT_MODEL(필수), 그리고 COPILOT_PROVIDER_TYPE과 COPILOT_PROVIDER_API_KEY(선택)입니다. GitHub는 Ollama, vLLM, Foundry Local을 지원되는 로컬 프로바이더로 명시적으로 언급합니다.
GitHub Copilot CLI는 무료인가요?
GitHub Copilot의 Free 등급(0달러)에는 월 2,000회 코드 완성과 월 50회 채팅 요청으로 제한된 Copilot CLI 접근이 포함됩니다. 유료 등급은 개인용의 경우 Pro(월 10달러)부터 Max(월 100달러)까지, 팀용의 경우 Business(사용자당 월 19달러)부터 Enterprise(사용자당 월 39달러)까지 있습니다 — 현재 가격은 github.com/features/copilot/plans에서 확인하세요.
GitHub Copilot CLI는 어떤 라이선스를 사용하나요?
독점이며 비공개 소스입니다. 공개 소스 코드 저장소가 없으므로 이 도구에는 GitHub 스타 수가 적용되지 않습니다.
GitHub Copilot CLI는 어떻게 설치하나요?
npm install -g @github/copilot을 실행하거나 Homebrew 또는 WinGet으로 설치한 다음, copilot 명령으로 실행하고 기존 GitHub 계정으로 인증하세요.
GitHub Copilot CLI는 어떤 로컬 모델 프로바이더를 지원하나요?
GitHub의 BYOK 문서에는 Ollama, vLLM, Foundry Local이 명시적으로 언급되며, 그 외 OpenAI Chat Completions API 호환 엔드포인트도 포함됩니다.
AI Credits란 무엇이며 Copilot CLI에 어떻게 적용되나요?
AI Credits는 유료 개인 요금제의 월간 사용 할당량으로, Copilot Chat, 에이전트 모드, 코드 리뷰, Copilot CLI 간에 공유됩니다. Pro, Pro+, Max는 각각 월 15달러, 70달러, 200달러를 포함합니다.
로컬 BYOK 모델의 요구사항은 무엇인가요?
모델은 도구 호출과 스트리밍을 지원해야 합니다. 신뢰할 수 있는 에이전트 동작을 위해 GitHub는 128k 토큰 컨텍스트 윈도우를 권장합니다.
GitHub Copilot CLI는 Aider와 어떻게 비교되나요?
Aider는 로컬 모델을 네이티브 최우선 옵션으로 다루며 오픈소스입니다. Copilot CLI는 기본적으로 클라우드 모델을 사용하고 로컬 사용을 위해 별도의 BYOK 설정이 필요하며, 비공개 소스입니다. 위의 전체 비교를 참조하세요.