GitHub Copilot CLI 대안: 워크플로와 API 제어에 따라 선택하기

모델 선택이나 Copilot 요금 때문에 GitHub Copilot CLI를 떠나는 경우, 다른 클라이언트를 검토하기 전에 자체 키로 Copilot CLI를 먼저 평가하세요. GitHub의 authenticate 문서에는 "If you use your own LLM provider API keys (BYOK), GitHub authentication is not required"라고 명시되어 있고, BYOK 사용 방법에는 필수 환경 변수가 두 개뿐이라고 나와 있습니다. 자체 키로 해결되지 않는 이유, 즉 소스를 읽을 수 있는 클라이언트, Copilot을 비활성화한 조직, 다른 공급업체를 중심으로 구축한 워크플로가 이유라면 아래 선택 트리가 이유와 후보를 연결합니다.

그 전에 한 가지 경고가 있습니다. 이 검색어의 검색 결과는 편집기의 인라인 자동 완성에 관한 일반적인 "GitHub Copilot alternatives" 비교 글과 두 개의 오래된 선행 제품이 대부분을 차지합니다. 실제로 실행 중인 제품을 대체하는지 확인하세요.

첫 번째 확인: 어떤 "Copilot CLI"를 떠나나요?

명령 문자열이 함정입니다. 2026년 1월 21일 변경 로그 이후 gh copilot는 최초 실행 시 Copilot CLI 설치를 요청한 다음 이를 실행하며 모든 인수와 플래그를 전달합니다. 따라서 같은 단어가 해당 날짜 전후로 서로 다른 소프트웨어를 호출합니다. 그러므로 gh copilot suggest 또는 explain를 설명하는 튜토리얼은 오늘날 사용하는 것이 아니라 보관된 확장을 설명하는 것입니다.

사람들이 떠나는 이유와 BYOK가 이미 해결하는지 여부

구독 문제에서 GitHub가 서로 모순되므로 양쪽을 모두 읽어야 합니다. authenticate 페이지에는 BYOK에서는 GitHub 인증이 필요하지 않고 다른 모든 사용에서는 필요하다고 나와 있습니다. BYOK 개념 페이지에는 로컬 BYOK 키가 클라이언트 측에서 처리되며 이 메커니즘이 "suitable for air-gapped environments or users without Copilot subscriptions"라고 나와 있습니다. 그러나 README에는 여전히 "An active Copilot subscription"이 사전 요구 사항으로 기재되어 있으며 단순히 수정되지 않은 상태입니다. 적용하기 전에 두 가지 조건을 알아두세요. 사용 방법 문서에서는 BYOK 모델이 "support tool calling (also called function calling) and streaming"을 지원해야 하며 최소 128k 컨텍스트 창을 권장합니다. 또한 config-directory reference에는 어떤 프로바이더나 모델을 선언하는 ~/.copilot/providers.json가 "takes precedence over the legacy COPILOT_PROVIDER_* environment variables"라고 나와 있습니다. 이 파일은 BYOK 사용 방법 문서에는 언급되지 않으며 GitHub는 스키마도 공개하지 않고, 단지 "a JSON object with providers and models keys"라고만 설명합니다. 포럼의 providers.json 형식을 복사하지 마세요. 이 페이지에서는 어떤 형식도 만들어내지 않습니다.

플랜 안내 페이지에서 확인되는 사항이 하나 더 있습니다. 개인용 플랜 페이지에는 "모든 플랜에 Copilot CLI 포함"이라고 되어 있고, 사용량 기반 결제 페이지에는 Copilot CLI가 AI 크레딧을 소비하는 기능 중 하나로 나열되어 있으며, 크레딧 1개를 $0.01로 책정하고, 각 모델의 가격에 따라 입력·출력·캐시된 토큰 사용량을 계량하며, 포함된 크레딧은 "다음 달로 이월되지 않는다"고 하고 할당량은 "각 달의 첫날 00:00:00 UTC에" 재설정된다고 명시되어 있습니다. BYOK 트래픽이 이 계량에서 제외되는지는 GitHub가 CLI에 대해 명시한 내용이 아닙니다. "Copilot 프리미엄 요청 할당량에 포함되지 않는다"는 문장은 CLI와는 다른 SDK를 다루는 Copilot SDK BYOK 페이지에 나타나는 반면, CLI를 다루는 결제 페이지에는 예외가 명시되어 있지 않습니다. 개념 페이지의 "GitHub의 Copilot API에 대한 의존성을 제거한다"는 표현을 CLI에 대해 현재 이용 가능한 가장 강력한 진술로 간주하고, 본인의 사용량 페이지와 대조해 확인하세요.

가격과 크레딧 허용량은 개별 플랜 페이지에서 확인했으며, 확인일은 2026년 9월 21일입니다. 해당 페이지에는 월간 가격만 공개되어 있고 연간 가격은 표시되지 않습니다. 별도로 사용량 기반 결제 페이지에는 유료 Copilot 플랜이 "자동 모델 선택 사용 시 모델 비용 10% 할인" 대상이라고 명시되어 있습니다.

변경하려는 대상별로 묶은 대안

정리 글에 대한 수정 사항은 두 가지입니다. 여전히 여러 글에서 날짜를 표시하지 않은 채 Aider를 최고의 오픈 소스 선택지라고 부르지만, 위의 날짜가 판단을 내리는 공정한 기준이며 공식적으로 해당 프로젝트가 중단되었다고 말하는 곳은 없습니다 — 다만 그 표의 다른 모든 저장소는 이 확인 당일에 코드를 푸시했습니다. 또한 Claude Code는 설계상 일반 게이트웨이 클라이언트보다 범위가 좁습니다. 게이트웨이 문서에는 Anthropic이 "타사 게이트웨이 제품을 보증하거나 유지 관리하거나 감사하지 않으며, 어떤 게이트웨이를 통해서든 Claude Code를 Claude가 아닌 모델로 라우팅하는 것을 지원하지 않는다"고 명시되어 있고, 게이트웨이 자격 증명 없이 ANTHROPIC_BASE_URL만 설정하는 것으로는 저장된 claude.ai 로그인을 대체할 수 없다고 되어 있습니다. Copilot CLI의 BYOK는 그 반대 형태로 문서화되어 있습니다. GitHub의 인증 페이지에 따르면 해당 경로에서는 GitHub 인증이 필요하지 않습니다 — 다만 위의 메모에서 설명하듯 README는 이에 맞게 수정되지 않았습니다. GitHub 자체의 기본 URL 예시도 일관되지 않는다는 점에 유의하세요 — Ollama에는 http://localhost:11434, OpenAI에는 https://api.openai.com/v1, Anthropic에는 https://api.anthropic.com를 사용하므로 게이트웨이에 적용할 보편적인 형태는 없습니다.

무엇이 이전되고 무엇이 남는가

위의 변경 로그 항목은 2026년 9월 21일 버전 헤더와 함께 원시 변경 로그에서 읽었습니다. 실무 순서는 다음과 같습니다. Copilot 지침 파일의 내용을 담는 AGENTS.md를 커밋하고, MCP 서버가 편집기별 파일이 아니라 .mcp.json에 있는지 확인한 다음, 실제로 사용 중인 항목을 목록화하세요.

# Inventory what Copilot CLI is actually reading before you replace it.
ls ~/.copilot                     # settings.json, permissions-config.json, providers.json, session-store.db
echo "${COPILOT_PROVIDERS_CONFIG:-~/.copilot/providers.json}"   # a declaration here beats every COPILOT_PROVIDER_* export
ls AGENTS.md CLAUDE.md .mcp.json .github/copilot-instructions.md

세 번째 줄은 보이는 것보다 중요합니다. 오래된 providers.json가 있으면 어느 방향으로든 작성하려는 내보내기보다 우선하므로, 구성 변경이 효과가 없었다고 결론 내리기 전에 이를 확인하세요. 그런 다음 현재 설정에서 제한된 작업 하나를 실행하고 후보 설정에서도 같은 작업을 실행한 뒤, 읽는 재미가 있는 대화 기록이 아니라 실제로 승인할 변경 사항을 비교하세요.

롤백은 간단하며 시작하기 전에 명시할 가치가 있습니다. 여기서는 Copilot CLI를 제거하지 않습니다. npm 패키지는 설치된 상태로 유지되며, providers.json가 이를 재정의하지 않는지 확인한 후 COPILOT_PROVIDER_* 변수를 설정 해제하면 클라이언트는 GitHub 호스팅 라우팅으로 돌아갑니다. 단, 이를 허용하는 플랜을 여전히 보유하고 있어야 합니다. 대체 경로가 자체 저장소에서 실제 작업을 완료할 때까지 현재 가진 액세스 권한을 유지하세요.

API 경로의 실제 비용 추정 예시

이는 측정된 작업 비용이 아니며 청구액 상한도 아닌, 예시용 토큰 산술입니다. 캐시되지 않은 입력 토큰 400,000개를 보내고 출력 토큰 30,000개를 받는 세션 하나를 가정하며, 캐시 읽기나 외부 도구는 없습니다. 요율은 100만 토큰당 Kunavo 카탈로그의 현재 가격입니다.

이를 Copilot과 직접 비교하는 방식으로 변환하지 마세요. GitHub는 Copilot CLI를 AI 크레딧으로 청구하며 크레딧당 $0.01, $10 예산이면 크레딧 1,000개를 충당한다고 명시하지만, 세션이 소비하는 크레딧은 GitHub 자체의 모델별 토큰 가격에 따라 달라지며 이 페이지에서는 이를 수집하지 않았습니다. 두 측정값은 해당 가격 없이는 비교할 수 없으므로, 동일한 작업을 양쪽에서 실행하고 각 계정에 기록된 사용량을 확인하는 것이 정직한 방법입니다. 또한 가장 저렴하게 표시된 요율과 작업을 완료하는 데 드는 최저 비용은 서로 다른 주장이라는 점을 기억하세요. 세 번 시도해야 하는 저렴한 모델이 한 번에 완료하는 모델보다 비용이 더 들 수 있습니다.

Kunavo 카탈로그 금액은 상한이 아니라 결제 하한입니다. 업스트림에서 요금을 보고하면 청구액은 카탈로그 비용과 업스트림 비용에 해당 마크업을 곱한 금액 중 큰 값입니다. 최소 충전액은 선불 크레딧 $10이며, 이는 플랜이나 시트를 구매하는 것이 아니라 잔액을 충전합니다 — 결제 세부 정보를 참조하세요.

자체 키로 Copilot CLI를 사용하기로 했다면 Copilot CLI 설정 가이드에서 변수와 providers.json 우선순위 함정을 다룹니다. 다른 클라이언트를 선택했다면 Codex CLI, opencode, Crush, Qwen Code, Cline, Aider 또는 Claude Code에서 시작하고, 키에 자금을 충전할 준비가 되면 Kunavo 계정을 생성하세요. 이는 게시된 구성 참조 자료이지 호환성 테스트가 아닙니다 — 이 클라이언트 중 어느 것도 여기서 런타임 테스트하지 않았습니다.

종료 여부가 아닌 정면 비교를 원한다면 Copilot CLI와 Claude Code 비교에서 플랜, 결제 형태 및 BYOK 경계를 비교합니다. OpenAI 호환 API에서는 호환 경로에 포함되는 것과 포함되지 않는 것을 다루며, opencode 대안과 Aider 대안에서는 다른 시작 클라이언트에서 동일한 선택 트리를 실행합니다.

자주 묻는 질문

2026년 9월 21일 실시간 소스를 기준으로 확인했습니다. github/copilot-cli, github/gh-copilot 및 8개 대안 저장소에 대한 GitHub API, @github/copilot의 npm 레지스트리, GitHub의 BYOK 방법 안내, BYOK 개념 페이지, 인증 페이지, 구성 디렉터리 참조, 개별 플랜 페이지 및 사용량 기반 결제 페이지, 원시 Copilot CLI README와 변경 로그, Anthropic의 게이트웨이 및 게이트웨이 호환성 문서, 그리고 각 대안의 자체 구성 문서 — Codex CLI 구성 참조, opencode 프로바이더 페이지, Crush 및 Qwen Code README, Aider의 OpenAI 호환 페이지, Gemini CLI의 인증 및 할당량·가격 문서 — 를 확인했습니다. 이 페이지의 어떤 내용도 런타임 테스트하지 않았고, 여기의 어떤 클라이언트도 Kunavo에 연결해 실행하지 않았으며, providers.json 우선순위, 도구 호출 및 스트리밍에 관한 주장은 관찰된 동작이 아니라 문서화된 동작입니다. Kunavo 토큰 요율은 실시간 카탈로그에서 가져왔으며 모든 달러 예시는 예시용 토큰 산술입니다.