GitHub Copilot CLI
이제 터미널에서도 GitHub Copilot의 강력한 기능을 사용하세요.
GitHub Copilot CLI는 AI 기반 코딩 지원을 명령줄에 직접 가져와, 자연어 대화를 통해 코드를 구축하고 디버깅하며 이해할 수 있도록 합니다. GitHub의 Copilot 코딩 에이전트와 동일한 에이전틱(agentic) 하네스를 기반으로 작동하여, 사용자의 GitHub 워크플로우에 깊숙이 통합되면서 지능적인 지원을 제공합니다.
더 자세한 정보는 공식 문서를 참조하세요.
Image of the splash screen for the Copilot CLI
🚀 소개 및 개요
GitHub Copilot 코딩 에이전트의 강력한 기능을 터미널에 직접 가져옵니다. GitHub Copilot CLI를 사용하면, 사용자의 코드와 GitHub 컨텍스트를 이해하는 AI 에이전트와 로컬에서 동기적으로 작업할 수 있습니다.
- 터미널 네이티브 개발: 명령줄에서 Copilot 코딩 에이전트와 직접 작업합니다. 컨텍스트 전환이 필요 없습니다.
- 즉시 사용 가능한 GitHub 통합: 기존 GitHub 계정으로 인증하여 자연어를 사용하여 저장소, 이슈, 풀 리퀘스트에 접근할 수 있습니다.
- 에이전틱 기능(Agentic capabilities): 계획을 세우고 복잡한 작업을 실행할 수 있는 AI 협업자와 함께 코드를 구축하고, 편집하고, 디버깅하고, 리팩토링할 수 있습니다.
- MCP 기반 확장성: 코딩 에이전트가 기본적으로 GitHub의 MCP 서버와 함께 제공되며 사용자 지정 MCP 서버를 지원하여 기능을 확장할 수 있다는 점을 활용하세요.
- 완벽한 제어: 실행 전에 모든 작업을 미리 볼 수 있습니다. 명시적인 승인 없이는 아무것도 발생하지 않습니다.
저희는 여전히 초기 단계에 있지만, 여러분의 피드백을 통해 GitHub Copilot CLI를 터미널에서 가장 좋은 동반자로 만들기 위해 빠르게 개선하고 있습니다.
📦 시작하기
지원 플랫폼
필수 조건
- (Windows의 경우) PowerShell v6 이상
- 활성 Copilot 구독: Copilot 플랜를 참조하세요.
조직 또는 엔터프라이즈를 통해 GitHub Copilot에 액세스하는 경우, 조직 소유자나 엔터프라이즈 관리자가 조직 또는 엔터프라이즈 설정에서 이를 비활성화했다면 GitHub Copilot CLI를 사용할 수 없습니다. 자세한 내용은 조직의 GitHub Copilot 정책 및 기능 관리를 참조하십시오.
설치 (Installation)
설치 스크립트를 사용하여 설치합니다 (macOS 및 Linux):
curl -fsSL https://gh.io/copilot-install | bash
또는
wget -qO- https://gh.io/copilot-install | bash
루트(root)로 실행하여 /usr/local/bin에 설치하려면 | sudo bash를 사용하십시오.
PREFIX를 설정하여 $PREFIX/bin/ 디렉토리에 설치할 수 있습니다. root로 실행하는 경우 기본값은 /usr/local이며, 비-root 사용자로서 실행하는 경우 $HOME/.local입니다.
VERSION을 설정하여 특정 버전을 설치할 수 있습니다. 기본값은 최신 버전입니다.
예를 들어, v0.0.369 버전을 사용자 지정 디렉토리에 설치하려면:
curl -fsSL https://gh.io/copilot-install | VERSION="v0.0.369" PREFIX="$HOME/custom" bash
Homebrew를 사용하여 설치합니다 (macOS 및 Linux):
brew install copilot-cli@prerelease
WinGet을 사용하여 설치합니다 (Windows):
winget install GitHub.Copilot
winget install GitHub.Copilot.Prerelease
npm을 사용하여 설치합니다 (macOS, Linux 및 Windows):
npm install -g @github/copilot
npm install -g @github/copilot@prerelease
CLI 실행 (Launching the CLI)
처음 실행하면 귀여운 애니메이션 배너가 표시됩니다! 이 배너를 다시 보고 싶다면 copilot을 --banner 플래그와 함께 실행하십시오.
현재 GitHub에 로그인되어 있지 않은 경우, /login 슬래시 명령어를 사용하라는 메시지가 표시됩니다. 이 명령어를 입력하고 화면의 지침을 따라 인증을 완료하세요.
개인 액세스 토큰(Personal Access Token, PAT)으로 인증하기
또한 'Copilot Requests' 권한이 활성화된 세분화된 PAT를 사용하여 인증할 수 있습니다.
- https://github.com/settings/personal-access-tokens/new 로 이동합니다.
- "Permissions" 아래에서 "add permissions"를 클릭하고 "Copilot Requests"를 선택합니다.
- 토큰을 생성합니다.
- 환경 변수
GH_TOKEN 또는 GITHUB_TOKEN (우선순위에 따라)을 통해 토큰을 환경에 추가합니다.
CLI 사용하기
작업하려는 코드가 포함된 폴더에서 copilot을 실행하세요.
기본적으로, copilot은 Claude Sonnet 4.5를 사용합니다. /model 슬래시 명령어를 실행하여 Claude Sonnet 4 및 GPT-5를 포함한 다른 사용 가능한 모델 중에서 선택할 수 있습니다.
컨테이너 이미지
Copilot CLI는 또한 Copilot SDK 클라이언트를 위한 헤드리스 서버로 CLI를 실행하는 컨테이너 이미지로도 제공됩니다. 이미지는 linux/amd64 및 linux/arm64용으로 ghcr.io/github/copilot-cli에 게시됩니다. 이 이미지는 대화형 터미널 사용이 아닌, SDK 클라이언트를 서버에 연결하기 위한 것입니다.
연결 토큰과 GitHub 토큰을 설정한 다음 서버를 시작합니다:
export COPILOT_CONNECTION_TOKEN="$(openssl rand -hex 32)"
docker run --rm \
-p 127.0.0.1:4321:4321 \
...
명령을 실행하기 전에 환경 변수에 COPILOT_GITHUB_TOKEN을 설정하세요. 버전 고정 배포의 경우 latest 대신 릴리스 태그를 사용하십시오. SDK 연결 예제, 구성, 보안 고려 사항 및 빌드 지침은 container image guide를 참조하세요.
실험 모드 (Experimental Mode)
실험 모드는 아직 개발 중인 새로운 기능에 대한 접근을 가능하게 합니다. 다음 방법으로 실험 모드를 활성화할 수 있습니다:
--experimental 플래그와 함께 실행: copilot --experimental- CLI 내에서
/experimental 슬래시 명령어 사용
활성화되면 해당 설정은 구성 파일에 영구 저장되므로, 이후 실행 시에는 더 이상 --experimental 플래그가 필요하지 않습니다.
실험적 기능 (Experimental Features)
- Autopilot 모드: Autopilot은 새로운 모드로, 에이전트가 작업 완료 시까지 계속 작업을 수행하도록 장려합니다 (모드를 순환하려면
Shift+Tab을 누르세요).
GitHub Copilot CLI에 프롬프트를 제출할 때마다 월간 프리미엄 요청 할당량이 1씩 감소합니다. 프리미엄 요청에 대한 정보는 About premium requests를 참조하세요.
GitHub Copilot CLI 사용 방법에 대한 자세한 정보는 공식 문서를 참조하세요.
🔧 LSP 서버 구성 (Configuring LSP Servers)
GitHub Copilot CLI는 향상된 코드 인텔리전스(code intelligence)를 위해 Language Server Protocol (LSP)을 지원합니다. 이 기능은 정의로 이동(go-to-definition), 호버 정보(hover information), 진단(diagnostics)과 같은 지능형 코드 기능을 제공합니다.
언어 서버 설치 (Installing Language Servers)
Copilot CLI는 LSP 서버를 번들로 제공하지 않습니다. 별도로 설치해야 합니다. 예를 들어, TypeScript 지원을 설정하려면 다음 명령어를 사용합니다:
npm install -g typescript-language-server
다른 언어의 경우에도 해당 LSP 서버를 설치하고 아래에 표시된 것과 동일한 패턴을 따라 구성하세요.
LSP 서버 구성 (Configuring LSP Servers)
LSP 서버는 전용 LSP 구성 파일을 통해 설정됩니다. LSP 서버를 사용자 수준 또는 리포지토리 수준에서 구성할 수 있습니다:
사용자 수준 구성 (모든 프로젝트에 적용):
~/.copilot/lsp-config.json 파일을 편집합니다.
리포지토리 수준 구성 (특정 프로젝트에 적용):
리포지토리 루트에 .github/lsp.json 파일을 생성합니다.
예시 구성:
{
"lspServers": {
"typescript": {
...
LSP 서버 상태 확인 (Viewing LSP Server Status)
대화형 세션에서 /lsp 명령어를 사용하거나 구성 파일을 직접 확인하여 설정된 LSP 서버를 확인할 수 있습니다.
더 자세한 정보는 변경 로그를 참조하세요.
📢 피드백 및 참여(Feedback and Participation)
Copilot CLI의 여정에 일찍 합류해 주셔서 기쁩니다.
저희는 빠르게 개발하고 있습니다. 빈번한 업데이트가 예상되니, 최신 기능과 수정 사항을 위해 클라이언트를 항상 최신 상태로 유지해 주세요!
여러분의 통찰력은 매우 중요합니다! 이 레포지토리(repo)에 이슈를 열거나, 토론(Discussions)에 참여하거나, CLI에서 /feedback을 실행하여 기밀 피드백 설문조사를 제출해 주세요!