Mistral Vibe와 Claude Code — 하나의 TOML 파일과 하나의 프로토콜

Mistral Vibe CLI와 Claude Code는 모두 터미널 코딩 에이전트이며, 선택은 어느 쪽이 더 똑똑한지보다 구조의 문제입니다. Vibe CLI는 제공자 목록이 수동으로 편집하는 TOML 파일인 Apache-2.0 소프트웨어이고, Claude Code는 Claude 모델과 하나의 프로토콜로 통신하며 유료 Anthropic 계정이 필요한 독점 소프트웨어입니다. Vibe CLI는 자체 키 사용 범위가 더 넓습니다. Claude Code는 문서화되고 지원되는 범위가 더 명확합니다. 아래 내용은 모두 특정 시점의 정보이며, 런타임 호환성 테스트 결과가 아닙니다.

먼저 가격의 의미를 바꾸는 구분부터 하겠습니다. Mistral의 자체 도움말 센터는 이제 Le Chat이 Vibe라고 안내하며, "Mistral Vibe"는 웹과 모바일의 Vibe Work, Vibe Chat, Vibe Code를 아우르는 전체 제품군을 가리킵니다. 이 페이지는 터미널 에이전트만 다룹니다. 즉, mistral-vibe 패키지, mistralai/mistral-vibe 저장소, 바이너리 vibe, 그리고 v2.25.5입니다. 아래에 나오는 Mistral 요금제 가격은 이 바이너리보다 훨씬 많은 기능을 포함하는 계정에 대한 것입니다. 반면 Claude Code는 Anthropic 자체 클라이언트이며 별도의 타사 프록시인 Claude Code Router가 아닙니다.

무엇을 선택할지와 전환 비용

Vibe CLI를 선택하세요 제공자 결정을 직접 통제해야 하거나, 비용을 지불하기 전에 터미널 에이전트를 사용해 보고 싶다면 말입니다. Mistral의 가격 페이지에는 Free 요금제에 "제한된 코딩 세션"이 포함되어 있으며, CLI 자체는 Python 3.12 이상에서 pip install mistral-vibe로 설치할 수 있는 무료 소프트웨어입니다. 설정 문서는 사용자 지정 제공자의 예시로 타사 게이트웨이를 사용하므로, 다른 곳을 가리키는 것은 해킹이 아니라 문서화된 패턴입니다. 저장소에는 Zed, JetBrains IDE, Neovim용 Agent Client Protocol 설정 지침이 포함되어 있으며, Mistral의 도움말 센터에는 명령줄 도구와 함께 자체 VS Code 확장도 나와 있습니다.

Claude Code를 선택하세요 이미 Claude 모델을 사용하고 있으며 제공자의 자체 프로토콜을 사용하는 제공자 자체 클라이언트를 원한다면 말입니다. 설정 문서에는 "Claude Code를 사용하려면 Pro, Max, Team, Enterprise 또는 Console 계정이 필요합니다. 무료 claude.ai 요금제에는 Claude Code 액세스가 포함되지 않습니다"라고 명시되어 있습니다. 그 대가로 백그라운드에서 자동 업데이트되는 유지 관리형 네이티브 바이너리, 이름이 지정된 6개의 권한 모드, 그리고 사용자 지정 엔드포인트가 전달해야 하는 헤더와 본문 필드를 정확히 안내하는 전체 게이트웨이 호환성 가이드를 얻습니다. Mistral의 CLI 문서에는 Vibe의 타사 경로에 대해 이에 상응하는 호환성 참고 자료가 없습니다.

반대 방향에서 전환하는 경우 — 이미 Claude Code를 사용하면서 Vibe CLI를 검토하는 경우 — 마이그레이션 비용은 코드가 아니라 설정에 있습니다. 어느 클라이언트도 저장소를 변경하지 않습니다. 이동되지 않는 것은 주변 설정입니다. Claude Code는 ~/.claude, 프로젝트 .claude 디렉터리 및 .mcp.json에 설정을 보관하고, Vibe CLI는 자체 설정을 ~/.vibe/config.toml, 프로젝트 ./.vibe/config.toml 및 신뢰할 수 있는 폴더 파일에 보관합니다. 공유 형식이나 가져오기 도구가 없으므로 마이그레이션 도구를 기대하기보다 제공자, 권한, MCP 서버를 다시 선언하는 데 반나절을 할애해야 합니다. 권한 사용 습관도 깔끔하게 매핑되지 않으며, 다음 표에서 이를 구체적으로 보여 줍니다.

Mistral Vibe CLI와 Claude Code 비교

2026년 9월 19일 확인한 출처: Vibe CLI의 GitHub API 및 PyPI 메타데이터, Claude Code의 npm 레지스트리 및 권한 모드. Vibe는 2026년 9월 10일부터 18일까지 네 번 릴리스될 정도로 출시 주기가 빠르므로, 설정 관련 주장은 지난달에 읽은 문서 페이지가 아니라 특정 버전에 고정하세요.

각 계정의 비용

2026년 9월 19일 mistral.ai/pricing 및 claude.com/pricing에서 확인했습니다. 솔직히 밝혀야 할 정보의 공백은 세 가지입니다. 어느 제공자도 월 요금을 사용량으로 나누어 계산할 수 있도록 사용량 수치를 공개하지 않습니다. 게시된 표현은 "제한된 코딩 세션", "하루 종일 코딩", "5시간 세션당 Pro보다 5배 또는 20배 더 많은 사용량"이며, 다른 곳에서 보는 월간 사용 시간은 누군가의 추정치입니다. Max 페이지에는 "From $100"만 표시되므로 이 가이드에서는 20배 티어의 가격을 제시하지 않습니다. 또한 Anthropic의 가격 페이지와 배포 문서 일부에서 좌석 요금이 다르므로, 주문하기 전에 결제 화면에서 좌석 견적을 확인하세요.

요금제 표만으로는 알 수 없는 것이 하나 더 있습니다. Mistral은 월간 API 크레딧을 특정 제품에 한정하지 않은 요금제 혜택으로 표시하므로, 이 크레딧을 Vibe CLI 사용에 직접 사용할 수 있는지는 가격 페이지에서 답하지 않습니다. 해당 크레딧을 코딩 예산으로 간주하기 전에 자신의 계정에서 확인하세요. 2026년 10월 1일 업데이트: 이 표를 9월 19일에 확인했을 때 Pro의 API 크레딧은 $15였지만, 10월 1일 가격 페이지에는 Pro가 $30, 학생 Education 요금제가 $15로 표시됩니다. 요금제 키, 종량제 키 및 요금제 한도 초과 시 처리 방식은 Mistral Vibe 가격에서 확인할 수 있습니다.

두 클라이언트 중 하나를 자신의 API 키로 연결하기

Vibe CLI는 [[providers]] 항목을 이름별로, [[models]] 항목을 별칭별로 병합하며, 문서화된 우선순위는 높은 순서대로 관리자 설정, 명령줄 플래그, 환경 변수, 프로젝트 ./.vibe/config.toml, 사용자 ~/.vibe/config.toml입니다. api_style = "openai"를 사용하면 요청은 bearer 토큰과 함께 {api_base}/chat/completions로 전송되므로 기본 URL은 /v1로 끝납니다.

# Vibe CLI reads ./.vibe/config.toml first, then ~/.vibe/config.toml.
active_model = "kunavo-sonnet"

[[providers]]
name = "kunavo"
api_base = "https://api.kunavo.com/v1"
api_key_env_var = "KUNAVO_API_KEY"
api_style = "openai"
backend = "generic"

[[models]]
name = "claude-sonnet-5"
provider = "kunavo"
alias = "kunavo-sonnet"
display_name = "Claude Sonnet 5 (Kunavo)"

여기서 쉽게 잘못 이해할 수 있는 점이 두 가지 있습니다. v2.25.5 소스는 api_style를 검증 없이 일반 딕셔너리 조회로 처리하므로 오타가 있으면 설정을 불러올 때가 아니라 요청 시점에 오류가 발생합니다. 또한 제공자 추가 UI가 없습니다. /config와 --setup는 타사 제공자를 생성하지 않으므로 이 파일은 수동으로 편집해야 합니다. 소스는 "anthropic", "openai-responses", "reasoning", "vertex-anthropic"도 "openai"와 함께 노출합니다. 이 중 Anthropic 방식은 /v1/messages에 x-api-key와 함께 요청을 보내므로 api_base에는 /v1가 포함되면 안 됩니다. 그러나 Mistral 문서에는 이 값들이 전혀 나와 있지 않습니다. v2.25.5에서 실험 단계를 벗어나 승격된 Unified Harness에는 이 값들이 실제로 포함되어 있습니다. 동일한 소스가 api_style를 그대로 전달하고 해당 경로에서 각 스타일의 자격 증명 방식을 구현하므로, 이를 레거시 전용이 아니라 소스에서 확인되었지만 문서화되지 않은 기능으로 취급해야 하며, 이 페이지에서는 실행하지 않았다는 점도 유의하세요.

Claude Code에는 정확히 하나의 경로가 있으며, 그 경로의 전체 과정이 문서화되어 있습니다. 기본 URL과 인증 정보를 설정하세요. 게이트웨이 페이지에는 다음과 같이 명시되어 있습니다. "게이트웨이 인증 정보 변수 또는 apiKeyHelper가 활성화되어 있는 동안에는 개발자의 claude.ai 구독이 사용되지 않습니다. 해당 세션에서는 인증 정보가 구독 로그인을 대체하며, 구독의 사용량 제한은 적용되지 않습니다." 인증 정보 없이 기본 URL을 설정하는 것만으로는 구독이 대체되지 않습니다.

export ANTHROPIC_BASE_URL="https://api.kunavo.com"
export ANTHROPIC_AUTH_TOKEN="sk-kn-..."
export ANTHROPIC_MODEL="claude-sonnet-5"
export ANTHROPIC_DEFAULT_OPUS_MODEL="claude-opus-5-5"
export ANTHROPIC_DEFAULT_SONNET_MODEL="claude-sonnet-5"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="claude-haiku-4-5"

claude

모델 관련 줄을 유지하세요. Claude Code의 내장 기본 모델과 opus 별칭은 모두 최신 Opus로 해석되며, Kunavo가 해당 모델을 아직 제공하지 않으면 첫 번째 요청에서 404가 반환됩니다. 이 고정 설정은 opus을 Claude Opus 5.5로 지정합니다. 이 설정에는 Claude Code v2.1.280 이상이 필요하며, 위 표의 2.1.277 릴리스보다 최신입니다(claude update 실행). sonnet 별칭은 기본적으로 Kunavo가 제공하지 않는 Sonnet 5.5를 요청하므로 ANTHROPIC_DEFAULT_SONNET_MODEL 줄이 없으면 /model sonnet 전환, opusplan의 실행 단계 및 model: sonnet로 설정된 모든 하위 에이전트가 404를 반환합니다.

Kunavo는 chat completions, responses 및 Anthropic 네이티브 Messages 엔드포인트를 제공하며, Messages 경로는 Authorization 또는 x-api-key 중 하나로 자격 증명을 받을 수 있습니다. 이것이 두 클라이언트가 동일한 방식으로 인증할 수 있는 이유입니다. 기본 URL 참고 자료 및 Claude Code 통합 가이드를 참조하세요. 이는 게시된 설정 참고 자료이며 호환성 테스트 결과가 아닙니다.

타사 엔드포인트가 제공하지 않는 것

기능 표에서 놓치는 부분이며, 마케팅 페이지보다 소스 코드를 읽어야 하는 가장 강력한 이유입니다.

Vibe CLI에서는 모든 트래픽이 사용자가 지정한 제공자로 전송되는 것은 아닙니다. 대화와 작업 트리의 이름을 지정하는 작은 호출인 백그라운드 "유틸리티" 완성 요청은 Mistral 제공자를 사용할 수 있을 때마다 Mistral 자체 mistral-vibe-cli-fast 모델로 라우팅됩니다. 기본 제공되는 설정은 항상 하나를 구성하며, 세션의 활성 제공자가 다른 제공자인 경우에도 마찬가지입니다. v2.25.5 소스는 이 동작과 폴백을 명시합니다. 사용할 수 있는 Mistral 제공자가 없으면 유틸리티 호출은 세션의 활성 모델로 전송됩니다. 실제로 이는 MISTRAL_API_KEY가 설정되지 않았거나 allowed_models를 통해 별칭을 제외한 경우를 의미합니다. Smart Approve는 더 나아갑니다. 2.25.1 변경 로그에는 분류기가 "이제 세션의 활성 모델과 관계없이 빠른 Mistral 모델에서 분류기를 실행한다"고 나와 있으며, Unified-Harness 전용입니다. 따라서 Kunavo만 사용하는 세션은 현실적으로 Smart Approve가 아니라 accept-edits 또는 plan에 해당합니다. 커넥터 부트스트랩 역시 backend가 mistral인 제공자가 있어야 활성화되며, 브라우저 로그인에는 여기에 더해 브라우저 인증 URL도 구성되어 있어야 합니다. 위 블록과 같은 방식으로 선언한 제공자는 자격 증명만 제공하는 것입니다. 또한 API 키 환경 변수 없이 구성된 타사 제공자는 v2.25.5 수정 전까지 Unified Harness에서 매 턴 실패했으므로, 자신의 설정을 디버깅하기 전에 알아둘 가치가 있을 만큼 최근에 변경된 사항입니다.

첫 요청이 아예 작동하는지를 좌우하는 샘플링 세부 사항도 있습니다. Vibe의 OpenAI 경로는 temperature를 무조건 페이로드에 포함하지만, Anthropic 경로는 이 필드를 전혀 보내지 않습니다. 이는 Kunavo의 카탈로그가 여러 Claude 목록에서 temperature, top_p, top_k를 지원하지 않는 것으로 표시하고 디스패치 전에 제거하기 때문에 중요합니다. 이를 그대로 전달하는 경로라면 클라이언트 기본값이 즉시 거부로 바뀝니다. 이것이 이 페이지에서 위의 api_style = "openai" 설정을 보여 주는 이유입니다.

Claude Code 측에서도 사용자 지정 기본 URL은 기본값을 변경하며, Anthropic은 어떤 항목이 변경되는지 문서화합니다. 토큰 수 계산이 가장 명확한 예입니다. /v1/messages/count_tokens는 선택 사항이며, "이 값이 없으면 Claude Code는 컨텍스트 사용량을 문자 기반으로 추정합니다". 따라서 /context는 이를 제공하지 않는 모든 게이트웨이에 대해 근사치를 표시하며, Kunavo는 이를 제공하지 않습니다. 사용자 지정 기본 URL에서는 세밀한 도구 스트리밍이 기본적으로 꺼집니다. CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1를 설정하지 않으면 게이트웨이 모델 검색도 꺼지며, id에 "claude" 또는 "anthropic"이 포함되지 않은 항목은 모두 제외합니다. 빠른 모드 가용성 확인과 WebFetch 도메인 안전성 확인은 여전히 api.anthropic.com를 직접 호출하며 게이트웨이 로그에는 나타나지 않습니다. 또한 ANTHROPIC_DEFAULT_*_MODEL_SUPPORTED_CAPABILITIES 변수는 "ANTHROPIC_BASE_URL 게이트웨이 뒤에서는 아무런 효과가 없습니다".

2026년 9월 24일 자체 소스에서 확인한 Kunavo 고유의 경계는 두 가지입니다. Messages 엔드포인트는 slug가 claude-로 시작하는 모델만 제공하므로 Vibe의 "anthropic" api_style로는 이를 통해 다른 모델에 접근할 수 없습니다. 또한 Vibe의 Anthropic 어댑터가 항상 보내는 네 가지 anthropic-beta 값 중 이 경로는 interleaved-thinking-2025-05-14와 fine-grained-tool-streaming-2025-05-14를 업스트림으로 전달하고, prompt-caching-2024-07-31와 context-1m-2025-08-07는 요청을 거부하지 않고 삭제합니다. cache_control 마커를 포함한 JSON 본문은 전송된 그대로 디스패처에 전달되며, 이것이 특정 모델에서 캐시 적중을 발생시키는지는 이 페이지에서 측정하지 않았습니다. 프롬프트 캐싱에서는 이를 지원하는 경로에서 요율이 어떻게 적용되는지 설명합니다.

한 세션의 토큰 비용 예시

이는 토큰 산술이며, 측정된 작업 비용이나 청구 상한이 아닙니다. 한 세션에서 캐시되지 않은 입력 토큰 200,000개를 보내고 출력 토큰 12,000개를 받는다고 가정하세요. 첫 번째 행은 비교를 위해 Vibe CLI의 기본 모델에 대한 Mistral의 자체 공개 요율을 보여 줍니다. Kunavo는 Mistral 모델을 판매하지 않습니다. 나머지 행은 토큰 100만 개당 현재 Kunavo 카탈로그 요율입니다.

Mistral의 수치는 API 가격표에서 가져왔으며, Vibe에 포함된 자체 설정도 기본 모델에 대해 동일한 두 숫자를 선언합니다. 리터럴 id mistral-vibe-cli-latest는 어떤 Mistral 가격표에도 나타나지 않으며, 적어도 하나의 타사 계산기는 이 id에 대해 다른 요율을 제시합니다. 따라서 정직하게 인용해야 할 것은 해당 id의 가격이 아니라 Mistral Medium 3.5의 공개 요율입니다.

Kunavo 측에서는 각 Claude 행의 요금을 Anthropic의 정가와 개별적으로 비교합니다. Claude Sonnet 4.6의 요금은 $2.10 / $10.50이며, 공식 참조 요율은 $3.00 / $15.00입니다(정가보다 약 30% 저렴). Claude Sonnet 5의 요금은 $1.40 / $7.00이며, 공식 참조 요율은 $2.00 / $10.00입니다(정가보다 약 30% 저렴). Kunavo의 카탈로그 금액은 상한이 아니라 청구 하한입니다. 업스트림이 요금을 보고하면 청구액은 카탈로그 비용과 업스트림 비용에 적용되는 마크업을 곱한 금액 중 더 큰 금액입니다. 캐시 요금과 외부 도구 비용은 이 예시에 포함되지 않습니다. 최소 충전액은 선불 크레딧 $10이며, 이는 요금제를 구매하는 것이 아니라 잔액을 충전하는 금액입니다. 청구 세부 정보를 참조하세요.

추측 없이 사용해 보기

동일한 제한된 작업을 두 번 실행하세요. 한 파일 수정, 버그 하나, 여러 파일에 걸친 조사처럼 범위를 정한 작업을 각 클라이언트에서 한 번씩 실행한 다음, 계정에 실제로 기록된 비용을 확인하세요. 이렇게 하면 요금제 표로는 답할 수 없는 질문, 즉 공개된 더 저렴한 요율이 실제 작업도 완료했는지에 답할 수 있습니다. 두 설정 모두 Kunavo에서 런타임 테스트를 거치지 않았으므로 시도하는 동안 작동하는 경로를 하나 확보해 두세요. Claude Code 측은 Claude Code 통합 가이드에서 시작하고, 키에 자금을 충전할 준비가 되면 Kunavo 계정을 생성하세요.

같은 기준으로 다른 터미널 에이전트도 비교하시나요? OpenCode와 Claude Code 및 Gemini CLI와 Claude Code는 무료 바이너리와 사용량에 따른 API 요금이 동일하게 나뉘는 두 클라이언트를 더 비교하고, 구독 없이 Claude Code 사용하기에서는 인증 정보 경로를 자세히 다룹니다.

자주 묻는 질문

2026년 9월 19일 확인: mistral-vibe 및 해당 하네스 종속성의 GitHub 및 PyPI API, v2.25.5 소스·변경 로그·README, docs.mistral.ai의 CLI 구성 페이지, mistral.ai/pricing, mistral.ai/pricing/api, Mistral Medium 3.5 발표문 및 Vibe 이름 변경에 관한 Mistral 도움말 센터 문서, @anthropic-ai/claude-code의 npm 레지스트리 항목, code.claude.com의 설정·권한 모드·게이트웨이·게이트웨이 호환성 페이지를 확인했습니다. Kunavo 자체 엔드포인트 동작은 같은 날 소스에서 확인했습니다. 어느 클라이언트도 설치하지 않았고 Kunavo를 대상으로 실행하지 않았으므로, 이 내용은 호환성 테스트가 아니며 모든 달러 금액은 측정된 작업 비용이 아니라 예시적인 토큰 산술입니다.