GitHub Copilot CLI 설치와 사용: 로그인과 첫 저장소 작업
공식 설치, /login, 내 저장소의 검토 가능한 diff 하나. 유효한 Copilot 구독이 필요합니다.
처음 쓰는 GitHub Copilot CLI에서 막히는 지점은 프롬프트가 아니라 설치 경로, 로그인, 그리고 내 저장소에서 검토할 수 있는 첫 변경입니다. 공식대로 copilot을 넣고 GitHub로 로그인한 뒤, 되돌릴 수 있는 한 줄을 고칩니다.
검색어는 GitHub Copilot CLI 설치와 사용입니다. 공식 설치·인증 문서(docs.github.com/en/copilot/how-tos/copilot-cli)를 따릅니다. 독립 터미널 에이전트이며 명령은 copilot입니다. 폐기된 gh copilot 확장과 다릅니다. 짧은 통화로 diff를 맞추려면 wbmeet에서 방을 만들고 방 만들기와 입장을 보세요.
먼저 실행 가능한지 확인
공식 전제: 유효한 GitHub Copilot 구독. Windows는 PowerShell v6 이상. 조직·엔터프라이즈에서 받은 Copilot이면 관리자가 CLI를 끌 수 있습니다. npm 경로는 Node.js 22+가 필요합니다.
첫 시간: 설치, 로그인, 검토 가능한 변경
- 1
공식 채널로 설치
모든 플랫폼 npm:
npm install -g @github/copilot(Node 22+).~/.npmrc에ignore-scripts=true가 있으면npm_config_ignore_scripts=false npm install -g @github/copilot. macOS/Linux:curl -fsSL https://gh.io/copilot-install | bash. Homebrew:brew install --cask copilot-cli. WinGet:winget install GitHub.Copilot. - 2
명령을 확인한 뒤 저장소로
새 터미널에서
copilot --version또는copilot.command not found는 대개 PATH. 비 root 스크립트는$HOME/.local/bin. 옛gh copilot은 쓰지 마세요. - 3
/login으로 인증
소유한 저장소에서
copilot. 로그인되어 있지 않으면/login과 브라우저 장치 코드. 자동화는 개인 계정 소유의 fine-grained PAT(Copilot Requests)를 만들고COPILOT_GITHUB_TOKEN,GH_TOKEN,GITHUB_TOKEN순으로보냅니다. 이미 로그인한gh는 마지막 폴백./user로 확인. - 4
검토 가능한 첫 작업
공식 시작 안내는
/init으로 이 저장소용 지침을 쓰라고 합니다. “이 프로젝트는 무엇을 하고 진입점은 어디인가”를 물은 뒤 “테스트 없는 헬퍼에 단위 테스트를 추가하거나 공개 함수에 입력 검사를. 먼저 diff를 보여 주고 기다리라.” 비밀을 프롬프트에 붙이지 마세요.
# Official install · as of 2026-09
npm install -g @github/copilot
copilot --version
cd /path/to/your/project
copilot
# /login then /init채널, 인증, 함정
| 경로 | 공식 설명 | 첫 시간 메모 |
|---|---|---|
| npm @github/copilot | 모든 플랫폼; Node 22+ | ignore-scripts가 설치를 막음 |
| 설치 스크립트 | macOS/Linux | 새 터미널에서 copilot |
| Homebrew | copilot-cli | 옛 gh 확장이 아님 |
| WinGet | GitHub.Copilot | PowerShell 6+ |
| 조직 정책 | 관리자가 CLI 비활성 가능 | 먼저 관리자에게 |
설치 후에도 command not found
대개 PATH. 비 root 기본값은 $HOME/.local/bin. 패키지는 @github/copilot.
로그인 루프나 403
/login. 조직이 CLI를 끄면 개인 좌석도 안 됩니다. PAT는 개인 소유 + Copilot Requests.
첫 작업이 잡담으로 끝남
/init은 준비입니다. 검토 가능한 변경과 diff까지 가세요.
공식 Installing / Authenticating: 독립 CLI를 설치한 뒤 /login 또는 토큰. 기준은 docs.github.com.
- 독립 CLI ≠ gh copilot 확장
- 옛 GitHub CLI 확장은 폐기되었습니다. 이 페이지는
copilot만 다룹니다. - 환경 변수 우선순위
COPILOT_GITHUB_TOKEN→GH_TOKEN→GITHUB_TOKEN→ 키체인 OAuth →gh auth token.- 회의 제품 설명서가 아님
- Copilot CLI 첫 시간만. wbmeet와 무거운 회의 앱을 열지 않을 때.
확인할 질문
Copilot 구독 없이 CLI를 쓸 수 있나요?
공식 설치 페이지는 유효한 Copilot 구독을 전제로 둡니다. 조직이 Copilot CLI를 끄면 개인 좌석으로도 부족합니다.
npm, Homebrew, 스크립트 중 무엇?
모두 같은 copilot입니다. Node 22+가 있으면 npm. macOS/Linux는 스크립트나 Homebrew. Windows는 WinGet과 PowerShell 6+.
CI에서 어떻게 로그인하나요?
대화형 /login을 쓰지 마세요. Copilot Requests가 있는 PAT를 COPILOT_GITHUB_TOKEN에 넣으세요. 토큰을 저장소에 넣지 마세요.
첫 작업이 프로덕션 코드를 건드려야 하나요?
아닙니다. /init 후 테스트나 검증처럼 되돌릴 수 있는 변경과 diff면 됩니다.