월 28만 원 맥스 대신 무료 AI 470개를 클로드 코드에 무한리필하는 FreeLLMAPI 설치 가이드
- 클로드 코드 한도가 끝나도 무료 한도를 모아 이어 쓸 수 있습니다.
- 오픈소스 FreeLLMAPI 설치법, 무료 키 받는 곳, 클로드 코드 연결 명령어를 담았습니다.
Quick Start
FreeLLMAPI는 구글·Groq·미스트랄·OpenRouter 같은 34개 회사의 무료 한도를 하나의 주소로 묶어 주는 오픈소스입니다.
무료 모델은 470여 종, 다 합치면 한 달에 무료 토큰이 약 74억 개입니다.
MIT 라이선스라 도구 자체도 무료이고, 깃허브 스타는 약 3.5만 개입니다.
- STEP 1에서 FreeLLMAPI를 설치합니다.
- STEP 2~3에서 무료 키를 받아 넣고 넘어갈 순서를 정합니다.
- STEP 4~5에서 클로드 코드에 연결하고 메모 넘겨주기를 켭니다.
STEP 1 · 3분FreeLLMAPI를 설치한다
맥·윈도우는 데스크톱 앱이 가장 쉽습니다.
Releases 페이지에서 맥은 .dmg(Apple Silicon은 arm64, 인텔은 x64), 윈도우는 .exe를 받아 설치합니다.
메뉴 막대 아이콘 → Open Dashboard를 누르면 관리 화면이 열립니다.
비밀번호를 따로 만들 필요가 없습니다.
Docker가 깔려 있다면 터미널 한 줄로도 됩니다.
curl -fsSL https://freellmapi.co/install.sh | bash
설치가 끝나면 브라우저에서 http://localhost:3001을 엽니다.
성공하면 FreeLLMAPI 관리 화면에 Keys, Fallback Chain, Analytics 메뉴가 보입니다.
STEP 2 · 10분회사별 무료 키를 받는다
회사마다 무료 키를 하나씩 받습니다.
많이 넣을수록 쓸 수 있는 양이 늘어납니다.
처음엔 아래 다섯 개면 충분합니다.
- 구글 제미나이: aistudio.google.com/apikey
- Groq: console.groq.com/keys
- 미스트랄: console.mistral.ai/api-keys
- OpenRouter: openrouter.ai/keys
- Cerebras: cloud.cerebras.ai
더 넣고 싶다면 NVIDIA(build.nvidia.com), Cohere(dashboard.cohere.com/api-keys), 허깅페이스(huggingface.co/settings/tokens), Cloudflare, Z.ai(GLM)도 지원합니다.
성공하면 회사마다 긴 영문·숫자 키가 하나씩 생깁니다.
메모장에 회사 이름과 함께 모아 두세요.
STEP 3 · 3분키를 넣고 넘어갈 순서를 정한다
관리 화면 Keys 페이지에서 받은 키를 회사별로 붙여 넣습니다.
키는 암호화돼 내 컴퓨터에만 저장됩니다.
Fallback Chain에서 모델 순서를 끌어서 정합니다.
맨 위 모델의 한도가 차면 그다음 모델로 자동으로 넘어갑니다.
코딩용 순서, 이미지 읽기용 순서처럼 이름을 붙여 여러 개 만들어 둘 수도 있습니다.
마지막으로 Keys 페이지 위쪽에 있는 통합 키(freellmapi-…로 시작)를 복사해 둡니다.
클로드 코드에는 이 키 하나만 넣습니다.
성공하면 Keys 페이지에서 넣은 회사 옆에 키가 등록된 것으로 표시되고, Fallback Chain에 모델 목록이 순서대로 보입니다.
STEP 4 · 2분클로드 코드에 연결한다
터미널에 아래 명령을 붙여 넣습니다.
<통합 키> 자리에 STEP 3에서 복사한 키를 넣으세요.
기존 설정은 자동으로 백업한 뒤 합쳐집니다.
npx freellmapi setup-claude --url http://localhost:3001 --api-key <통합 키>
바뀔 내용을 먼저 보고 싶다면 끝에 --dry-run을 붙이세요.
클로드 코드 주소는 /v1 없이 http://localhost:3001까지만 씁니다.
설정 파일에 키를 남기고 싶지 않다면 연결 대신 이 명령으로 바로 실행해도 됩니다.
키는 실행하는 동안에만 클로드 코드에 넘어갑니다.
npx freellmapi launch --api-key <통합 키>
성공하면 클로드 코드가 평소처럼 열리고, 관리 화면 Analytics에 요청이 하나씩 쌓입니다.
STEP 5 · 1분넘어갈 때 메모 넘겨주기를 켠다
모델이 바뀔 때 새 모델이 하던 일을 이어받게 하려면 메모 넘겨주기를 켭니다.
한 줄 설치를 했다면 ~/freellmapi/.env 파일에 아래 줄을 넣고 다시 시작합니다.
FREELLMAPI_CONTEXT_HANDOFF=on_model_switch
켜 두면 모델이 바뀌는 순간 「앞 모델이 하던 작업을 이어받는다, 처음부터 다시 묻지 말라」는 메모와 최근 대화 요약이 새 모델에게 같이 넘어갑니다.
같은 설명을 두 번 할 필요가 없습니다.
성공하면 모델이 바뀐 뒤에도 클로드 코드가 하던 작업을 처음부터 다시 묻지 않고 이어 갑니다.
STEP 6 · 2분코덱스·커서도 같은 방식으로 붙인다
코덱스는 setup-codex, 커서는 setup-cursor로 붙입니다.
명령의 --url은 클로드 코드와 똑같이 http://localhost:3001을 넣으면 됩니다.
도구 설정 화면에 주소를 직접 적을 때만 끝에 /v1을 붙입니다.
npx freellmapi setup-codex --url http://localhost:3001 --api-key <통합 키>
어떤 도구를 붙일 수 있는지는 npx freellmapi list로 볼 수 있습니다.
클라인·에이더·오픈코드 등 20개가 넘습니다.
어떤 모델이 답했는지는 응답 머리글 X-Routed-Via에 표시되고, 관리 화면 Analytics에서 회사별 사용량을 볼 수 있습니다.
성공하면 코덱스를 열었을 때 FreeLLMAPI 모델 목록에서 모델을 고를 수 있습니다.
FAQ
도구 자체는 돈이 드나요? FreeLLMAPI는 MIT 라이선스 오픈소스라 무료입니다.
무료 키도 회사마다 무료로 발급됩니다.
클로드 코드 말고 다른 도구에도 쓸 수 있나요? 코덱스, 커서, 클라인, 에이더, 오픈코드처럼 20개가 넘는 도구를 npx freellmapi setup-… 명령 하나로 붙일 수 있습니다.
한도가 차면 어떻게 되나요? Fallback Chain에서 정한 다음 모델로 자동으로 넘어갑니다.
메모 넘겨주기를 켜 두면 하던 작업도 그대로 이어받습니다.
공식 참고 자료
이메일 남기고 전체 바로 보기