GitHub Copilot CLI

어떤 사용자를 위한 도구인가

GitHub Copilot CLI는 터미널에서 개발·테스트·Git 작업을 자주 수행하는 개발자를 위한 독립형 코딩 에이전트입니다. 자연어 질문에 답하는 데 그치지 않고 프로젝트 파일을 찾아 수정하거나 명령을 실행할 수 있습니다. 기존 코드 이해, 반복적인 리팩터링, 테스트 실패 분석처럼 여러 단계가 연결된 작업에 활용할 수 있습니다.

공식 지원 OS는 macOS, Linux, Windows입니다. Windows에서는 PowerShell 또는 WSL을 사용할 수 있으며, 설치 문서는 PowerShell 6 이상을 요구합니다. 입력 자료의 macOS 표기는 전체 지원 범위를 담고 있지 않습니다.

주요 기능과 실무 활용 예시

대화형 화면에서는 질문과 피드백을 주고받으며 작업 방향을 조정합니다. Shift+Tab으로 계획 모드에 들어가면 코드 작성 전에 요구사항과 구현 순서를 정리할 수 있습니다. -p 옵션은 한 번의 요청을 처리하고 종료하는 스크립트 연계 방식입니다. GitHub 이슈·PR 조회와 저장소 작업도 연결할 수 있습니다.

예를 들어 결제 모듈의 테스트가 실패했다면 관련 파일을 @로 지정하고 “실패 원인과 수정 계획부터 설명해 줘”라고 요청합니다. 계획을 검토한 뒤 수정과 필요한 테스트를 단계별로 승인하고, 마지막에는 변경 차이와 테스트 결과를 직접 확인하는 흐름이 적합합니다.

설치와 첫 작업 순서

macOS에서는 공식 설치 문서의 brew install --cask copilot-cli를 사용할 수 있습니다. npm 방식은 Node.js 22 이상을 준비한 뒤 npm install -g @github/copilot을 실행합니다. 공식 GitHub 배포 페이지에서 OS와 CPU에 맞는 실행 파일을 직접 받는 방법도 있습니다.

설치 후 작업할 프로젝트 폴더로 이동해 copilot을 실행합니다. /login으로 GitHub 계정을 인증하고 현재 폴더의 신뢰 여부를 확인한 다음, “이 프로젝트의 구조와 테스트 실행 방법을 설명해 줘”처럼 분석부터 시작합니다. 파일 수정이나 명령 실행 요청이 나오면 대상과 내용을 확인해 승인합니다. 조직 계정은 관리자가 Copilot CLI 정책을 허용해야 합니다.

무료·유료 플랜과 사용량

현재 공식 문서와 요금표에는 Copilot Free를 포함한 모든 Copilot 플랜에서 CLI를 사용할 수 있다고 명시되어 있습니다. Free는 사용량이 제한되며 모델은 자동 선택만 지원하고, 추가 AI 크레딧 구매는 제공하지 않습니다.

개인 유료 플랜의 월 요금은 Pro 10달러, Pro+ 39달러, Max 100달러입니다. 확인 당시 월 포함 AI 크레딧은 각각 1,500·7,000·20,000이며, 이 중 추가 제공분인 Flex allotment는 변경될 수 있습니다. CLI 사용량은 모델과 처리 토큰 수에 따라 차감되므로 유료라도 무제한 실행은 아닙니다. 포함 크레딧은 다음 달로 이월되지 않으며, 추가 유료 사용은 별도 예산 설정이 필요합니다.

문제가 생겼을 때 확인할 순서

실행이 안 되면 설치된 실행 파일의 위치와 PATH를 먼저 확인하고, npm 설치라면 Node.js 버전과 .npmrc의 ignore-scripts 설정을 점검합니다. 인증 오류는 로그인 계정, Copilot 이용 권한, 조직 정책 순서로 확인합니다. 환경변수의 토큰이 로그인 정보를 대신할 수 있으므로 COPILOT_GITHUB_TOKEN, GH_TOKEN, GITHUB_TOKEN도 점검 대상입니다. 개인 액세스 토큰은 Copilot Requests 권한이 있는 fine-grained 방식이 필요합니다.

작업이 멈췄다면 승인 대기인지 사용량 소진인지 확인합니다. /usage로 세션 사용량을 보고, 분석이 빗나가면 작업 폴더와 @로 지정한 파일을 다시 확인합니다. 자동 승인 옵션은 검토 기회를 줄이므로 처음에는 개별 승인을 유지하는 편이 좋습니다.

다른 도구와 선택 기준·지원 종료 검토

로컬 프로젝트를 터미널에서 대화하며 수정하려면 Copilot CLI가 맞습니다. 편집기 안에서 코드를 읽으며 도움받는 흐름을 선호하면 IDE의 Copilot을, GitHub에서 작업을 맡기고 결과를 PR로 검토하려면 Copilot cloud agent를 검토할 수 있습니다. AI 판단 없이 정해진 GitHub 명령을 실행하려면 GitHub CLI와 일반 스크립트가 더 직접적입니다.

검토할 지원 종료 항목은 구형 gh-copilot 확장입니다. 공식 공지에 따르면 이 확장은 2025-10-25에 작동을 종료했으며, 현재의 독립형 Copilot CLI와 구분해야 합니다. 2026-10-07 확인 시 공식 배포 페이지는 1.0.92를 최신 릴리스로 표시했고, 릴리스 날짜는 2026-10-05입니다.

공식 안내

• GitHub Copilot CLI · 확인 2026-10-07
• Getting started with GitHub Copilot CLI · 확인 2026-10-07
• Installing GitHub Copilot CLI · 확인 2026-10-07
• GitHub Copilot CLI command reference · 확인 2026-10-07
• GitHub Copilot · Plans & pricing · 확인 2026-10-07
• Usage-based billing for individuals · 확인 2026-10-07
• Release 1.0.92 · github/copilot-cli · 확인 2026-10-07
• Upcoming deprecation of gh-copilot CLI extension · 확인 2026-10-07