GitHub Copilot CLI란
GitHub Copilot CLI는 터미널용 GitHub 코딩 에이전트입니다. BYOK(bring-your-own-key) 모드는 환경 변수로 설정한 제공자에게 모델 요청을 보냅니다. 이 구성은 그 제공자를 Capriole AI로 지정합니다.사전 준비
시작하기 전에 다음이 있는지 확인하세요.- Capriole AI 계정(여기에서 가입)
- Premium 플랜(월 USD 9, 무제한 웹 채팅 포함) 또는 Team 플랜. API 키를 만들려면 둘 중 하나가 필요합니다(구독하기)
- Capriole AI API 키(키 받기)
설치
npm으로 GitHub Copilot CLI를 설치하세요.COPILOT_PROVIDER_BASE_URL이 설정되어 있으면 GitHub에 로그인할 필요가 없습니다.
구성
모델 검증
GitHub Copilot CLI 1.0.100 버전은 아래 프로필로 지원 모델 섹션의 모든 모델에서 Capriole AI를 통한 파일 읽기, 파일 쓰기, 최종 답변 검사를 통과합니다. Copilot CLI는 한 번에 하나의 제공자만 사용하므로 원하는 모델 계열의 프로필을 선택하세요. 각 프로필은 모델 값 두 개를 설정합니다.COPILOT_PROVIDER_WIRE_MODEL은 Copilot이 보내는 Capriole AI 모델 ID입니다.COPILOT_PROVIDER_MODEL_ID는 Copilot이 알고 있는 모델입니다. Copilot은 이 값으로 도구, 프롬프트, 토큰 한도를 정합니다.
GPT 모델
GPT 모델은 Responses API를 사용합니다.COPILOT_PROVIDER_MODEL_ID="gpt-6.1-sol"과 COPILOT_PROVIDER_WIRE_MODEL="openai/gpt-6.2-sol"을 설정하세요.
Claude 모델
Claude 모델은 Anthropic Messages를 사용합니다.COPILOT_PROVIDER_WIRE_MODEL="claude-opus-5-5"를 설정하세요.
COPILOT_PROVIDER_BEARER_TOKEN은 키를 Bearer 토큰으로 보냅니다.- Copilot이
/v1/messages를 직접 추가하므로 Base URL에는/v1이 없습니다. COPILOT_PROVIDER_MODEL_ID="claude-opus-4.6"을 유지하세요.claude-sonnet-4같은 이전 프로필을 쓰면 Copilot이 추론 예산을 보내고, Opus 5.5는requires adaptive thinking으로 이를 거부합니다.
Gemini, Grok, GLM, Kimi 모델
이 모델은 Chat Completions를 사용합니다.COPILOT_PROVIDER_WIRE_MODEL을 google-latest, google/gemini-4-carbon, google/gemini-4-argon, google/gemini-3.8-flash, xai/grok-4.7 또는 zai/glm-5.3-flash로 바꾸세요.
COPILOT_PROVIDER_MODEL_ID="claude-sonnet-4"를 유지하세요. gpt-5.4 같은 GPT 프로필을 쓰면 Copilot이 이 모델들이 거부하는 도구 유형을 보냅니다.
Kimi K3.1 Pro에는 COPILOT_PROVIDER_MODEL_ID="claude-opus-4.6"과 COPILOT_PROVIDER_WIRE_MODEL="moonshot/kimi-k3.1-pro"를 설정하세요. claude-sonnet-4 프로필은 temperature: 0을 보내는데, Kimi K3.1 Pro는 이를 거부합니다.
프로필을 계속 사용하려면 해당 줄을 ~/.zshrc 또는 ~/.bashrc에 추가한 다음 새 터미널을 여세요.
GitHub Copilot CLI 실행
프로젝트 디렉터리에서 Copilot CLI를 시작하세요.-p로 프롬프트를 전달하세요.
지원 모델
openai-latest, claude-latest, google-latest는 항상 각 계열의 최신 플래그십 모델을 가리킵니다. 현재는 GPT-6.2 Astra, Claude Fable 5.1, Gemini 4 Carbon입니다.
문제 해결
Copilot CLI가 인증 오류를 반환하는 이유는 무엇인가요?
같은 셸에서CAPRIOLE_AI_API_KEY를 내보냈는지 확인하세요. Claude 모델에는 COPILOT_PROVIDER_API_KEY가 아니라 COPILOT_PROVIDER_BEARER_TOKEN을 사용하세요.
요청이 엔드포인트 오류로 실패하는 이유는 무엇인가요?
GPT, Gemini, Grok, GLM, Kimi 모델에서COPILOT_PROVIDER_BASE_URL은 https://api.caprioletech.com/v1입니다. Claude 모델에서는 /v1 없는 https://api.caprioletech.com입니다.
Opus 5.5가 requires adaptive thinking으로 실패하는 이유는 무엇인가요?
COPILOT_PROVIDER_MODEL_ID="claude-opus-4.6"을 설정하세요.
Gemini, Grok, GLM, Kimi 요청이 도구 오류로 실패하는 이유는 무엇인가요?
COPILOT_PROVIDER_MODEL_ID="claude-sonnet-4"(Kimi K3.1 Pro는 "claude-opus-4.6")를 설정하세요. GPT 프로필은 OpenAI 모델만 받는 도구 유형을 보냅니다.
참고
- Copilot CLI는 로컬에서 코딩 도구를 실행하며, 모델 요청은 Capriole AI가 처리합니다.
- 모든 BYOK 환경 변수를 보려면
copilot help providers를 실행하세요. - Gemini 4 Carbon은 Gemini 4 Argon보다 오래 추론하므로 턴마다 시간이 더 걸리고 토큰도 더 쓸 수 있습니다. 더 빠른 응답이 필요하면
google/gemini-4-argon을 사용하세요. - 같은 키를 다른 코딩 에이전트에서도 쓰려면 코딩 에이전트에 API 키 하나 사용하기 가이드를 참고하세요.
- 공식 참고: GitHub Copilot CLI 설치, Copilot CLI에서 BYOK 모델 사용하기.

