{"meta":{"title":"GitHub Copilot CLI 설정 및 사용","intro":"GitHub Enterprise Server 인스턴스에 대한 모델 공급자를 구성한 다음, Copilot CLI 클라이언트를 해당 인스턴스에 연결합니다.","product":"엔터프라이즈 관리자","breadcrumbs":[{"href":"/ko/enterprise-server@3.22/admin","title":"엔터프라이즈 관리자"},{"href":"/ko/enterprise-server@3.22/admin/github-copilot","title":"GitHub Copilot"},{"href":"/ko/enterprise-server@3.22/admin/github-copilot/copilot-cli","title":"Copilot CLI"},{"href":"/ko/enterprise-server@3.22/admin/github-copilot/copilot-cli/set-up-and-use-copilot-cli","title":"설정 및 사용 Copilot CLI"}],"documentType":"article"},"body":"# GitHub Copilot CLI 설정 및 사용\n\nGitHub Enterprise Server 인스턴스에 대한 모델 공급자를 구성한 다음, Copilot CLI 클라이언트를 해당 인스턴스에 연결합니다.\n\n> \\[!NOTE]\n> 이 기능은 기술 미리 보기에서 사용 중이며 변경될 수 있습니다.\n\nCopilot CLI를 GitHub Enterprise Server와 함께, GitHub Cloud에 연결되지 않는 분리되었거나 에어갭된 환경에서 작동하도록 구성할 수 있습니다. 관리자는 인스턴스용 모델 공급자를 구성하고, 사용자는 Copilot CLI 자격 증명을 사용해 GitHub Enterprise Server에 연결합니다.\n\n이 기능을 설정하려면 다음 두 가지 역할이 포함됩니다.\n\n* **관리자**: .를 사용하여 `ghe-config`인스턴스에서 모델 공급자를 GitHub Enterprise Server 구성합니다. 관리 SSH 액세스가 필요한 일회성 설정입니다.\n* **최종 사용자**: 인스턴스에 연결할 Copilot CLI 로컬 컴퓨터의 환경 변수를 설정합니다.\n\n## Prerequisites\n\n* 인스턴스에 대한 관리 SSH 액세스 권한이 있습니다 GitHub Enterprise Server .\n* 지원되는 LLM 공급자의 API 키가 있습니다.\n* Copilot CLI 는 클라이언트 컴퓨터에 설치됩니다.\n [GitHub Copilot CLI 설치](/ko/enterprise-cloud@latest/copilot/how-tos/copilot-cli/set-up-copilot-cli/install-copilot-cli)을(를) 참조하세요.\n* GitHub CLI (`gh`)는 클라이언트 컴퓨터에 설치됩니다. 설명서의 GitHub CLI[설명서를 참조GitHub CLI](https://cli.github.com/manual/)하세요.\n\n지원되는 공급자 및 모델 요구 사항에 대한 자세한 내용은 [GitHub Copilot CLI에서 사용자 고유의 LLM 모델 사용](/ko/enterprise-cloud@latest/copilot/how-tos/copilot-cli/customize-copilot/use-byok-models)을 참조하세요.\n\n## 사용자의 GitHub Enterprise Server 인스턴스 구성\n\n이 단계는 인스턴스의 운영자 또는 관리자를 위한 것입니다 GitHub Enterprise Server .\n\n인스턴스에 대한 GitHub Enterprise Server 관리 SSH 액세스를 사용하여 다음 `ghe-config` 값을 사용하여 모델 공급자를 구성합니다. 구성한 후 실행 `ghe-config-apply` 하여 변경 내용을 적용합니다.\n\n| 변수 이름 | 필수 | Options | Description |\n| ----------------------------------------- | ---------------------------------------------------------------------------------------------- | ------- | ------------------------------------------------------------------ |\n| `app.copilot-proxy.enabled` | Yes | | |\n| `true`, `false` | 기능을 사용하거나 사용하지 않도록 설정합니다. | | |\n| `app.copilot-proxy.endpoint-url` | Yes | URI | 모든 버전 접두사를 포함하는 전체 업스트림 기본 URL(예: `https://api.openai.com/v1`)입니다. |\n| `secrets.copilot-proxy.endpoint-key` | Yes | 스트링 | 업스트림 공급자에 대한 API 키입니다. |\n| `app.copilot-proxy.provider-model-id` | Yes | 스트링 | 내부적으로 모델을 조회하는 데 사용하는 공급자 모델 ID Copilot CLI 입니다. |\n| `app.copilot-proxy.provider-type` | Yes | | |\n| `openai`, `azure`, `anthropic` | 공급자 유형입니다. OpenAI에는 OpenAI, Ollama, vLLM, Foundry Local 및 기타 OpenAI 채팅 완료 API 호환 엔드포인트가 포함됩니다. | | |\n| `app.copilot-proxy.upstream-timeout` | No | 정수(초) | 업스트림 요청에 대한 읽기/보내기 시간 제한(초)입니다. 설정하지 않으면 기본 시간 제한으로 돌아갑니다. |\n| `app.copilot-proxy.provider-wire-api` | No | | |\n| `completions`, `responses` | 공급자에 대한 유선 API 형식입니다. | | |\n| `app.copilot-proxy.provider-wire-model` | No | 스트링 | 내부 모델 ID와 다른 경우 업스트림 공급자에 전송되는 모델 식별자를 재정의합니다. |\n| `app.copilot-proxy.enable-upstream-probe` | No | | |\n| `true`, `false` | 시작 업스트림 프로브를 사용하거나 사용하지 않도록 설정합니다. 기본값은 enabled입니다. 사용하지 않도록 설정하면 시작 프로브를 건너뜁습니다. | | |\n\n예를 들어 다음 명령은 OpenAI 공급자를 구성합니다.\n\n```shell\nghe-config app.copilot-proxy.enabled true\nghe-config app.copilot-proxy.endpoint-url 'https://api.openai.com/v1'\nghe-config secrets.copilot-proxy.endpoint-key 'YOUR-API-KEY'\nghe-config app.copilot-proxy.provider-model-id 'gpt-5.5'\nghe-config app.copilot-proxy.provider-wire-model 'gpt-5.5'\nghe-config app.copilot-proxy.provider-type openai\nghe-config app.copilot-proxy.upstream-timeout 300\nghe-config app.copilot-proxy.enable-upstream-probe false\nghe-config-apply\n```\n\n구성을 적용하기 전에 `YOUR-API-KEY`를 실제 API 키로 바꾸세요.\n\n## 사용자의 Copilot CLI 클라이언트 구성(최종 사용자)\n\nCopilot CLI를 시작하기 전에 다음 환경 변수를 설정하여 GitHub Enterprise Server가 Copilot CLI 인스턴스에 연결되도록 구성합니다.\n\n| 환경 변수 | 필수 | Description |\n| ----------------------------- | --- | ----------------------------------------------------------------------------------------- |\n| `COPILOT_PROVIDER_GHES_HOST` | Yes | 인스턴스의 GitHub Enterprise Server 호스트 이름입니다. |\n| `COPILOT_PROVIDER_GHES_TOKEN` | Yes | 인스턴스에 대한 A personal access token 입니다 GitHub Enterprise Server . 이 토큰은 인스턴스에 대한 요청을 인증합니다. |\n| `COPILOT_OFFLINE` | Yes | 오프라인 모드를 사용하도록 설정합니다. 공급자는 GitHub Enterprise Server 오프라인 모드를 사용하는 경우에만 활성화됩니다. |\n\n## 클라이언트(최종 사용자) 토큰 이해\n\nCopilot CLI 는 LLM 유추에 대한 액세스 권한이 필요하므로 `COPILOT_PROVIDER_GHES_TOKEN` 항상 필요합니다. 또한 이슈 생성, 풀 리퀘스트, 리포지토리 검색과 같은 Copilot CLI작업을 수행하려면 GitHub가 매우 필요할 것입니다. 이러한 작업은 .를 통해 GitHub CLI수행할 수 있습니다.\n\n`gh auth login --hostname YOUR-GHES-HOSTNAME`를 실행하는 것이 권장되며 바람직합니다. 성공한 후 다음 단계는 `gh auth login --hostname YOUR-GHES-HOSTNAME`를 `COPILOT_PROVIDER_GHES_TOKEN`에서 생성된 토큰으로 설정하는 것입니다.\n`~/.config/gh/hosts.yml`에서 복사하는 것보다 토큰을 동적으로 가져오는 것이 더 안전합니다.\n`COPILOT_PROVIDER_GHES_TOKEN=\"$(gh auth token --hostname YOUR-GHES-HOSTNAME)\"`를 사용하여 그렇게 할 수 있습니다.\n\n또는 `COPILOT_PROVIDER_GHES_TOKEN` 인스턴스에서 personal access token를 생성하고, 해당 토큰을 `gh auth login --hostname YOUR-GHES-HOSTNAME`(으)로 설정한 다음 GitHub Enterprise Server를 실행할 때 동일한 토큰을 사용할 수 있습니다.\n\n위의 방법은 대화형으로 사용할 Copilot CLI 때 작동합니다. 자동화의 경우 다음과 같이 몇 가지 작업을 다르게 수행해야 합니다.\n\n* `GH_ENTERPRISE_TOKEN`(또는 `GITHUB_ENTERPRISE_TOKEN`)을 personal access token로 설정합니다.\n* 서버의 호스트 이름으로 설정합니다 `GH_HOST` .\n* 동일한 호스트에 대해 `gh auth login` 자격 증명과 `GH_ENTERPRISE_TOKEN` 자격 증명이 모두 있으면 환경 변수가 우선 적용됩니다.\n\n## 권장 최종 사용자 설정\n\n1. 인증합니다 GitHub CLI.\n\n ```shell\n gh auth login --hostname YOUR-GHES-HOSTNAME\n ```\n\n2. 에 필요한 Copilot CLI환경 변수를 설정합니다.\n\n ```shell\n export COPILOT_PROVIDER_GHES_HOST=YOUR-GHES-HOSTNAME\n export COPILOT_PROVIDER_GHES_TOKEN=\"$(gh auth token --hostname YOUR-GHES-HOSTNAME)\"\n export COPILOT_OFFLINE=true\n ```\n\n`gh auth login`로 여러 계정에 인증된 경우, `GH_HOST`을 서버의 호스트 이름으로 설정하고 `GITHUB_ENTERPRISE_TOKEN`(또는 `\"$(gh auth token --hostname YOUR-GHES-HOSTNAME)\"`)를 `GH_ENTERPRISE_TOKEN`로 설정할 수 있습니다. 이렇게 하면 GitHub CLI이(가) 사용자의 GitHub Enterprise Server 인스턴스를 대상으로 하도록 보장합니다.\n\n```shell\nexport GH_HOST=YOUR-GHES-HOSTNAME\nexport GH_ENTERPRISE_TOKEN=\"$(gh auth token --hostname YOUR-GHES-HOSTNAME)\"\n```\n\n1. Copilot CLI를 시작합니다.\n\n```bash\ncopilot\n```\n\n이 전체 설정을 스크립트로 실행할 수 있습니다.\n\n## 예제\n\nGitHub Enterprise Server 구성과 사용자의 Copilot CLI 구성이 모두 올바르다면, Copilot CLI 세션에서 다음과 같은 응답이 표시될 것입니다.\n\n```shell\n • fabric-core-mcp — disabled\n • powerbi-mcp — disabled\n • slack — connected\n\n ● Current model: gpt-5.5\n\n ❯ Hello 13:31\n\n ● Hello!\n\n ❯ what is going on in github/codeql-action repo? 13:33\n\n ● I’ll check recent repository activity on the GHES host: repo metadata, open \n PRs/issues, and latest commits.\n\n $ Shell Fetch repo metadata 2 lines… 5s\n gh api --hostname \"$GH_HOST\" repos/github/codeql-action --jq '{name_with_own…\n```\n\n## GitHub Enterprise Server에서 지원되는 기능\n\nCopilot CLI 기능에 대한 최신 정보는 [GitHub Copilot CLI](/ko/enterprise-cloud@latest/copilot/how-tos/copilot-cli)을 가장 신뢰할 수 있는 기준 정보로 참조하세요. 일반적으로 GitHub 클라우드 서비스에 대한 연결에 의존하는 모든 기능은 GitHub Enterprise Server 오프라인 구성에서는 사용할 수 없습니다.\n\n다음 표는 GitHub Enterprise Server 제품에서 제공되는 항목에 대한 개괄적인 방향성을 보여줍니다.\n\n| Capability | GitHub / GitHub Enterprise Cloud | GitHub Enterprise Server |\n| :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: |\n| AI 지원 코딩(프롬프트, 코드 생성, 디버깅) | | |\n| 셸 명령 및 파일 작업 | | |\n| GitHub 작업(이슈, PR, 리포지토리) - `gh` CLI를 통해 | | |\n| (필요 `gh` 인스턴스에 인증된 CLI) | | |\n| GitHub MCP 서버 도구 | | |\n| 웹 검색 및 웹 페치 | | |\n| Copilot 모델 선택(GitHub호스트된 모델) | | |\n| 원격 분석 및 사용 현황 보고 | | |\n| 자동 업데이트 | | |"}