클로드 코드로 작업하다 사용량 제한에 막히면 흐름이 뚝 끊깁니다. FreeLLMAPI는 여러 AI 회사의 무료 API 할당량을 한곳에서 연결하고, 제한에 걸렸을 때 다른 모델로 요청을 돌리도록 만든 오픈소스 도구입니다. 라우터 자체는 무료지만 각 회사에서 발급받는 키와 이용 약관은 따로 챙겨야 해요. 설치보다 먼저 이 차이를 알아야 예상하지 못한 비용이나 정보 유출을 줄일 수 있습니다.
FreeLLMAPI는 정말 무료일까? 비용 구조부터 살펴보기
이 도구가 해 주는 일은 무료 AI를 새로 만들어 주는 게 아니라 이미 제공되는 무료 사용량을 묶어 주는 것입니다. 구글이나 그록, 미스트랄, 오픈라우터 같은 제공업체에서 각자 API 키를 받아 등록하면 로컬 라우터가 요청을 분배합니다. 어느 업체의 한도가 끝나면 설정된 다른 모델로 넘어가는 방식이죠.
2026년 10월 공식 GitHub에는 다양한 모델 계열과 엔드포인트가 소개돼 있습니다. 다만 저장소 소개 숫자와 실시간 모델 목록의 집계는 서로 다르게 표시되기도 합니다. 목록에 이름이 있다는 사실과 내 계정의 키로 지금 쓸 수 있다는 사실은 별개입니다. 저는 화려한 모델 개수보다 실제로 연결한 무료 키가 정상 작동하는지를 먼저 보겠습니다.
공식 한국어 요금제에는 무료판 0달러, 프리미엄 연 19달러 또는 일회성 49달러가 안내돼 있습니다. 프리미엄은 새 무료 모델과 할당량 변경을 더 빨리 받는 모델 목록 서비스예요. 무료판은 카탈로그 갱신이 약 30일 늦을 수 있지만 핵심 라우팅과 장애 전환 기능은 계속 제공됩니다.
| 구분 | 무료 설치판 | 프리미엄 |
|---|---|---|
| 라우터 사용료 | 0달러 | 라우터 자체는 무료 |
| 모델 목록 반영 | 약 30일 지연 | 배포 당일 반영 |
| 자동 대체 모델 선택 | 지원 | 지원 |
| 추가로 필요한 것 | 업체별 무료 API 키와 약관 동의 | 업체별 키와 프리미엄 결제 |
윈도우와 맥에서 무료 라우터 설치하는 순서
처음 만지는 분이라면 명령어보다 데스크톱 설치 파일이 편합니다. 개발자 GitHub 최신 배포 페이지로 가서 윈도우는 설치용 실행 파일, 맥은 자신의 칩에 맞는 디스크 이미지 파일을 고르면 돼요. 맥은 애플 실리콘용과 인텔용이 나뉘며 공식 문서에는 macOS 12 이상이 안내됩니다.
- GitHub 저장소의 Releases에서 내 운영체제용 파일을 내려받습니다.
- 설치 후 작업 표시줄이나 메뉴 막대의 FreeLLMAPI 아이콘에서 대시보드를 엽니다.
- Keys 화면에서 사용할 제공업체를 정하고, 해당 업체에서 직접 발급받은 무료 API 키를 등록합니다.
- 키 상태를 검사하고 모델 선택 또는 대체 순서를 설정합니다.
- 작은 테스트 요청으로 실제 응답과 사용량을 확인합니다.
프로그램을 켰다고 무료 모델이 전부 즉시 작동하는 건 아닙니다. 제공업체 계정 생성이 필요할 수 있고, 일부 서비스에는 카드 등록이나 별도 사용 조건이 있을 수 있어요. 특히 카드가 연결된 계정이라면 무료 한도 이후의 과금 설정을 그 제공업체 화면에서 살펴보는 편이 안전하겠습니다.
도커로 설치할 때 기억할 로컬 주소와 설정
개발자라면 Docker를 통한 셀프 호스팅도 가능합니다. 공식 설치 문서는 Docker 설치 후 curl -fsSL https://freellmapi.co/install.sh | bash로 설치하고, 웹 브라우저에서 http://localhost:3001을 여는 흐름을 소개합니다. 인터넷에서 받은 스크립트를 바로 실행하기 전에 내용을 직접 읽어 보는 습관이 좋겠죠.
Docker 설치판에는 처음 접속할 때 대시보드 계정을 만드는 단계가 있고, 데스크톱판은 로컬 자동 로그인 방식입니다. 제공업체 키를 추가했다면 화면 상단에서 통합 API 키를 복사할 수 있습니다. 일반적인 OpenAI 호환 클라이언트의 기본 주소는 http://localhost:3001/v1입니다. 데스크톱 앱에서 사용하는 실제 포트는 앱 설정에 따라 다를 수 있어 해당 화면에 표시된 주소를 쓰면 됩니다.
저는 처음부터 외부 접속을 열지 않겠습니다. 공식 보안 정책도 기본값인 로컬호스트 바인딩을 권하고, 모든 네트워크 인터페이스로 여는 설정은 위험성을 경고합니다. 회사 네트워크나 공개 서버에 올릴 계획이라면 접근 제어와 암호화 연결이 필요한 별도 운영 작업으로 보는 편이 맞습니다.
클로드 코드와 코덱스 연결 뒤 모델이 바뀌는 방식
로컬 라우터를 설치한 뒤에는 기존 코딩 도구를 이 라우터로 연결해야 합니다. 프로젝트에는 클로드 코드용 npx freellmapi setup-claude --url http://localhost:3001, 코덱스용 npx freellmapi setup-codex --url http://localhost:3001 같은 설정 명령이 안내돼 있어요. 실제 통합 키 입력이나 설정 파일 수정은 버전마다 달라질 수 있으니 공식 클라이언트 연결 문서의 현재 절차를 따르는 게 낫습니다.
라우터의 자동 전환은 대체로 API 요청 제한이나 제공업체 오류가 생겼을 때 다른 사용 가능한 모델을 찾아 재시도하는 기능입니다. 30분 동안 같은 모델에 대화를 붙여 두는 세션 기능도 소개되어 있습니다. 다만 모델이 바뀌면 문맥 처리 방식이나 도구 호출 지원 여부가 달라질 수 있으므로 긴 코딩 작업에서는 결과 파일과 변경 사항을 직접 점검해야 합니다.
특히 게시물에서 말하는 ‘작업을 기억해 이어받는다’는 표현에는 조건이 붙습니다. 공식 설명에 따르면 모델 변경 시 짧은 인계 메모를 덧붙이는 기능은 선택 설정이며 기본으로 꺼져 있어요. 인계 메모를 켜도 이전 모델과 완전히 똑같이 판단하거나 코드 품질이 보장되는 것은 아닙니다. 이 부분은 자동화의 장점만큼 꼭 알려 주고 싶었습니다.
API 키 암호화가 있어도 보안을 따져야 하는 이유
개발자 보안 정책에는 제공업체 키를 로컬 SQLite 데이터베이스에 AES-256-GCM 방식으로 암호화해 저장한다고 적혀 있습니다. 앱에는 통합 인증 토큰도 따로 있으며, 관련 비밀 키를 보관하는 환경 파일과 저장 폴더를 노출하지 말라고 권고합니다. 이런 기능은 분명 반갑지만 오픈소스나 암호화라는 단어 하나로 무조건 안전하다고 평가하긴 어렵습니다.
가장 놓치기 쉬운 것은 요청 내용의 이동 경로입니다. 라우터가 내 컴퓨터에서 작동하더라도 실제 질문과 코드 일부는 내가 선택한 외부 AI 제공업체 서버로 전달돼요. 업체별 데이터 보관, 학습 사용, 로그 정책이 서로 다를 수 있으니 회사 소스코드와 비밀번호, 고객 개인정보는 가린 다음 보내는 편을 권합니다. 자동 전환을 쓰면 요청을 받아 처리하는 제공업체도 달라질 수 있습니다.
- 공식 저장소에서 받은 설치 파일과 최신 업데이트만 사용하기
- API 키와 통합 토큰을 Git 저장소·화면 캡처·공유 문서에 붙여 넣지 않기
- 로컬 접속 유지, 외부 포트 공개와 공유 컴퓨터 사용 피하기
- 유출이 의심되면 통합 키를 재발급하고 업체별 API 키도 교체하기
- 민감한 코드나 개인정보는 테스트 요청에서 제외하기
개인 학습에는 유용하지만 실서비스에는 신중해야 한다
공식 README에는 이 프로젝트를 개인 실험과 학습을 위한 것으로 소개하고, 실제 서비스 운영에는 안정적인 유료 API로 옮기라는 취지의 안내가 있습니다. 모델이 많다는 장점만 보고 고객이 쓰는 서비스를 연결하면 무료 한도 소진, 제공업체 정책 변경, 품질 편차로 곤란해질 수 있거든요. 개발 도구의 MIT 라이선스와 외부 AI 모델의 서비스 이용 조건도 따로 보아야 합니다.
저라면 개인 코딩 연습, AI 모델 비교, 비용을 아끼는 프로토타입 작업에는 써 볼 만하다고 생각합니다. 반면 고객 정보가 오가는 업무나 매번 동일한 품질과 응답 속도가 필요한 자동화는 검토 범위가 훨씬 커집니다. 실무에서는 한도 초과 시 실패하는 상황을 대비하고, 어떤 제공업체가 요청을 처리했는지도 로그로 남기는 설계가 필요해 보입니다.
결국 가장 좋은 사용법은 처음부터 수십 개 업체를 모두 연결하는 게 아니라 약관을 이해한 무료 키 한두 개로 작은 테스트부터 시작하는 것입니다. 자동으로 이어진다는 편리함 뒤에 비용, 문맥, 데이터 이동이라는 조건이 있다는 사실만 알아도 선택이 한결 쉬워집니다.
자주 묻는 질문
Q. 무료 버전에도 카드 등록이 필요한가요?
FreeLLMAPI 자체는 카드 없이 설치할 수 있습니다. 다만 실제 모델을 제공하는 회사의 무료 API 가입 조건은 별도입니다.
Q. 클로드 유료 구독 없이 클로드 코드를 연동할 수 있나요?
공식 문서는 클로드 코드 클라이언트를 통합 라우터에 연결하는 설정을 안내합니다. 이때 응답은 연결된 외부 무료 모델이 생성할 수 있으며, 앤트로픽의 유료 클로드 모델까지 무료로 제공되는 방식은 아니에요.
Q. 한도가 차면 하던 코딩 작업이 반드시 이어지나요?
대체 모델로 재시도하는 기능은 있지만 맥락 인계는 선택 설정이고 응답 품질도 달라질 수 있습니다. 중요한 변경 사항은 버전 관리 기록으로 남기는 편이 좋습니다.
Q. 회사 프로젝트에도 써도 되나요?
프로그램의 MIT 라이선스와 별도로 각 제공업체의 약관, 데이터 보호 정책, 보안 요구 사항을 따져야 합니다. 프로젝트 개발자도 개인 실험·학습 중심으로 안내하고 있습니다.
출처와 참고한 곳
- FreeLLMAPI 공식 GitHub — 라우팅 기능, 라이선스, 실사용 목적과 제한
- 공식 설치 문서 — 운영체제별 다운로드 및 Docker 설치 경로
- 공식 한국어 요금제 — 무료 버전과 프리미엄의 차이 및 표시 가격
- 공식 보안 정책 — 키 암호화, 로컬 접속, 토큰 관리 권고
- 클라이언트 연결 문서 — 클로드 코드와 기타 코딩 도구 설정
함께 읽으면 좋은 글
- PHP 보안 취약점 비상, AI 발견 PHP2Shell 워드프레스 서버 패치
- Inspo MCP 무료 설치와 코딩 에이전트 디자인 레퍼런스 설정
- Kemono.cr Pawchive.pw 업데이트 비교
