GitHub Copilot CLI에서 사용자 고유의 LLM 모델 사용

사용자가 고유의 LLM 공급자(Copilot CLI)을 구성하여 GitHub에서 호스팅하는 모델 대신 사용할 수 있는 BYOK(Bring Your Own Key) 기능을 지원합니다. 이를 통해 Ollama와 같은 로컬 실행 모델을 포함하여 OpenAI 호환 엔드포인트, Azure OpenAI 또는 Anthropic에 연결할 수 있습니다.

사전 요구 사항

        Copilot CLI 가 설치되어 있습니다. 
        [AUTOTITLE](/copilot/how-tos/copilot-cli/set-up-copilot-cli/install-copilot-cli)을(를) 참조하세요.

지원되는 LLM 공급자의 API 키가 있거나 로컬 모델(예: Ollama)이 실행되고 있습니다.

지원되는 공급자

          Copilot CLI 는 다음 세 가지 공급자 유형을 지원합니다.

공급자 유형	호환되는 서비스
`openai`	OpenAI, Ollama, vLLM, Foundry Local 및 기타 OpenAI 채팅 완료 API 호환 엔드포인트. 기본 공급자 유형입니다.
`azure`	Azure OpenAI Service.
`anthropic`	Anthropic (클로드 모델)

추가 예제를 보려면 터미널에서 실행 copilot help providers 합니다.

모델 요구 사항

모델은 도구 호출 (함수 호출이라고도 함) 및 스트리밍을 지원해야 합니다. 모델에서 두 기능 Copilot CLI 중 하나를 지원하지 않는 경우 오류를 반환합니다. 최상의 결과를 얻으려면 컨텍스트 창이 128k 이상인 모델을 사용합니다.

공급자 구성

시작하기 Copilot CLI전에 환경 변수를 설정하여 모델 공급자를 구성합니다.

환경 변수	필수	설명
`COPILOT_PROVIDER_BASE_URL`	예	모델 공급자의 API 엔드포인트의 기본 URL입니다.
`COPILOT_PROVIDER_TYPE`	No	공급자 유형( `openai` 기본값), `azure`또는 `anthropic`.
`COPILOT_PROVIDER_API_KEY`	No	공급자에 대한 API 키입니다. 로컬 Ollama 인스턴스와 같이 인증을 사용하지 않는 공급자에는 필요하지 않습니다.
`COPILOT_MODEL`	예	사용할 모델 식별자입니다. 명령줄 플래그를 `--model` 사용하여 설정할 수도 있습니다.

OpenAI 호환 엔드포인트에 연결

OpenAI, Ollama, vLLM, Foundry Local 또는 OpenAI 채팅 완료 API와 호환되는 다른 엔드포인트에 연결하는 경우 다음 단계를 사용합니다.

공급자에 대한 환경 변수를 설정합니다. 예를 들어 로컬 Ollama 인스턴스의 경우:
```
export COPILOT_PROVIDER_BASE_URL=http://localhost:11434
export COPILOT_MODEL=YOUR-MODEL-NAME
```
Ollama에서 가져온 모델의 이름으로 YOUR-MODEL-NAME을(를) llama3.2으로 교체합니다 (예: llama3.2).
원격 OpenAI 엔드포인트의 경우 API 키도 설정합니다.
```
export COPILOT_PROVIDER_BASE_URL=https://api.openai.com/v1
export COPILOT_PROVIDER_API_KEY=YOUR-OPENAI-API-KEY
export COPILOT_MODEL=YOUR-MODEL-NAME
```
OpenAI API 키에 YOUR-OPENAI-API-KEY를, 사용하려는 모델에 YOUR-MODEL-NAME을(예: gpt-4o) 바꾸십시오.
```
       Copilot CLI시작하십시오.
```

copilot

Azure OpenAI에 연결

Azure OpenAI에 대한 환경 변수를 설정합니다.

export COPILOT_PROVIDER_BASE_URL=https://YOUR-RESOURCE-NAME.openai.azure.com/openai/deployments/YOUR-DEPLOYMENT-NAME
export COPILOT_PROVIDER_TYPE=azure
export COPILOT_PROVIDER_API_KEY=YOUR-AZURE-API-KEY
export COPILOT_MODEL=YOUR-DEPLOYMENT-NAME

다음 자리 표시자를 바꿉니다.

   `YOUR-RESOURCE-NAME`: Azure OpenAI 리소스 이름

   `YOUR-DEPLOYMENT-NAME`: 배포된 모델의 이름

   `YOUR-AZURE-API-KEY`: 사용자의 Azure OpenAI API 키

```
       Copilot CLI시작하십시오.
```

copilot

Anthropic에 연결

Anthropic에 대한 환경 변수를 설정합니다.
```
export COPILOT_PROVIDER_TYPE=anthropic
export COPILOT_PROVIDER_BASE_URL=https://api.anthropic.com
export COPILOT_PROVIDER_API_KEY=YOUR-ANTHROPIC-API-KEY
export COPILOT_MODEL=YOUR-MODEL-NAME
```
Anthropic API 키를 YOUR-ANTHROPIC-API-KEY로, 사용하려는 Claude 모델의 이름을 claude-opus-4-5로 바꾸십시오 (예: YOUR-MODEL-NAME).
```
       Copilot CLI시작하십시오.
```

copilot

오프라인 모드에서 실행

오프라인 모드에서 Copilot CLI를 실행하여 GitHub의 서버에 연결하지 않도록 할 수 있습니다. CLI가 로컬 또는 온-프레미스 모델 공급자와만 통신해야 하는 격리된 환경을 위해 설계되었습니다.

중요

오프라인 모드는 공급자가 로컬이거나 동일한 격리된 환경 내에 있는 경우에만 전체 네트워크 격리를 보장합니다. 원격 엔드포인트를 가리키는 경우 COPILOT_PROVIDER_BASE_URL 프롬프트 및 코드 컨텍스트가 네트워크를 통해 해당 공급자에게 계속 전송됩니다.

공급자 구성에 설명된 대로 공급자 환경 변수를 구성합니다.
오프라인 모드 환경 변수를 설정합니다.
```
export COPILOT_OFFLINE=true
```
```
       Copilot CLI시작하십시오.
```

copilot

GitHub Copilot CLI에서 사용자 고유의 LLM 모델 사용

이 기사에서