GitHub Copilot CLI 설치

          Copilot CLI을 명령줄에서 직접 사용할 수 있도록 Copilot을 설치하는 방법을 알아보세요.

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

GitHub Copilot CLI 는 모든 Copilot 계획에서 사용할 수 있습니다. 조직으로부터 Copilot를 수신하는 경우, 조직의 설정에서 Copilot CLI 정책이 사용하도록 설정되어야 합니다.

이 기사에서

설치하기 전에 Copilot CLI에 대해 알아보려면 GitHub Copilot CLI 정보을 참조하세요.

필수 조건

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

조직 또는 엔터프라이즈를 GitHub Copilot를 통해 액세스할 수 있는 경우, 조직 소유자나 엔터프라이즈 관리자가 조직 또는 엔터프라이즈 설정에서 Copilot CLI을(를) 비활성화한 경우에는 이를 사용할 수 없습니다. 조직의 GitHub Copilot 대한 정책 및 기능 관리 참조하세요.

설치 또는 업데이트 Copilot CLI

WinGet(Windows), Homebrew(macOS 및 Linux), npm(모든 플랫폼) 또는 설치 스크립트(macOS 및 Linux)를 사용하여 Copilot 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 리포지토리에서 직접 다운로드할 수 있습니다.

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

          Copilot CLI로 인증 중

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

          personal access token를 사용하여 인증하기

          fine-grained personal access token를 사용하여 "Copilot 요청" 권한을 활성화한 상태에서 인증할 수도 있습니다.
  1. 방문하세요 Fine-grained personal access tokens.
  2. "사용 권한"에서 권한 추가를 클릭하고 요청을 선택합니다Copilot.
  3.        **토큰 생성**을 클릭합니다.
  4. 터미널 또는 환경 구성에서 토큰을 내보냅니다. 우선 순위에 따라 COPILOT_GITHUB_TOKEN, GH_TOKEN또는 GITHUB_TOKEN 환경 변수를 사용합니다.

다음 단계:

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