클로드 코드 한도가 차도 작업을 이어가는 법

클로드 코드 한도가 차도 작업을 이어가는 법

클로드 코드로 한창 작업하다가 한도 소진 안내를 받아보신 적 있을 겁니다. 아까운 건 요금이 아니라 그때 끊기는 흐름입니다. 리셋을 기다리는 동안 맥락이 식고, 다시 켰을 때는 하려던 걸 처음부터 다시 설명하게 됩니다.

여러 회사가 각자 무료로 열어둔 AI 모델이 이미 상당히 많습니다. 문제는 그것들이 전부 따로 논다는 점입니다. 회사마다 가입 절차가 다르고, 호출 방식이 다르고, 한도가 차는 시점도 제각각입니다. 하나씩 손으로 갈아 끼우는 건 현실적이지 않습니다.

FreeLLMAPI는 그 무료 한도들을 내 컴퓨터 안의 창구 하나로 모아 주는 프로그램입니다. 클로드 코드는 그 창구만 바라보게 되고, 쓰던 모델의 한도가 차면 다음 모델로 넘어갑니다.

tashfeenahmedfreellmapiRepository

2026년 10월 14일 기준 깃허브 스타 약 3.4만 개, MIT 라이선스, 최신 릴리스 v0.14.2입니다.

무엇을 대신해 주나

핵심은 세 가지입니다.

한도가 차면 다음 모델로 넘어갑니다. 호출이 거절되면 해당 모델을 잠시 쉬게 하고 다음 순위 모델로 재시도합니다. 모델별 분당·일일 한도를 기록해 두고 넘지 않도록 조절하기 때문에, 한도에 부딪힌 뒤에 대응하는 게 아니라 미리 피해 갑니다.

클로드 코드가 쓰는 말투를 그대로 받습니다. 이 프로그램은 앤트로픽 방식의 요청도 받아들이므로, 클로드 코드 입장에서는 평소와 똑같이 동작합니다. 커서, 코덱스, 클라인, 에이더처럼 다른 도구들도 같은 창구에 붙습니다.

모델이 바뀔 때 작업 내용을 넘겨줍니다. 새 모델은 자기가 남의 작업을 이어받는다는 사실을 모릅니다. 그래서 “지금까지 이런 작업 중이었고 다시 시작하지 말라”는 요약을 앞에 붙여 보냅니다. 다만 이 기능은 기본값이 꺼져 있습니다. 아래 설정에서 켜야 합니다.

설치

도커가 있다면 한 줄입니다.

curl -fsSL https://freellmapi.co/install.sh | bash

~/freellmapi 폴더를 만들고 암호화 키를 생성한 다음 컨테이너를 띄웁니다. 다시 실행해도 기존 설정은 보존됩니다.

도커를 깔기 부담스러우면 데스크톱 앱을 받는 방법도 있습니다.

tashfeenahmedfreellmapiRepository

맥은 .dmg, 윈도우는 Setup 이 붙은 .exe, 리눅스는 .AppImage가 릴리스마다 붙어 있습니다. 맥은 애플 실리콘이면 arm64, 인텔이면 x64를 받으시고 macOS 12 이상이 필요합니다. 앱 버전은 별도의 비밀번호 설정이 없습니다.

설치가 끝나면 http://localhost:3001이 열립니다.

판단: 여러 기기에서 쓰거나 라즈베리파이 같은 데 올려 두고 쓸 생각이면 도커, 노트북 한 대에서만 쓸 거면 앱이 편합니다.

무료 키는 직접 받아야 합니다

여기가 가장 많이 막히는 지점입니다. 이 프로그램은 무료 한도를 모아 줄 뿐 계정을 대신 만들어 주지는 않습니다. 각 회사에서 본인 명의로 키를 받아 Keys 화면에 넣어야 합니다.

제공처	키 발급
구글 AI 스튜디오	https://aistudio.google.com/apikey
Groq	https://console.groq.com/keys
Cerebras	https://cloud.cerebras.ai
OpenRouter	https://openrouter.ai/keys
허깅페이스	https://huggingface.co/settings/tokens
엔비디아	https://build.nvidia.com

하나만 넣어도 동작합니다. 여러 개 넣을수록 한도가 겹겹이 쌓여 오래 버팁니다. 어떤 모델이 어떤 제한으로 열려 있는지는 공식 목록에서 확인할 수 있습니다.

https://freellmapi.co/models

함정: 회사마다 무료 이용 약관이 다릅니다. 개인이 혼자 쓰는 용도까지만 허용하는 곳도 있고, 평가 목적으로만 열어둔 곳도 있습니다. 키를 넣기 전에 해당 회사의 조건을 한 번 읽어 보시는 게 안전합니다.

클로드 코드에 연결

Keys 화면 상단의 통합 키를 복사한 뒤 터미널에서 실행합니다.

npx freellmapi setup-claude --url http://localhost:3001 --api-key <복사한 키>

먼저 --dry-run을 붙이면 어떤 파일이 어떻게 바뀌는지만 보여주고 실제로는 손대지 않습니다. 확인한 뒤 빼고 다시 실행하면 됩니다. 실행 시 기존 설정은 시각이 찍힌 백업으로 남기고 병합하므로, 쓰던 설정이 지워지지는 않습니다.

설정 파일에 키를 남기고 싶지 않다면 실행할 때만 주입하는 방법도 있습니다.

npx freellmapi launch

다른 도구도 같은 방식입니다. 지원 목록은 npx freellmapi list로 볼 수 있습니다.

함정: 클로드 코드는 주소 뒤에 /v1을 붙이지 않습니다. 반대로 코덱스나 클라인 같은 도구는 /v1이 필요합니다. 직접 설정을 만질 때 이걸 헷갈리면 연결이 안 됩니다. 위 명령을 쓰면 알아서 맞춰 줍니다.

작업 내용 인계 켜기

설치 폴더의 .env 파일에 한 줄을 추가하고 다시 시작합니다.

FREELLMAPI_CONTEXT_HANDOFF=on_model_switch

대화 기록은 메모리에만 3시간 보관되고 디스크에 저장되거나 기록으로 남지 않습니다. 모델이 실제로 바뀌는 순간에만 붙고, 같은 모델로 이어질 때는 아무것도 추가하지 않습니다.

함정: 이건 만능 복구가 아닙니다. 이 창구를 거쳐 간 대화만 이어 줄 수 있고, 모델 내부에만 있던 상태까지 되살리지는 못합니다. 긴 작업 중간에 모델이 바뀌면 품질이 달라지는 건 감수해야 합니다.

무엇을 기대하면 안 되나

무료 한도를 모아 쓰는 구조라 한계가 분명합니다. 제작자도 문서에 솔직하게 적어 뒀습니다.

하루가 지날수록 품질이 떨어집니다. 성능이 좋은 모델일수록 일일 한도가 작습니다. 그게 소진되면 더 작은 모델로 내려가므로, 늦은 시간일수록 답변이 약해집니다. 세계시 자정에 초기화됩니다.

속도가 일정하지 않습니다. 어떤 제공처는 매우 빠르고 어떤 곳은 느립니다. 그때그때 살아 있는 쪽이 걸립니다.

무료 정책은 예고 없이 바뀝니다. 모델이 사라지거나 한도가 줄어드는 일이 자주 있습니다. 프로그램이 하루 두 번 목록을 갱신하지만, 무료 사용자는 한 달 늦은 목록을 받습니다. 최신 목록을 바로 받으려면 연 19달러 유료 옵션이 있습니다. 프로그램 자체는 MIT 라이선스로 계속 무료입니다.

실제 서비스에 쓰는 용도가 아닙니다. 제작자가 문서에 “개인이 실험하고 배우기 위한 것이지 운영 환경용이 아니며, 제대로 만들 거면 유료 API로 바꿔 쓰라”고 명시해 뒀습니다. 이 문장을 가볍게 넘기지 않는 게 좋습니다.

정리

혼자 이것저것 만들어 보는 단계라면 한도에 막혀 멈추는 시간을 꽤 줄일 수 있습니다. 반대로 고객에게 나가는 제품을 만들고 있다면, 무료 한도를 기반으로 삼는 건 위험합니다.

처음이라면 키를 여섯 군데 다 받지 마시고 구글 AI 스튜디오 하나만 넣어서 클로드 코드가 실제로 그 창구를 통해 대답하는지부터 확인해 보세요. 그게 되면 나머지는 하나씩 늘리면 됩니다.