Claude Code 라우터 + Gemini 2.5 Pro 무료 API: RIP Gemini CLI! 이게 바로 Gemini-CLI의 정석입니다

AICodeKing 구독자 71,200명

요약

이 영상에서는 Claude Code Router를 활용해 Claude Code를 Anthropic 모델이 아닌 원하는 모델(Gemini 2.5 Pro 등)로 라우팅하는 방법을 소개합니다. 백그라운드·씽크·일반·롱 컨텍스트 모델을 각각 설정해 다양한 작업에 최적화하고, 플러그인을 통해 추가 시스템 프롬프트를 적용하는 과정을 안내합니다. 무료로 하루에 1,500회 요청 가능한 Gemini 2.5 Pro API 활용법과 CLI 설치·실행 예제를 통해 실사용 예시를 시연하며, 기존 Gemini CLI의 한계를 해결한 강력한 대안임을 강조합니다.

주요 키워드

Claude Code Router Gemini 2.5 Pro 백그라운드 모델 씽크 모델 롱 컨텍스트 윈도우 플러그인 CLI Ninja Chat 무료 API Minesweeper 예제

하이라이트

🔑 Claude Code의 UI와 툴셋은 훌륭하지만 Anthropic 모델에만 묶이고 오픈소스가 아니라는 한계가 있다.
⚡️ Claude Code Router를 이용하면 로컬 모델(OpenRouter), Gemini, Mistral 등 모든 모델로 요청을 라우팅할 수 있다.
🌟 백그라운드 모델, 씽크 모델, 일반 모델, 롱 컨텍스트 모델 등 총 4가지 역할별 모델을 직접 설정해야 최적의 성능을 낸다.
📌 Gemini 2.5 Pro는 API를 통해 하루 1,500회 무료 요청이 가능해 비용 부담 없이 ‘씽크’ 및 일반 모델로 활용하기 좋다.
🚀 플러그인을 사용하면 시스템 프롬프트를 보강해 DeepSeek 등 특정 모델에서 발생하는 오류를 최소화할 수 있다.
🔧 CLI 설치·설정 과정은 간단하다. 단일 명령어로 설치 후 CC start·CCR code만 실행하면 바로 사용할 수 있다.
🎮 간단한 Minesweeper HTML/CSS/JS 생성 예제로 실제 작동 과정을 시연, Gemini 라우팅이 Claude Code와 동일한 경험을 제공함을 검증했다.
🌐 GitHub Actions CI 워크플로우 등 개발 환경에도 통합 가능해 범용성이 매우 높다.

용어 설명

Claude Code

Anthropic에서 제공하는 코드 생성·분석 특화 AI 서비스로, UI와 툴이 강력하지만 Anthropic 모델에만 종속된다.

Claude Code Router

Claude Code 요청을 사용자가 지정한 다양한 모델(로컬, Gemini, Mistral 등)로 라우팅해주는 오픈 소스 툴.

백그라운드 모델

로딩 메시지용 시(haiku) 생성, 대화 요약, 명령어 처리 등의 단순 작업을 담당하는 보조 모델.

씽크 모델 (Think Model)

추론·고도화된 처리가 필요할 때 동작하는 모델로, 요청 시 ‘think’ 플래그를 통해 활성화된다.

롱 컨텍스트 윈도우

긴 대화나 코드 블록 등을 한 번에 처리할 수 있도록 컨텍스트(문맥)를 확장 지원하는 모델 기능.

플러그인

Claude Code Router 요청에 추가 시스템 프롬프트 등을 삽입해 특정 모델에서 성능을 보강하는 모듈.

CLI(Command-Line Interface)

터미널(명령창)에서 입력 명령으로 툴을 제어하는 인터페이스 방식.

인트로 뮤직·인사 후 Claude Code의 장점(UI, 툴셋)과 함께 Anthropic 모델 종속·비싼 요금·오픈소스 부재라는 주요 제약을 설명한다.

[00:00] Claude Code가 최근 인기를 끌고 있지만, Anthropic 모델에만 제한되어 있고 비싸며 오픈소스가 아니라는 문제점이 있다고 소개합니다.

[01:11] Claude Code Router라는 새로운 도구를 소개하며, 이 도구가 Claude Code를 다양한 모델(로컬, Gemini, Mistral, DeepSeek 등)과 연결할 수 있게 해준다고 설명합니다.

Claude Code Router의 개념과 용도를 제시한다. Claude Code 요청을 로컬 모델, Gemini, Mistral, DeepSeek 등 원하는 모델로 라우팅할 수 있음을 강조한다.

타임라인 정보가 없습니다.

백그라운드·씽크·일반·롱 컨텍스트 등 총 4가지 모델 역할을 설정하는 과정을 안내한다. Gemini 2.0 Flash(백그라운드), Gemini 2.5 Pro(씽크·일반·롱 컨텍스트)를 추천하며 무료 API 한도를 소개한다.

[01:41] Claude Code가 실제로는 4개의 다른 모델을 사용한다고 설명하며, 각각의 역할을 설명합니다: 백그라운드 모델(로딩 메시지, 대화 요약, 명령 처리), Think 모델(추론), 일반 모델, 긴 컨텍스트 모델.

[02:28] Gemini 2.5 Pro 모델을 추천하며, 이 모델이 현재 API에서 무료로 사용 가능하고 하루 1,500개 요청을 제공한다고 설명합니다. 또한 플러그인 기능에 대해서도 언급합니다.

플러그인을 통해 DeepSeek 같은 모델의 요청을 보강하는 방법을 설명한다. 이어서 Ninja Chat 플랫폼 광고를 통해 다양한 AI 모델 비교, 마인드맵 생성기, 요금제 할인 코드 등을 안내한다.

[03:38] Ninja Chat을 소개하며, 월 11달러로 GPT-4, Claude 3.5 Sonnet, Gemini 2.0 Flash 등 최고의 AI 모델들을 한 곳에서 사용할 수 있는 올인원 플랫폼임을 설명합니다. AI 플레이그라운드에서 모델 비교 기능과 마인드맵 생성 기능의 유용성을 강조하며, 할인 코드를 제공합니다.

Claude Code Router 설치(단일 명령) 후 CC start 명령으로 라우터 실행, 최초 모델 설정 과정을 설명한다. config 파일에 원하는 API 키·모델 엔드포인트를 입력해 커스터마이징하는 방법을 제시한다.

[04:30] Claude Code Router 설치 및 설정 방법을 안내합니다. cc start 명령어로 라우터를 시작하고, 처음 실행시 원하는 모델을 선택하는 과정을 설명합니다. Gemini 베이스 URL, API 키, 모델명만 입력하면 간단히 설정할 수 있으며, 각 기능마다 다른 모델을 설정하는 것도 가능합니다.

CCR code 명령어로 Claude Code를 Gemini 모델로 라우팅해 실행하는 과정을 시연한다. 무료 티어의 응답 지연 현상과 유료 모델 사용 시 성능 개선을 언급한다.

[05:23] CCR code 명령어로 Claude code를 실행하여 Gemini 모델을 사용하는 방법을 시연합니다. 기본적으로 Claude와 동일하게 작동하며 매끄럽게 실행됩니다. 무료 티어 사용시 약간의 지연이 있을 수 있지만, 유료 모델에서는 더 부드럽게 작동한다고 설명합니다.

HTML/CSS/JS로 마인스위퍼 게임 생성 요청을 통해 라우팅된 Gemini 모델의 코드 생성 능력을 테스트한다. Claude Code와 거의 동일한 결과 및 긴 컨텍스트 처리 우수성을 보여준다.

[06:05] HTML, CSS, JS를 사용한 지뢰찾기 게임 제작을 요청하여 실제 테스트를 시연합니다. Gemini의 긴 컨텍스트 윈도우 덕분에 Claude만큼 또는 더 잘 작동한다고 평가하며, MCP와 모든 도구들이 훌륭하게 작동함을 확인합니다.

전체적인 동작 안정성, 도구 호환성(MCPS, Diff editing), 가끔 발생하는 오류와 플러그인으로 해결 가능한 점을 평가한다. Github Actions CI 통합 가능성을 언급하며 유연성을 칭찬한다.

[07:06] 가끔 diff 편집에서 오류가 발생할 수 있지만 매우 드물며, 플러그인 옵션으로 해결 가능하다고 설명합니다. GitHub Actions 등과 함께 설정할 수 있으며, Claude code가 오픈소스가 아닌 점은 아쉽지만 사용자가 원하는 모델을 선택할 수 있게 해주는 것이 장점입니다.

오픈소스가 아닌 Claude Code의 한계를 Claude Code Router가 효과적으로 해소함을 재강조한다. 시청자 의견 요청, 구독·후원 안내와 함께 다음 영상 예고 후 인사로 마무리한다.

타임라인 정보가 없습니다.

[00:00] [음악]

[00:03] [박수]

[00:04] 안녕하세요, 새로운 영상에 오신 것을 환영합니다. 최근 Claude

[00:09] Code가 화제가 되고 있죠. 사람들이

[00:11] 많이 사용하고 있고, 특히

[00:14] $200이나 $100 요금제와 함께 사용할 때

[00:16] 무제한에 가깝게 사용할 수 있어서 매우 유용하지만

[00:20] API를 통해서도 사용할 수 있습니다.

[00:23] Claude Code의 주요 장점은

[00:26] UI가 좋다는 것입니다. 프롬프트가 잘 구성되어 있고

[00:29] 사용하는 도구들도 꽤 좋습니다.

[00:32] 하지만 Claude Code의 주요 문제는

[00:35] Anthropic 모델에만 제한되어 있다는 것입니다.

[00:37] 즉, Claude 모델만 사용할 수 있고

[00:40] 그중에서도 저렴한 것은 없습니다.

[00:43] 게다가 오픈소스도 아니어서

[00:45] Gemini CLI나 Codeex CLI 같은

[00:48] 대안을 사용해야 하는데, 이들은 그만큼

[00:51] 잘 만들어지지 않았습니다. 그리고 주변

[00:54] 생태계도 좋지 않습니다. 예를 들어

[00:57] 그래픽 인터페이스를 원한다면

[01:00] Claude는 그런 기능이 있지만

[01:04] Gemini CLI 같은 것과는 호환되지 않습니다.

[01:06] 하지만 이제 Claude Code Router로

[01:08] 바로 이런 일을 할 수 있는 옵션이 생겼습니다.

[01:11] Claude Code Router는 Claude Code 요청을

[01:14] 다른 모델들로 라우팅하는 도구입니다.

[01:17] 그리고 모든 요청을 커스터마이징할 수 있습니다. 네,

[01:20] 기본적으로 Claude Code를 여러분이 가진

[01:23] 어떤 모델과도 연결할 수 있게 해줍니다.

[01:26] OLLAMA를 통한 로컬 모델이든, Gemini 모델이든

[01:29] Mistral이나 DeepSeek 같은 것들도

[01:32] 모두 가능합니다.

[01:35] 이제 설정하는 것이 좀 까다로울 수 있는데

[01:39] 실제로 약 4개의 모델을 설정해야 하기 때문입니다.

[01:41] 네, 실제로 Claude Code는 하나의 모델을 사용하지 않습니다.

[01:44] 다양한 용도로 여러 모델을 사용하며

[01:46] 이를 사용하려면 각각을 설정해야 합니다.

[01:50] 백그라운드 모델이 필요한데, 이는 주로

[01:54] 로딩 메시지용 하이쿠 생성,

[01:56] 대화 요약, 명령 처리 등의

[01:58] 작업을 수행합니다. 복잡한 작업은

[02:00] 하지 않습니다.

[02:03] 따라서 로컬에서 실행되는 매우 작은

[02:05] 모델을 사용하거나 OpenRouter의

[02:08] 무료 모델을 사용할 수 있습니다.

[02:11] 이를 위해 Gemini 2.0

[02:14] Flash 모델을 사용하는 것을 추천합니다.

[02:16] 그다음에는 Think 모델이 있는데

[02:18] 이는 기본적으로 추론 모델입니다.

[02:22] Claude Code에게 생각하라고 요청할 때

[02:25] 활성화됩니다.

[02:28] 저는 이를 위해 Gemini 2.5 Pro를 사용하고

[02:30] 일반 모델 옵션에서도 같은 모델을 사용합니다.

[02:32] 그 이유는 이 모델이 정말 좋고

[02:35] 이제 API에서도 무료로 사용할 수 있기 때문입니다.

[02:38] 네, 이제 하루에 약 1,500개의 요청을

[02:42] 무료로 제공하는데 이는 정말 멋집니다.

[02:45] 그리고 이 API를 생각 예산과 함께

[02:48] 무료로 사용할 수 있어서 정말 좋습니다.

[02:52] 긴 컨텍스트 모델의 경우에도

[02:55] 같은 모델을 사용하고, 모델

[02:58] 옵션에서도 같은 모델을 사용합니다. 이것이

[03:01] 모델 설정에 관한 내용입니다.

[03:03] 또 다른 기능으로는

[03:05] 플러그인이 있습니다.

[03:08] 플러그인은 기본적으로 요청을 수정하여

[03:11] 모델이 잘 작동하도록 더 많은 시스템 프롬프트를

[03:15] 추가하는 등의 역할을 합니다. 예를 들어

[03:18] 이 플러그인은 DeepSeek 모델과 잘 작동합니다.

[03:21] 어쨌든, 이제 실제로 어떻게 사용할 수 있는지

[03:24] 보여드리겠습니다.

[03:38] 하지만 그 전에 먼저 Ninja에 대해 소개해드릴게요.

[03:42] Ninja Chat은 월 11달러로

[03:45] GPT-4, Claude 3.5 Sonnet,

[03:48] Gemini 2.0 Flash 같은 최고의 AI 모델들에

[03:51] 한 곳에서 접근할 수 있는 올인원 AI 플랫폼입니다.

[03:54] 저는 빠른 연구를 위해 Gemini를 사용해왔는데,

[03:56] 정말 멋진 기능은 AI 플레이그라운드입니다.

[03:58] 여기서는 다양한 모델들의 응답을

[04:00] 나란히 비교해볼 수 있거든요.

[04:02] 마인드맵 생성 기능은

[04:04] 복잡한 아이디어를 정리할 때 정말 혁신적입니다.

[04:06] 기본 요금제는 월 1,000개 메시지,

[04:09] 30개 이미지, 5개 비디오를 제공하며

[04:12] 더 높은 티어도 이용 가능합니다.

[04:14] 더 필요하시면 코드 king25로

[04:17] 모든 요금제에서 25% 할인받거나

[04:20] king40yearly로 연간 구독시

[04:23] 40% 할인받으실 수 있습니다.

[04:26] 설명란의 링크를 확인해보세요. 이제 다시 비디오로 돌아가겠습니다.

[04:30] 사용법은 간단합니다. 먼저

[04:32] 이 명령어로 Claude Code Router를 설치하면

[04:35] 바로 사용할 수 있습니다.

[04:37] 먼저 cc start 명령어로

[04:40] claude router를 실행해야 하는데,

[04:43] 이때 라우터가 시작됩니다.

[04:46] 처음 실행시에는 사용하고 싶은

[04:48] 모델을 선택하라고 물어봅니다.

[04:52] 여기서 설정한 모델이

[04:54] 모든 곳에서 메인 모델로 사용됩니다.

[04:57] 하지만 설정에서 각기 다른 기능에

[04:59] 다른 모델을 설정할 수도 있습니다.

[05:01] 앞서 말씀드린 것처럼,

[05:04] 간단히 Gemini 베이스 URL과

[05:06] API 키, 모델명만 입력하면 바로 사용할 수 있습니다.

[05:11] 원한다면 설정을 변경해서

[05:13] 각 기능마다 다른 모델을 사용하도록

[05:16] 할 수도 있고, 그것도 괜찮습니다.

[05:18] 어쨌든 이게 설정이고 이제 사용해볼 수 있습니다.

[05:23] 사용하려면 CCR code 명령어를 실행하면

[05:26] 라우터와 함께 Claude code가 즉시 시작됩니다.

[05:29] 이제 Gemini 모델을 사용하고 있는데

[05:32] 나머지는 모든 것이 동일하게 유지됩니다.

[05:34] 참고로 말씀드리면, 정말 매끄럽게 작동합니다.

[05:37] 만약 응답을 받는 데

[05:40] 약간의 지연이 있다면,

[05:41] 그건 Gemini의 무료 티어가

[05:43] 때때로 느리기 때문이고,

[05:46] 그래서 느려질 수 있지만

[05:49] 유료 모델을 사용하면

[05:52] 훨씬 더 부드럽게 작동할 것입니다.

[05:55] 어쨌든 여기서 안녕하세요 메시지를 보내면

[05:59] 여기서 진행되는 것을 볼 수 있고

[06:01] 잠시 후 메시지가 돌아올 것입니다.

[06:04] 어쨌든 이제 한번 사용해보겠습니다.

[06:05] HTML, CSS, JS를 사용해서

[06:09] 지뢰찾기 게임을 만들어달라고

[06:10] 요청해보겠습니다. 이건 간단한 예제인데 여기서 테스트용으로 보여드리는 것입니다.

[06:16] 여러 작업으로 테스트해봤는데

[06:18] 적어도 Gemini에서는

[06:20] 긴 컨텍스트 윈도우 덕분에

[06:23] 더 좋지는 않더라도 잘 작동한다고

[06:25] 말할 수 있습니다.

[06:28] 어쨌든 계속 진행해서 작업을 시작할 것입니다.

[06:32] Claude처럼 작동하는 것을 볼 수 있는데

[06:35] 모델 차이만 있을 뿐

[06:37] 다른 것은 전혀 없습니다.

[06:40] Gemini에서 이게 얼마나 잘 작동하는지

[06:42] 정말 재미있습니다.

[06:45] 일반적인 Claude code를 사용하는 것 같고

[06:47] 도구들과 모든 것이 잘 작동합니다.

[06:50] MCP와 모든 것이 함께

[06:52] 정말 훌륭하게 작동합니다.

[06:55] 잠시 후 완료되면서 정말 훌륭하게 모든 것을 해냈습니다.

[06:59] 오류도 전혀 표시하지 않습니다.

[07:02] 때때로 부적절하게

[07:04] 동작할 수는 있습니다.

[07:06] diff 편집에서 오류를 줄 수도 있지만

[07:08] 그건 매우 드문 경우이고

[07:09] 이 도구가 제공하는

[07:12] 플러그인 옵션으로

[07:15] 언제든지 해결할 수 있습니다.

[07:17] 정말 마음에 들고 실제로 좋고 유용합니다.

[07:21] GitHub Actions for CI 워크플로우나

[07:24] 그런 것들과 함께 사용하도록

[07:26] 설정할 수도 있습니다.

[07:29] 저는 실제로 Claude code를 좋아하지만

[07:32] 오픈소스가 아닌 것이 아쉽고

[07:35] 이것도 그 문제를 해결해주지는 않습니다.

[07:38] 하지만 적어도 사용자들이

[07:41] 원하는 모델을 사용할 수 있는

[07:43] 위치에 놓아줍니다.

[07:46] 정말 좋고 많은 문제 없이 잘 작동하는데,

[07:49] 이런 일은 많은 대안들에서

[07:50] 발생하는 문제이지만

[07:53] 이것은 최고이고 실제로 잘 작동합니다.

[07:57] 전반적으로 정말 멋집니다.

[07:59] 어쨌든 아래에 생각을 공유해주시고

[08:01] 채널을 구독해주세요.

[08:04] 슈퍼 땡스 옵션으로 후원하거나

[08:06] 채널에 가입해서 혜택도 받으실 수 있습니다.

[08:08] 다음 영상에서 뵙겠습니다. 안녕히 계세요.

[08:10] [음악]