# GitHub Copilot CLI 설치

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

설치하기 전에 코파일럿 CLI에 대해 알아보려면 [GitHub Copilot CLI 정보](/ko/copilot/concepts/agents/about-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를 통해 액세스할 수 있는 경우, 조직 소유자나 엔터프라이즈 관리자가 조직 또는 엔터프라이즈 설정에서 코파일럿 CLI을(를) 비활성화한 경우에는 이를 사용할 수 없습니다.
[조직의 GitHub Copilot 대한 정책 및 기능 관리](/ko/copilot/managing-copilot/managing-github-copilot-in-your-organization/managing-github-copilot-features-in-your-organization/managing-policies-for-copilot-in-your-organization) 참조하세요.

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

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

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

필수 구성 요소: Node.js 22 이상.

```shell copy
npm install -g @github/copilot
```

> \[!NOTE]
> 만약 `ignore-scripts=true` 파일에 `~/.npmrc`이 있다면, 다음 명령을 사용해야 합니다.
>
> ```shell copy
> npm_config_ignore_scripts=false npm install -g @github/copilot
> ```

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

```shell copy
npm install -g @github/copilot@prerelease
```

### WinGet을 사용하여 설치(Windows)

```powershell copy
winget install GitHub.Copilot
```

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

```powershell copy
winget install GitHub.Copilot.Prerelease
```

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

```shell copy
brew install copilot-cli
```

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

```shell copy
brew install copilot-cli@prerelease
```

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

```shell copy
curl -fsSL https://gh.io/copilot-install | bash
```

또는:

```shell copy
wget -qO- https://gh.io/copilot-install | bash
```

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

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

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

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

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

###

```
          GitHub.com에서 다운로드
```

실행 파일은 [`copilot-cli` 리포지토리](https://github.com/github/copilot-cli/releases/)에서 직접 다운로드할 수 있습니다.

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

##

```
          코파일럿 CLI로 인증 중
```

처음 시작할 때 GitHub에 로그인하지 않은 경우, `/login` 슬래시 명령을 사용하라는 메시지가 표시됩니다. 이 명령을 입력하고 화면의 지시에 따라 인증을 완료하세요. 인증 프로세스에 대한 자세한 내용은 [GitHub Copilot CLI를 인증하기](/ko/copilot/how-tos/copilot-cli/set-up-copilot-cli/authenticate-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 사용](/ko/copilot/how-tos/use-copilot-agents/use-copilot-cli) 참조하세요.