흙수저를 위한 Claude Code, Claude Code Router!
https://github.com/musistudio/claude-code-router
기본적으로 Claude Code 는 유료다. 아무튼 유료다. 최소 월 20은 내야 하지. 근데 난 쓰고 있다.
여기서 자금 문제로 바이브 코딩에 기회를 박탈당했다고 생각하는 사람들이 있다면, 그 생각을 고쳐먹기 바란다.
내가 이전에 흙수저를 위한 AI 코딩글 올렸는데, 이번엔 좀 최신 뉴스다.
찾아보면 기회는 있다. 그 기회를 잡는 것 네들 몫이고.
좋아. 본론으로 들어가 보자.
Claude Code
올해 바이브 코딩에서 핫하고 핫하던 그 주제가 아니던가. CLI 방식으로 컴퓨터에서 할 수 있는 것들을 AI로 할 수 있다는 거지.
명령어도 생성해줘. 파일도 생성해줘. 코드도 짜줘... 이만한 도구가 있을까 하는 바이브 코딩 신봉자들 널리고 널렸다.
하지만 공짜는 아니지. 물론 Gemini CLI 쓰면 제미나이를 통해 개인 무료로 쓸 수 있기는 하다만은...
그래도 인지도 있고 생태계 풍부한 이 도구를 공짜로 쓸 기회가 왔다는 것!
Claude Code Router
바로 Claude Code Router 되시겠다.
사실 Claude Code 에 API 통신을 가로채는 시도는 몇몇 있어왔다. 아무래도 자바스크립트로 만들어진 도구다 보니, 그리고 MCP를 위시해 확장성도 고려하다보니, OpenAI 기반 API나 Gemini API 등으로 변경하는 프로젝트도 몇몇 있었던 상황.
근데 Claude Code Router는 이를 매우 편하게 지원해주는 도구다. 사용자는 모델만 설정하면 끝이다. 이 얼마나 간단한가!
중국인이 만들었지만, 소스도 투명하게 공개하고 있고, MIT 라이선스로 자유롭다.
어떻게 설치하냐고? 이제 설명하겠다.
Node.js 18 이상 설치
설명하기 귀찮다. 공식 사이트 가서 받든가, 제공하는 OS의 패키지 매니저로 설치하든가, 아니면 nvm 이나 fnm 등의 버전 관리형으로 설치하든가 알아서들 설치해라.
Claude Code 설치
본체인 Claude Code가 설치되어 있어야 한다.
npm install -g @anthropic-ai/claude-code그리고 claude 명령어를 실행하여 설정 파일 생성하게 유도하고, 깔끔하게 ctrl+C 따블로 쳐서 손으로 입 싹 닫으면 된다.
Claude Code Router 설치
그다음, 오늘의 주인공을 설치해준다.
npm install -g @musistudio/claude-code-router그리고 ccr 명령어 쳤을 때 안내 문구가 나오면 준비 끝.
세팅하기
그 전에 AI 모델을 세팅해야 한다. 공식 안내에 따라 ~/.claude-code-router/config.json 파일을 편집해서 준비를 먼저 해야 한다.
근데 귀찮지? 나도 그래. 근데 제작자가 친히 웹 기반의 설정 인터페이스를 만들어 줬다. 감사하면서 실행하자.
ccr ui실행하면 웹 브라우저가 뜰 것이며, WSL이나 콘솔만 있는 환경에서 실행했을 경우 브라우저가 당연히 없으니 오류가 뜨겠지만, 주소 복사해서 알아서 IP 잘 알아내서 접속하면 접속 잘만 된다.
이제 너는 Add Provider 버튼을 눌러 아래 창을 띄우면 된다.
여기서 우리는 AI API를 무료로도 제공하는 OpenRouter를 쓸 것이다. 계정 당장 만들고! API Key 생성해서 준비하라! 준비는 각자 알아서.
어쨌든 템플릿에서 OpenRouter 선택, 발급받은 API Key 입력한 다음, 모델을 선택할 건데,
나는 이 두개의 모델을 선택했다.
openrouter/horizon-beta: ChatGPT 5 베타로 알려진 모델. 내가 글 쓴 당시에 있으며, 나중에 없어질 수 있다.qwen/qwen3-coder:free: Qwen3 제작진이 내놓은 고성능 코딩 전문 모델
템플릿에 입력된 기존 모델들은 당연히 유료니, 지우고 위 2개를 입력하면 된다.
나머진 만질 것 없고 Save 눌러 저장하면 된다.
그다음,
우측 Router 에 Default 와 Background 에서 알아서 적절한 모델 선택한 다음, 우측 상단 Save and Restart 누르면 세팅 끝!
실행하기
실행하는 방법은 2가지가 있다.
- 서비스를 시작하여 claude code 인젝션 모드 활성화 후 클로드 코드 실행하기
ccr start
claude- 별도의 명령어로 클로드 코드 바로 실행(기존 클로드 코드 사용 중인 사용자에게 권장)
ccr code편한 걸로 실행하면,
나머지 사용법은 Claude Code와 똑같다. MCP도 Claude Code 세팅대로 추가 관리하면 된다. 간단하다.
마치며
왜? 끝이야. 허무해? 나머진 Claude Code와 똑같으니 나머지 사용법은 Claude Code 검색하면 여기도 좌르르 나올거야.
누가 인내를 달라고 기도하면, 신은 그 사람에게 인내심을 줄까요? 아니면 인내를 발휘할 수 있는 기회를 주시려 할까요?
용기를 달라고 하면,용기를 주실까요? 아니면 용기를 발휘할 기회를 주실까요?
만일 누군가 가족이 좀 더 가까워지게 해 달라고 기도하면, 하느님이 뿅하고 묘한 감정이 느껴지도록 할까요?아니면 서로 사랑할 수 있는 기회를 마련해 주실까요?
-- 에반 올 마이티
돈없다고 찔찔대지 마라. 나도 돈없어서 찔찔댄 적 많지만 결국엔 이것저것 해냈다. 물론 컴퓨터는 찔찔하지만.
아무렴 어떤가. 기회의 땅 미국답게 무료로 호출 제약이 유료보단 심하지만, 그래도 어느정도 바이브 코딩의 기회를 주셨다.
그러니 이런 기회를 착실히 이용하여, 뒤쳐지지 않는 AI 시대의 개발자가 되도록 하자.
끗.
