클로드 코드 라우터 — 요청을 다른 모델로 돌리는 로컬 관문

클로드 코드를 쓰면서 뒤에 붙는 모델만 바꾸고 싶을 때가 있습니다. 더 싼 모델로, 혹은 내 컴퓨터에서 도는 모델로. 그 사이에 끼우는 관문이 있습니다.

클로드 코드 라우터는 코딩 도구의 요청을 내가 고른 공급자와 모델로 돌려 주는 로컬 모델 관문입니다. 클로드 코드를 비롯한 여러 코딩 도구에 하나의 안정적인 로컬 주소를 주고, 그 뒤의 공급자·모델·계정·라우팅 규칙을 한곳에서 관리하게 합니다. 쉽게 말해, 작업 방식은 그대로 두고 뒤에서 도는 모델만 갈아 끼우는 장치입니다. 비싼 모델은 어려운 작업에만 쓰고 단순한 작업은 값싼 모델로 돌리거나, 인터넷이 없을 때는 내 컴퓨터 모델로 넘기는 식의 운용이 한 앱에서 가능해집니다. 공식 저장소를 기준으로 무엇을 할 수 있는지 정리했습니다.

짧게 정리하면

• 여러 코딩 도구에 하나의 로컬 주소를 주고, 뒤의 공급자·모델을 한곳에서 바꿔 가며 씁니다.
• 딥시크·오픈라우터·제미나이·문샷·미스트랄 등과 로컬 모델까지, 여러 공급자를 붙일 수 있습니다.
• 요청이 실패하면 다른 모델로 넘기고, 요청 기록·지연·토큰·비용 추정을 한눈에 봅니다.

클로드 코드 라우터 공식 저장소(읽은 시점 3.1 버전대)를 기준으로 했습니다. 직접 붙여 써 보지는 않았고, 저장소에 적힌 기능 설명을 옮겼습니다.

무엇을 해 주나

핵심은 「관문」이라는 점입니다. 코딩 도구는 라우터가 열어 둔 로컬 주소 하나만 바라보고, 그 뒤에서 어떤 공급자·모델로 보낼지는 라우터가 정합니다. 그래서 도구마다 따로 모델 설정을 만들 필요 없이 한곳에서 관리할 수 있고, 공급자나 모델을 바꿔도 작업 흐름이나 설정 파일을 매번 고치지 않아도 됩니다. 여러 도구를 오가며 쓰는 사람이라면, 도구마다 흩어져 있던 키와 모델 설정을 한 앱으로 모으는 것만으로도 관리가 한결 단순해집니다. 거기에 더해 응답을 다루는 기능도 붙습니다. 이미지 이해나 웹 검색, 모델 컨텍스트 프로토콜 도구 같은 기능을 기존 모델에 얹어, 원래 모델이 못 하던 일을 거들게 할 수 있다고 저장소는 설명합니다. 클로드 코드 설정을 어떻게 겹쳐 두는지는 설정 합치기 글에 정리해 뒀습니다.

공식 저장소 기준, 주요 기능

기능	내용
한곳 관리	여러 도구·공급자를 한 앱에서 관리. 도구별 설정 중복 제거
모델 교체	작업 흐름·설정 파일을 안 바꾸고 공급자·모델 전환
끊김 방지	재시도, 키 묶음·순환, 순서가 정해진 대체 모델
관측	요청 기록·실제 경로·지연·토큰·비용 추정·계정 상태

어떤 모델을 붙이나

붙일 수 있는 공급자가 넓습니다. 공식 저장소는 오픈AI, 앤트로픽, 제미나이, 오픈라우터, 딥시크, 문샷, 미스트랄을 비롯한 여러 공급자와 직접 맞춘 호환 공급자를 지원한다고 적었습니다. 값싼 오픈 모델로 돌리고 싶다면 오픈라우터나 딥시크를 붙이면 되고, 두 가지를 어떻게 쓰는지는 오픈라우터 글과 딥시크 무료 이용 글에 정리돼 있습니다. 설치는 운영체제별 데스크톱 앱을 받아 실행한 뒤, 공급자를 더하고 키를 넣고 서버를 켜면 됩니다. 그러면 내 컴퓨터 안 로컬 주소(기본 포트 3456번)로 관문이 열리고, 클로드 코드 같은 도구를 그 주소에 맞추면 됩니다. 설정이 명령줄 편집이 아니라 앱 화면에서 공급자를 고르고 모델을 선택하는 방식이라, 처음 붙일 때 문턱이 낮은 편입니다. 다만 정확한 설치·연결 절차는 버전마다 바뀔 수 있으니 공식 저장소의 안내를 따르는 편이 안전합니다.

값은 어떻게 되나

공식 저장소 기준, 비용 구조

항목	내용
라우터 자체	오픈소스로 공개. 내 컴퓨터에서 돌리는 관문
모델 비용	붙인 공급자의 요금을 그대로 냄. 공급자마다 다름
로컬 모델	내 컴퓨터에서 도는 모델을 붙이면 호출 요금은 들지 않음
비용 확인	요청별 토큰·비용 추정을 대시보드에서 확인

라우터가 공짜라고 전부 공짜는 아닙니다. 라우터 자체는 오픈소스로 무료지만, 뒤에 붙인 공급자의 모델을 부르면 그 공급자의 요금이 나갑니다. 값을 아끼려고 붙였다가 비싼 모델로 라우팅해 두면 오히려 더 나갈 수 있으니, 어떤 작업을 어느 모델로 보낼지 규칙부터 정해 두세요. 또 여러 공급자의 키를 한 앱에 모아 두는 구조라, 키 관리와 접근 권한에도 신경 써야 합니다. 로컬 모델을 섞으면 호출 요금 없이 쓰는 구간을 만들 수 있습니다.

자주 묻는 질문

클로드 코드만 되나요

아닙니다. 공식 저장소는 클로드 코드뿐 아니라 코덱스, 그록·키미 명령줄 도구, 오픈코드 등 여러 코딩 도구와 호환 클라이언트를 한곳에서 관리한다고 밝혔습니다. 도구마다 따로 모델 설정을 두지 않아도 되는 게 장점입니다.

정말 돈이 덜 드나요

라우터는 무료지만 모델 호출 비용은 붙인 공급자 요금을 따릅니다. 값싼 오픈 모델이나 로컬 모델로 돌리면 아낄 수 있지만, 비싼 모델로 라우팅하면 그대로 비용이 나갑니다. 대시보드의 비용 추정으로 실제 지출을 확인하는 편이 안전합니다.

모델이 하나 죽으면 어떻게 되나요

저장소는 재시도와 순서가 정해진 대체 모델을 지원한다고 적었습니다. 한 모델이 응답하지 않으면 미리 정해 둔 다음 모델로 넘겨 작업이 끊기지 않게 하려는 구조입니다. 키를 여러 개 묶어 돌려 쓰는 기능도 있습니다.

코딩 도구와 모델을 따로 떼어 생각하게 해 주는 도구입니다. 저라면 먼저 값싼 오픈 모델이나 로컬 모델을 붙여, 간단한 작업은 거기로 보내고 어려운 작업만 비싼 모델로 돌리는 규칙을 짜 보겠습니다. 구독과 종량제 중 무엇이 쌀지 가늠하는 법은 구독 대 종량제 글과 함께 보면 좋습니다. 다만 키를 한곳에 모으는 만큼 관리에 신경 쓰고, 라우팅 규칙을 잘못 짜면 오히려 비싸질 수 있다는 점만 유의하면, 같은 도구로 더 유연하게 모델을 골라 쓸 수 있습니다.

확인한 곳: 클로드 코드 라우터 공식 저장소(로컬 모델 관문, 여러 코딩 도구·공급자 한곳 관리, 재시도·키 순환·순서 대체 모델, 요청 기록·지연·토큰·비용 추정, 오픈AI·앤트로픽·제미나이·오픈라우터·딥시크·문샷·미스트랄 등 지원, 데스크톱 앱·기본 포트 3456번). 읽은 시점 3.1 버전대이며, 기능·공급자는 바뀔 수 있습니다.