# 클로드 코드에 무료 모델 연결하는 법 (FreeLLMAPI · 클로드 코드)

클로드 코드 사용량이 바닥났을 때 무료 모델로 이어 쓰는 방법이에요.

1. FreeLLMAPI 앱 깔기 — [FreeLLMAPI 최신 릴리스](https://github.com/tashfeenahmed/freellmapi/releases/latest)(Releases, 내려받는 파일 모음)에서 내 컴퓨터에 맞는 파일을 받아요. **주의:** Anthropic은 클로드 코드를 다른 회사 모델에 연결하는 걸 지원하지 않는다고 공식 문서에 적어 뒀어요. 그래서 클로드 코드의 새 기능 중 일부가 안 될 수 있어요. 만든 사람이 개인 연습·학습용이라고 적어 뒀어요. 회사 일이나 고객 서비스에는 쓰지 마세요. [클로드 코드 공식 문서: LLM gateway](https://code.claude.com/docs/en/llm-gateway) 다른 사이트에 올라온 파일은 받지 마세요. 맥은 .dmg 파일이에요. M1 이후 맥은 arm64, 인텔 맥은 x64를 받아요. macOS 12 이상이 필요해요. 윈도우는 .exe 설치 파일을 받아요. 설치하고 켜면 화면 위 메뉴 막대(윈도우는 오른쪽 아래)에 아이콘이 생겨요. 데스크톱 앱은 따로 가입하거나 비밀번호를 만들지 않아도 돼요. Docker(프로그램을 상자에 담아 돌리는 도구)를 쓰는 사람은 아래 한 줄로 깔아도 돼요.
2. 무료 키 받아 넣고 통합 키 복사하기 — 처음에는 아래 네 곳만 넣어도 돼요. 회사마다 가입하고 API 키(프로그램이 그 회사 AI를 부를 때 쓰는 비밀번호)를 하나씩 만들어요. **주의:** 구글은 「주의」예요. 2026년 3월 약관에 업무용으로 쓰라는 문구가 새로 생겼다고 적혀 있어요. 회사마다 결제 수단을 등록하지 않은 무료 등급으로만 쓰세요. 결제 수단이 있으면 무료 한도 뒤에 요금이 나갈 수 있어요. 구글(제미나이) — 순위가 높은 무료 모델(Gemini 3.6 Flash)이 여기 있어요. 대신 하루 한도가 작아요. 키 만드는 곳: [Google AI Studio](https://aistudio.google.com/apikey) Groq — 답이 아주 빠른 곳이에요. 키 만드는 곳: [GroqCloud 키 화면](https://console.groq.com/keys) Cerebras — 답이 아주 빠른 곳이에요. API 키를 팔거나 남에게 넘기면 안 돼요. 키 만드는 곳: [Cerebras Cloud](https://cloud.cerebras.ai/) OpenRouter — 다른 회사 무료 모델을 이어 주는 곳이에요. 키 만드는 곳: [OpenRouter 키 화면](https://openrouter.ai/keys) 원본 영상이 고른 네 곳은 공개돼 있지 않아요. 그래서 FreeLLMAPI 공식 구조도에 이름이 먼저 나오는 네 곳으로 골랐어요. 34곳 전체 목록과 회사별 무료 한도는 FreeLLMAPI 모델 목록 페이지에서 볼 수 있어요. [FreeLLMAPI 모델 목록](https://freellmapi.co/models.html)
   - 메뉴 막대의 FreeLLMAPI 아이콘을 누르고 Open Dashboard(관리 화면 열기)를 눌러요.
   - Keys 페이지에서 위 네 곳의 키를 회사별 칸에 붙여 넣어요.
   - Fallback Chain(넘어갈 순서)은 그대로 둬도 돼요. 원하면 순서를 바꿔요.
   - Keys 페이지 맨 위에 freellmapi-로 시작하는 통합 키가 있어요. 이걸 복사해요.
   - 아이콘을 누르고 Copy Key를 눌러도 같은 키가 복사돼요.
   - 관리 화면 주소창에 보이는 주소(예: http://127.0.0.1:31415)도 적어 둬요. Docker로 깔았다면 http://localhost:3001이에요.
   > 주의: 통합 키와 회사별 키는 비밀번호예요. 화면을 찍어 올리거나 남에게 보내지 마세요. 회사마다 계정은 하나만 만들어요. 키와 내 FreeLLMAPI 주소는 남과 나누지 않아요. 무료 한도는 회사가 예고 없이 줄이거나 없앨 수 있어요. FreeLLMAPI 문서의 자체 약관 검토(2026년 5월)에서 Groq·Cerebras·OpenRouter는 「괜찮을 가능성이 높음」이에요. 약관 검토는 FreeLLMAPI 쪽 의견이에요. 회사 공식 약관을 직접 읽고 판단하세요. [FreeLLMAPI 문서: 약관 검토(Terms of Service review)](https://github.com/tashfeenahmed/freellmapi/blob/main/docs/en/architecture/00-high-level-index.md#terms-of-service-review)
3. 클로드 코드 연결하기 — 명령어 한 줄 — 터미널(명령을 글자로 치는 창)을 열고 아래 명령을 쳐요. --url 뒤에는 앞에서 적어 둔 주소를 넣어요. --api-key 뒤의 <통합 키> 자리에 복사한 통합 키를 붙여 넣어요. 그러면 무료 모델에 연결된 클로드 코드가 바로 켜져요. 이 명령은 키를 파일에 저장하지 않아요. 이번 실행에만 넣어요. Node.js(자바스크립트 프로그램을 돌리는 도구) 20.18 이상이 있어야 해요. 클로드 코드를 쓰고 있다면 대부분 깔려 있어요.
4. 사용량이 바닥났을 때만 바꿔 켜기 — 평소에는 원래처럼 claude로 켜요. 사용량이 바닥나면 클로드 코드 창을 닫고, 3단계 명령으로 다시 켜요. 영상에서 말한 「클로드 프리(claude-free)」는 영상 만든 사람이 따로 붙인 이름으로 보여요. 공식 명령은 npx freellmapi launch예요. 무료 모델로 하던 일을 마치면 창을 닫고 claude로 켜면 원래 클로드로 돌아와요. setup-claude로 저장했다면, 만들어 둔 백업 파일로 되돌려요.
5. 잘 연결됐는지 확인하기 — 클로드 코드에 짧은 질문을 하나 보내요. FreeLLMAPI 관리 화면의 Analytics(사용 기록)에 요청이 하나 늘었는지 봐요. 어느 회사 모델이 답했는지도 거기서 볼 수 있어요. 답이 안 오면 Keys 페이지에서 키 옆 점 색을 봐요. 키가 틀렸거나 그 회사 한도가 찬 거예요. 클로드 코드가 아예 안 켜지면 FAQ의 마지막 질문을 봐요.
## 성능 · 성능은 어느 정도인가요
Text Arena(사람들이 두 AI의 답을 보고 더 나은 쪽을 고르는 순위표)의 2026년 10월 27일 값이에요.
Gemini 4 Carbon | 1위 | 1528
Claude Opus 5.5 | 3위 | 1509
Kimi K3 | 19위 | 1488
GPT-5.6 Sol | 22위 | 1485
DeepSeek-V4.1-Flash | 35위 | 1476
- 무료로 연결되는 모델은 이 표의 모델과 같은 모델이 아니에요. 같은 회사의 같은 계열 모델이에요.
- 딥시크·키미는 FreeLLMAPI가 직접 연결하는 곳이 아니에요. 다른 제공처를 거쳐 들어와요.
- 성능이 좋은 모델일수록 하루 무료 한도가 작아요. 오래 쓰면 더 작은 모델로 내려가요.

## 출처 · 출처
모두 2026년 11월 5~6일에 확인했어요.

참고: 사실과 숫자는 FreeLLMAPI 공식 깃허브 문서와 클로드 코드 공식 문서에서 가져왔어요(2026년 11월 5~6일 확인). 우리는 이 프로그램을 우리 컴퓨터에 설치해 쓰지 않았어요. 메뉴 이름·무료 한도·모델 순위는 자주 바뀌어요.

FreeLLMAPI 깃허브 열기: https://github.com/tashfeenahmed/freellmapi

## 자주 묻는 질문

### FreeLLMAPI가 뭔가요?
FreeLLMAPI는 깃허브에 공개된 무료 프로그램이에요. 구글 제미나이 같은 여러 회사의 무료 한도를 내 컴퓨터 안 주소 하나로 모아요. 클로드 코드를 이 주소에 연결하면 질문이 무료 모델로 가요. 한 곳이 한도에 걸리면 다음 모델로 자동으로 넘어가요. 평소 쓰는 클로드 코드 사용량이 바닥났을 때 이어 쓰는 용도로 써 보세요.

### 답은 클로드가 만드나요?
화면은 클로드 코드 그대로지만, 답을 만드는 건 클로드가 아니에요. 답은 제미나이 같은 다른 회사 무료 모델이 만들어요. FreeLLMAPI가 클로드 이름(opus·sonnet·haiku) 요청을 무료 모델로 바꿔 보내요.

### 어떻게 이어서 쓰게 되나요?
클로드 코드는 질문을 FreeLLMAPI로 보내요. FreeLLMAPI는 지금 한도가 남은 모델 중 순위가 가장 높은 모델에 질문을 넘겨요. 한 모델이 한도에 걸리면 다음 모델로 자동으로 넘어가요. 클로드 코드에 넣는 키는 하나예요. 회사별 무료 키는 FreeLLMAPI 안에만 넣어 둬요. 대화는 30분 동안 같은 모델에 붙여 둬요. 순위가 높은 모델일수록 하루 한도가 작아요. 그래서 늦은 시간일수록 답 품질이 떨어져요. 하루 한도는 UTC 자정, 한국 시각으로 매일 오전 9시에 다시 풀려요. 회사마다 분당·월간 한도는 따로 있어요.

### 정말 돈이 안 드나요?
무료 등급만 쓰면 돈은 안 들어요. FreeLLMAPI 프로그램도 무료(MIT 라이선스)예요. 유료 Premium(1년 19달러 또는 한 번 49달러)은 새 모델 목록을 바로 받는 선택 기능이에요. 안 사면 새 모델이 30일 늦게 들어와요. 한도와 품질에는 조건이 붙어요.

### 영상에서 말한 70억 토큰을 다 쓸 수 있나요?
아니요. 깃허브에 적힌 74억 토큰(AI가 글을 읽고 쓸 때 세는 단위)은 34곳 모두에 키를 넣었을 때 목록에 적힌 무료 한도를 더한 값이에요. 성능 좋은 모델은 하루 한도가 가장 작아서, 한 사람이 실제로 쓰는 양은 훨씬 적어요.

### 모델이 바뀌어도 대화가 이어지나요?
클로드 코드는 질문할 때마다 대화를 같이 보내서 대부분 이어져요. 대화는 30분 동안 같은 모델에 붙여 둬요. 다만 앞 모델 안에만 있던 내용은 넘어가지 않아요. 모델이 바뀔 때 이어받기 메모를 넣는 기능은 따로 켜야 해요(FREELLMAPI_CONTEXT_HANDOFF=on_model_switch).

### 키를 돌려 쓸 필요가 없다는데, 키는 받아야 하나요?
네. 회사마다 무료 키는 처음에 한 번 직접 받아 넣어야 해요. 그다음부터 클로드 코드에는 통합 키 하나만 쓰고, 어느 회사로 보낼지는 FreeLLMAPI가 알아서 골라요.

### 딥시크·키미도 쓸 수 있나요?
FreeLLMAPI가 직접 연결하는 곳은 아니에요. 다른 제공처를 거쳐 무료로 들어오는 경우가 있어요. 지금 어떤 경로가 있는지는 FreeLLMAPI 모델 목록 페이지에서 찾아보세요.

### 클로드 코드가 아예 안 켜져요.
ANTHROPIC_API_KEY라는 값이 설정돼 있으면 클로드 코드가 시작을 거부해요. 무료 모델에 연결할 때는 이 값을 지우고 다시 켜요. npx freellmapi launch는 필요한 값을 알아서 넣어 줘요.