GitHub Copilot CLI 설정 및 사용

참고

이 기능은 기술 미리 보기에서 사용 중이며 변경될 수 있습니다.

Copilot CLI를 GitHub Enterprise Server와 함께, GitHub Cloud에 연결되지 않는 분리되었거나 에어갭된 환경에서 작동하도록 구성할 수 있습니다. 관리자는 인스턴스용 모델 공급자를 구성하고, 사용자는 Copilot CLI 자격 증명을 사용해 GitHub Enterprise Server에 연결합니다.

이 기능을 설정하려면 다음 두 가지 역할이 포함됩니다.

관리자: .를 사용하여 ghe-config인스턴스에서 모델 공급자를 GitHub Enterprise Server 구성합니다. 관리 SSH 액세스가 필요한 일회성 설정입니다.
최종 사용자: 인스턴스에 연결할 Copilot CLI 로컬 컴퓨터의 환경 변수를 설정합니다.

Prerequisites

인스턴스에 대한 관리 SSH 액세스 권한이 있습니다 GitHub Enterprise Server .
지원되는 LLM 공급자의 API 키가 있습니다.
Copilot CLI 는 클라이언트 컴퓨터에 설치됩니다. GitHub Copilot CLI 설치을(를) 참조하세요.
GitHub CLI (gh)는 클라이언트 컴퓨터에 설치됩니다. 설명서의 GitHub CLI설명서를 참조GitHub CLI하세요.

지원되는 공급자 및 모델 요구 사항에 대한 자세한 내용은 GitHub Copilot CLI에서 사용자 고유의 LLM 모델 사용을 참조하세요.

사용자의 GitHub Enterprise Server 인스턴스 구성

이 단계는 인스턴스의 운영자 또는 관리자를 위한 것입니다 GitHub Enterprise Server .

인스턴스에 대한 GitHub Enterprise Server 관리 SSH 액세스를 사용하여 다음 ghe-config 값을 사용하여 모델 공급자를 구성합니다. 구성한 후 실행 ghe-config-apply 하여 변경 내용을 적용합니다.

변수 이름	필수	Options	Description
`app.copilot-proxy.enabled`	Yes
`true`, `false`	기능을 사용하거나 사용하지 않도록 설정합니다.
`app.copilot-proxy.endpoint-url`	Yes	URI	모든 버전 접두사를 포함하는 전체 업스트림 기본 URL(예: `https://api.openai.com/v1`)입니다.
`secrets.copilot-proxy.endpoint-key`	Yes	스트링	업스트림 공급자에 대한 API 키입니다.
`app.copilot-proxy.provider-model-id`	Yes	스트링	내부적으로 모델을 조회하는 데 사용하는 공급자 모델 ID Copilot CLI 입니다.
`app.copilot-proxy.provider-type`	Yes
`openai`, `azure`, `anthropic`	공급자 유형입니다. OpenAI에는 OpenAI, Ollama, vLLM, Foundry Local 및 기타 OpenAI 채팅 완료 API 호환 엔드포인트가 포함됩니다.
`app.copilot-proxy.upstream-timeout`	No	정수(초)	업스트림 요청에 대한 읽기/보내기 시간 제한(초)입니다. 설정하지 않으면 기본 시간 제한으로 돌아갑니다.
`app.copilot-proxy.provider-wire-api`	No
`completions`, `responses`	공급자에 대한 유선 API 형식입니다.
`app.copilot-proxy.provider-wire-model`	No	스트링	내부 모델 ID와 다른 경우 업스트림 공급자에 전송되는 모델 식별자를 재정의합니다.
`app.copilot-proxy.enable-upstream-probe`	No
`true`, `false`	시작 업스트림 프로브를 사용하거나 사용하지 않도록 설정합니다. 기본값은 enabled입니다. 사용하지 않도록 설정하면 시작 프로브를 건너뜁습니다.

예를 들어 다음 명령은 OpenAI 공급자를 구성합니다.

ghe-config app.copilot-proxy.enabled true
ghe-config app.copilot-proxy.endpoint-url 'https://api.openai.com/v1'
ghe-config secrets.copilot-proxy.endpoint-key 'YOUR-API-KEY'
ghe-config app.copilot-proxy.provider-model-id 'gpt-5.5'
ghe-config app.copilot-proxy.provider-wire-model 'gpt-5.5'
ghe-config app.copilot-proxy.provider-type openai
ghe-config app.copilot-proxy.upstream-timeout 300
ghe-config app.copilot-proxy.enable-upstream-probe false
ghe-config-apply

구성을 적용하기 전에 YOUR-API-KEY를 실제 API 키로 바꾸세요.

사용자의 Copilot CLI 클라이언트 구성(최종 사용자)

Copilot CLI를 시작하기 전에 다음 환경 변수를 설정하여 GitHub Enterprise Server가 Copilot CLI 인스턴스에 연결되도록 구성합니다.

환경 변수	필수	Description
`COPILOT_PROVIDER_GHES_HOST`	Yes	인스턴스의 GitHub Enterprise Server 호스트 이름입니다.
`COPILOT_PROVIDER_GHES_TOKEN`	Yes	인스턴스에 대한 A personal access token 입니다 GitHub Enterprise Server . 이 토큰은 인스턴스에 대한 요청을 인증합니다.
`COPILOT_OFFLINE`	Yes	오프라인 모드를 사용하도록 설정합니다. 공급자는 GitHub Enterprise Server 오프라인 모드를 사용하는 경우에만 활성화됩니다.

클라이언트(최종 사용자) 토큰 이해

Copilot CLI 는 LLM 유추에 대한 액세스 권한이 필요하므로 COPILOT_PROVIDER_GHES_TOKEN 항상 필요합니다. 또한 이슈 생성, 풀 리퀘스트, 리포지토리 검색과 같은 Copilot CLI작업을 수행하려면 GitHub가 매우 필요할 것입니다. 이러한 작업은 .를 통해 GitHub CLI수행할 수 있습니다.

gh auth login --hostname YOUR-GHES-HOSTNAME를 실행하는 것이 권장되며 바람직합니다. 성공한 후 다음 단계는 gh auth login --hostname YOUR-GHES-HOSTNAME를 COPILOT_PROVIDER_GHES_TOKEN에서 생성된 토큰으로 설정하는 것입니다. ~/.config/gh/hosts.yml에서 복사하는 것보다 토큰을 동적으로 가져오는 것이 더 안전합니다. COPILOT_PROVIDER_GHES_TOKEN="$(gh auth token --hostname YOUR-GHES-HOSTNAME)"를 사용하여 그렇게 할 수 있습니다.

또는 COPILOT_PROVIDER_GHES_TOKEN 인스턴스에서 personal access token를 생성하고, 해당 토큰을 gh auth login --hostname YOUR-GHES-HOSTNAME(으)로 설정한 다음 GitHub Enterprise Server를 실행할 때 동일한 토큰을 사용할 수 있습니다.

위의 방법은 대화형으로 사용할 Copilot CLI 때 작동합니다. 자동화의 경우 다음과 같이 몇 가지 작업을 다르게 수행해야 합니다.

GH_ENTERPRISE_TOKEN(또는 GITHUB_ENTERPRISE_TOKEN)을 personal access token로 설정합니다.
서버의 호스트 이름으로 설정합니다 GH_HOST .
동일한 호스트에 대해 gh auth login 자격 증명과 GH_ENTERPRISE_TOKEN 자격 증명이 모두 있으면 환경 변수가 우선 적용됩니다.

권장 최종 사용자 설정

인증합니다 GitHub CLI.

gh auth login --hostname YOUR-GHES-HOSTNAME

에 필요한 Copilot CLI환경 변수를 설정합니다.

export COPILOT_PROVIDER_GHES_HOST=YOUR-GHES-HOSTNAME
export COPILOT_PROVIDER_GHES_TOKEN="$(gh auth token --hostname YOUR-GHES-HOSTNAME)"
export COPILOT_OFFLINE=true

gh auth login로 여러 계정에 인증된 경우, GH_HOST을 서버의 호스트 이름으로 설정하고 GITHUB_ENTERPRISE_TOKEN(또는 "$(gh auth token --hostname YOUR-GHES-HOSTNAME)")를 GH_ENTERPRISE_TOKEN로 설정할 수 있습니다. 이렇게 하면 GitHub CLI이(가) 사용자의 GitHub Enterprise Server 인스턴스를 대상으로 하도록 보장합니다.

export GH_HOST=YOUR-GHES-HOSTNAME
export GH_ENTERPRISE_TOKEN="$(gh auth token --hostname YOUR-GHES-HOSTNAME)"

Copilot CLI를 시작합니다.

copilot

이 전체 설정을 스크립트로 실행할 수 있습니다.

예제

GitHub Enterprise Server 구성과 사용자의 Copilot CLI 구성이 모두 올바르다면, Copilot CLI 세션에서 다음과 같은 응답이 표시될 것입니다.

     • fabric-core-mcp — disabled
     • powerbi-mcp — disabled
     • slack — connected

 ● Current model: gpt-5.5

 ❯ Hello                                                                   13:31

 ● Hello!

 ❯ what is going on in github/codeql-action repo?                          13:33

 ● I’ll check recent repository activity on the GHES host: repo metadata, open 
   PRs/issues, and latest commits.

 $ Shell Fetch repo metadata 2 lines…                                         5s
   gh api --hostname "$GH_HOST" repos/github/codeql-action --jq '{name_with_own…

GitHub Enterprise Server에서 지원되는 기능

Copilot CLI 기능에 대한 최신 정보는 GitHub Copilot CLI을 가장 신뢰할 수 있는 기준 정보로 참조하세요. 일반적으로 GitHub 클라우드 서비스에 대한 연결에 의존하는 모든 기능은 GitHub Enterprise Server 오프라인 구성에서는 사용할 수 없습니다.

다음 표는 GitHub Enterprise Server 제품에서 제공되는 항목에 대한 개괄적인 방향성을 보여줍니다.

Capability	GitHub / GitHub Enterprise Cloud	GitHub Enterprise Server
AI 지원 코딩(프롬프트, 코드 생성, 디버깅)
셸 명령 및 파일 작업
GitHub 작업(이슈, PR, 리포지토리) - `gh` CLI를 통해
(필요 `gh` 인스턴스에 인증된 CLI)
GitHub MCP 서버 도구
웹 검색 및 웹 페치
Copilot 모델 선택(GitHub호스트된 모델)
원격 분석 및 사용 현황 보고
자동 업데이트

이 기사에서