Skip to main content

GitHub Copilot CLI 설치

코파일럿 CLI를 설치하여 명령줄에서 직접 Copilot을 사용할 수 있는 방법을 알아봅니다.

누가 이 기능을 사용할 수 있나요?

GitHub Copilot 명령 줄 인터페이스 (CLI)는 모든 Copilot 플랜에서 사용할 수 있습니다. 조직에서 Copilot을 수신하는 경우 조직의 설정에서 코파일럿 CLI 정책을 활성화해야 합니다.

코파일럿 CLI를 설치하기 전에 이에 대해 알아보려면 GitHub 코필로트 CLI 정보을(를) 참조하세요.

필수 조건

  •         **활성화된 GitHub Copilot 구독입니다.** [Copilot 플랜을 확인하세요](https://github.com/features/copilot/plans?ref_product=copilot&ref_type=engagement&ref_style=text).
    
  • (Windows) PowerShell v6 이상

조직 또는 엔터프라이즈를 통해 GitHub Copilot에 대한 접근 권한이 있는 경우, 조직 소유자 또는 엔터프라이즈 관리자가 조직 또는 엔터프라이즈 설정에서 코파일럿 CLI 사용을 비활성화했다면 이를 사용할 수 없습니다. 조직에서 GitHub Copilot에 대한 정책 및 기능 관리 참조하세요.

코파일럿 CLI 설치 또는 업데이트

WinGet(Windows), Homebrew(macOS 및 Linux), npm(모든 플랫폼) 또는 설치 스크립트(macOS 및 Linux)를 사용하여 코파일럿 CLI를 설치할 수 있습니다.

npm을 사용하여 설치(모든 플랫폼)

사전 요구 사항: Node.js 22 이상.

Shell
npm install -g @github/copilot

참고

만약 ignore-scripts=true 파일에 ~/.npmrc이 있다면, 다음 명령을 사용해야 합니다.

Shell
npm_config_ignore_scripts=false npm install -g @github/copilot

시험판 버전을 설치하려면:

Shell
npm install -g @github/copilot@prerelease

WinGet을 사용하여 설치(Windows)

PowerShell
winget install GitHub.Copilot

시험판 버전을 설치하려면:

PowerShell
winget install GitHub.Copilot.Prerelease

Homebrew를 사용하여 설치(macOS 및 Linux)

Shell
brew install copilot-cli

시험판 버전을 설치하려면:

Shell
brew install copilot-cli@prerelease

설치 스크립트를 사용하여 설치(macOS 및 Linux)

Shell
curl -fsSL https://gh.io/copilot-install | bash

또는:

Shell
wget -qO- https://gh.io/copilot-install | bash

루트로 실행하고 /usr/local/bin에 설치하려면 | sudo bash을 사용합니다.

사용자 지정 디렉터리에 설치하려면 환경 변수를 PREFIX 설정합니다. 루트로 실행되거나 /usr/local 루트가 아닌 사용자로 실행할 때 기본값 $HOME/.local 으로 설정됩니다.

특정 버전을 설치하려면 환경 변수를 VERSION 설정합니다. 기본값은 최신 버전입니다.

예를 들어 사용자 지정 디렉터리에 버전을 v0.0.369 설치하려면 다음을 수행합니다.

Shell
curl -fsSL https://gh.io/copilot-install | VERSION="v0.0.369" PREFIX="$HOME/custom" bash

GitHub.com로부터 다운로드하기

실행 파일은 copilot-cli 리포지토리에서 직접 다운로드할 수 있습니다.

플랫폼에 대한 실행 파일을 다운로드하고 압축을 풀고 실행합니다.

코파일럿 CLI}을 사용하여 인증하기

처음 시작할 때 GitHub에 현재 로그인하지 않은 경우 /login 슬래시 명령을 사용하라는 메시지가 표시됩니다. 이 명령을 입력하고 화면의 지시에 따라 인증을 완료하세요. 인증 프로세스에 대한 자세한 내용은 GitHub Copilot CLI 인증을 참조하세요.

personal access token를 사용한 인증

fine-grained personal access token에 "Copilot 요청" 권한을 설정하여 인증할 수도 있습니다.

  1.        [Fine-grained personal access tokens](https://github.com/settings/personal-access-tokens/new)를 방문하세요.
    
  2. "권한"에서 권한 추가를 클릭하고 Copilot 요청을 선택합니다.
  3.        **토큰 생성**을 클릭합니다.
    
  4. 터미널 또는 환경 구성에서 토큰을 내보냅니다. 우선 순위에 따라 COPILOT_GITHUB_TOKEN, GH_TOKEN또는 GITHUB_TOKEN 환경 변수를 사용합니다.

다음 단계:

이제 명령줄에서 Copilot을 사용할 수 있습니다. GitHub Copilot CLI 사용을(를) 참조하세요.