{"meta":{"title":"GitHub Copilot CLI 설치","intro":"코파일럿 CLI을 명령줄에서 직접 사용할 수 있도록 Copilot을 설치하는 방법을 알아보세요.","product":"GitHub Copilot","breadcrumbs":[{"href":"/ko/copilot","title":"GitHub Copilot"},{"href":"/ko/copilot/how-tos","title":"방법"},{"href":"/ko/copilot/how-tos/copilot-cli","title":"코파일럿 CLI"},{"href":"/ko/copilot/how-tos/copilot-cli/set-up-copilot-cli","title":"Copilot CLI 설정"},{"href":"/ko/copilot/how-tos/copilot-cli/set-up-copilot-cli/install-copilot-cli","title":"Copilot CLI 설치"}],"documentType":"article"},"body":"# GitHub Copilot CLI 설치\n\n코파일럿 CLI을 명령줄에서 직접 사용할 수 있도록 Copilot을 설치하는 방법을 알아보세요.\n\n설치하기 전에 코파일럿 CLI에 대해 알아보려면 [GitHub Copilot CLI 정보](/ko/copilot/concepts/agents/about-copilot-cli)을 참조하세요.\n\n## 필수 조건\n\n* **활성 GitHub Copilot 구독**입니다.\n  [계획을 참조하세요Copilot](https://github.com/features/copilot/plans?ref_product=copilot\\&ref_type=engagement\\&ref_style=text).\n* (Windows) **PowerShell** v6 이상\n\n조직 또는 엔터프라이즈를 GitHub Copilot를 통해 액세스할 수 있는 경우, 조직 소유자나 엔터프라이즈 관리자가 조직 또는 엔터프라이즈 설정에서 코파일럿 CLI을(를) 비활성화한 경우에는 이를 사용할 수 없습니다.\n[조직의 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) 참조하세요.\n\n## 설치 또는 업데이트 코파일럿 CLI\n\nWinGet(Windows), Homebrew(macOS 및 Linux), npm(모든 플랫폼) 또는 설치 스크립트(macOS 및 Linux)를 사용하여 코파일럿 CLI 설치할 수 있습니다.\n\n### npm을 사용하여 설치(모든 플랫폼)\n\n필수 구성 요소: Node.js 22 이상.\n\n```shell copy\nnpm install -g @github/copilot\n```\n\n> \\[!NOTE]\n> 만약 `ignore-scripts=true` 파일에 `~/.npmrc`이 있다면, 다음 명령을 사용해야 합니다.\n>\n> ```shell copy\n> npm_config_ignore_scripts=false npm install -g @github/copilot\n> ```\n\n시험판 버전을 설치하려면:\n\n```shell copy\nnpm install -g @github/copilot@prerelease\n```\n\n### WinGet을 사용하여 설치(Windows)\n\n```powershell copy\nwinget install GitHub.Copilot\n```\n\n시험판 버전을 설치하려면:\n\n```powershell copy\nwinget install GitHub.Copilot.Prerelease\n```\n\n### Homebrew를 사용하여 설치(macOS 및 Linux)\n\n```shell copy\nbrew install copilot-cli\n```\n\n시험판 버전을 설치하려면:\n\n```shell copy\nbrew install copilot-cli@prerelease\n```\n\n### 설치 스크립트를 사용하여 설치(macOS 및 Linux)\n\n```shell copy\ncurl -fsSL https://gh.io/copilot-install | bash\n```\n\n또는:\n\n```shell copy\nwget -qO- https://gh.io/copilot-install | bash\n```\n\n루트로 실행하고 `/usr/local/bin`에 설치하려면 `| sudo bash`을 사용합니다.\n\n사용자 지정 디렉터리에 설치하려면 환경 변수를 `PREFIX` 설정합니다. 루트로 실행되거나 `/usr/local` 루트가 아닌 사용자로 실행할 때 기본값 `$HOME/.local` 으로 설정됩니다.\n\n특정 버전을 설치하려면 환경 변수를 `VERSION` 설정합니다. 기본값은 최신 버전입니다.\n\n예를 들어 사용자 지정 디렉터리에 버전을 `v0.0.369` 설치하려면 다음을 수행합니다.\n\n```shell copy\ncurl -fsSL https://gh.io/copilot-install | VERSION=\"v0.0.369\" PREFIX=\"$HOME/custom\" bash\n```\n\n### GitHub.com에서 다운로드\n\n실행 파일은 [`copilot-cli` 리포지토리](https://github.com/github/copilot-cli/releases/)에서 직접 다운로드할 수 있습니다.\n\n플랫폼에 대한 실행 파일을 다운로드하고 압축을 풀고 실행합니다.\n\n## 코파일럿 CLI로 인증 중\n\n처음 시작할 때 GitHub에 로그인하지 않은 경우, `/login` 슬래시 명령을 사용하라는 메시지가 표시됩니다. 이 명령을 입력하고 화면의 지시에 따라 인증을 완료하세요. 인증 프로세스에 대한 자세한 내용은 [GitHub Copilot CLI를 인증하기](/ko/copilot/how-tos/copilot-cli/set-up-copilot-cli/authenticate-copilot-cli)을 참조하세요.\n\n### personal access token를 사용하여 인증하기\n\nfine-grained personal access token를 사용하여 \"Copilot 요청\" 권한을 활성화한 상태에서 인증할 수도 있습니다.\n\n1. 방문하세요 [Fine-grained personal access tokens](https://github.com/settings/personal-access-tokens/new).\n2. **리소스 소유자**에서 **개인 계정을** 선택합니다. 조직을 선택하지 마세요. 요청 권한은 **Copilot** 사용자 소유fine-grained personal access tokens에서만 사용할 수 있습니다.\n3. **리포지토리 액세스**에서 사용 사례에 적합한 액세스 수준을 선택합니다.\n   * **공용 리포지토리**로만 작업이 필요하다면 사용하세요.\n   * 현재 및 향후 **리포지토리** 전체에 액세스를 얻으려면 모든 리포지토리에 액세스해야 합니다.\n   * 특정 **리포지토리**에 대한 액세스를 제한하려는 리포지토리 f만 선택합니다.\n4. **사용 권한**에서 **계정** 탭을 선택합니다.\n5. **권한 추가를** 클릭하고 요청을 선택합니다**Copilot**.\n6. **토큰 생성**을 클릭합니다.\n7. 터미널 또는 환경 구성에서 토큰을 내보냅니다. 우선 순위에 따라 `COPILOT_GITHUB_TOKEN`, `GH_TOKEN`또는 `GITHUB_TOKEN` 환경 변수를 사용합니다.\n\n## 다음 단계:\n\n이제 명령줄에서 사용할 Copilot 수 있습니다.\n[GitHub Copilot CLI 사용](/ko/copilot/how-tos/use-copilot-agents/use-copilot-cli) 참조하세요."}