GitHub Copilot CLI 연동

GitHub의 터미널 코딩 에이전트 Copilot CLI를 팩트챗 Gateway와 함께 사용해보세요!

환경 변수 몇 개만 지정하면 파일 편집, 셸 명령 실행, 코드 검색까지 Copilot의 에이전트 루프 전체가 Gateway를 통해 동작합니다. 사용량은 팩트챗 계정의 크레딧으로 집계됩니다.

공식 레퍼런스: Copilot CLI에서 직접 준비한 모델 사용하기

시작하기 전에 팩트챗 API 키가 필요합니다. 인증 가이드에서 발급 방법을 확인해주세요.

COPILOT_PROVIDER_WIRE_API=responses는 OpenAI 추론 모델(gpt-5.6-terra 등)에 필요합니다. 지정하지 않으면 Copilot이 chat/completions로 연결하는데, OpenAI가 추론 파라미터와 도구 호출의 조합을 이 경로에서 허용하지 않아 400이 반환됩니다. 추론 모델이 아니라면 생략해도 됩니다.

COPILOT_PROVIDER_TYPE은 지정하지 않으면 openai로 동작합니다. Claude 계열 모델을 Anthropic 방식으로 쓰려면 COPILOT_PROVIDER_TYPE=anthropic과 함께 base URL을 .../v1/gateway/claude로 지정합니다.

이 방식에서는 GitHub 로그인이나 Copilot 구독이 필요하지 않습니다. Copilot CLI가 모든 요청을 지정한 엔드포인트로 직접 보내기 때문입니다.

연결 확인

인터랙티브 모드는 copilot만 입력하면 실행됩니다. 처음 실행할 때는 현재 폴더를 신뢰할지 묻는 화면이 먼저 나타나므로 Yes를 선택해주세요. 비대화형 실행(-p)에서는 --allow-all-tools가 필요합니다.

모델 지정

사용 가능한 모델 목록은 Gateway에서 조회할 수 있습니다.

무료 모델과 Super Agent는 정책상 Gateway로 호출할 수 없습니다. 이 모델을 COPILOT_MODEL에 지정하면 403 permission_denied - Model 'X' is not available through the Gateway API가 반환됩니다. 목록에 있는 유료 모델을 사용해주세요.

Copilot CLI는 도구 호출과 스트리밍을 모두 사용하므로, 두 기능을 지원하고 컨텍스트가 128k 이상인 모델을 권장합니다.

지원 기능

기능	지원 여부
셸 도구 호출 (명령 실행)	지원
파일 읽기·편집	지원
스트리밍 응답	지원
추론(reasoning) 모델	지원 — OpenAI 추론 모델은 `COPILOT_PROVIDER_WIRE_API=responses` 필요
코드 자동완성 (인라인 제안)	미지원 — GitHub 계정과 Copilot 구독이 필요한 별도 기능입니다
크레딧 사용량 집계	지원 (API 키 소유 계정에 차감)

크레딧 잔액은 아래로 확인할 수 있습니다.

Copilot CLI는 시스템 프롬프트와 도구 정의가 커서 한 턴의 입력 토큰이 수만 개에 이릅니다. 다만 같은 세션에서 반복되는 부분은 프롬프트 캐시로 처리되어 캐시된 입력 토큰은 일반 입력의 10분의 1 단가로 과금됩니다.

VS Code에서 쓰기

VS Code의 Copilot Chat도 커스텀 엔드포인트를 지원합니다. 채팅 모델 선택 → 모델 관리 → Custom Endpoint에서 위와 같은 base URL과 API 키를 등록하면 됩니다. 두 가지만 확인해주세요.

인라인 코드 자동완성에는 적용되지 않습니다. 채팅과 에이전트 기능에만 적용됩니다.
Copilot Business·Enterprise 사용자는 관리자가 해당 정책을 꺼둘 수 있습니다.

트러블슈팅

증상	원인	해결
`401 Unauthorized`	API 키가 전달되지 않음	`COPILOT_PROVIDER_API_KEY`가 현재 셸에 설정되어 있는지 확인해주세요.
`403 Model is not available through the Gateway API`	무료 모델이나 Super Agent를 지정	정책상 API로는 호출할 수 없습니다. 다른 유료 모델을 사용해주세요.
`404 Model not found`	존재하지 않는 모델 ID (오타·미제공 모델)	`COPILOT_MODEL`이 Gateway `/models/` 목록에 있는 ID인지 확인해주세요.
`400 Function tools with reasoning_effort are not supported ... in /v1/chat/completions`	OpenAI 추론 모델을 기본 연결 방식으로 호출	`export COPILOT_PROVIDER_WIRE_API=responses`를 지정해주세요.
도구 실행이 거부됨 (`Permission denied and could not request permission from user`)	비대화형 실행에서 도구 사용 승인을 받을 수 없음	`-p` 실행에는 `--allow-all-tools`가 필요합니다.
요청이 `400`으로 거부됨	기관 관리자 설정의 데이터 보안 > Gateway API 항목이 켜져 있음	PII·금칙어 정책이 Gateway 트래픽에도 적용됩니다. 관리자에게 정책 적용 범위를 확인해주세요.

Gateway 해제 (GitHub 기본 연결로 복원)

환경 변수를 지우면 Copilot CLI는 다시 GitHub 계정 인증으로 돌아갑니다.

마지막 수정 날짜: Aug 31, 2026

Codex CLI

OpenCode