클로드 코드 0원으로 쓰는 법

프리 LLM API 설치부터 연결까지

단계 7개따라 하기 약 15분

한눈에 보기

1앱 설치윈도우 설치 파일 받기›2무료 키 받기하나만 있어도 시작 가능›3앱에 키 넣기Keys 페이지›4주소와 통합 키 복사freellmapi- 로 시작하는 키›5클로드 코드에 연결 부탁주소와 키만 붙여 넣기›6클로드 코드 다시 켜기이제 무료 모델로 돌아가요›7되돌리기 · 막히면자주 나오는 것›

프리 LLM API(FreeLLMAPI)는 여러 AI 회사의 무료 사용량을 한곳에 모아 주는 무료 프로그램이에요. 깃허브 별 3만 개가 넘는 무료 공개 프로그램(MIT)이고, 클로드 코드를 이 무료 모델들로 돌릴 수 있게 연결해 줘요.

먼저 알아 두세요 — 클로드 모델이 공짜가 되는 게 아니에요. 클로드 코드라는 도구를 제미나이·그록 같은 무료 모델로 돌리는 방식이에요. 만든 사람도 개인 테스트·공부용으로 쓰라고 안내해요.

읽는 순서 — ① 앱 설치 → ② 무료 키 받기 → ③ 앱에 키 넣기 → ④ 주소·통합 키 복사 → ⑤ 클로드 코드에 연결 부탁 → ⑥ 클로드 코드 다시 켜기 → ⑦ 되돌리기·막히면.

준비물

윈도우 또는 맥 PC — 이 글은 윈도우 기준이에요.
클로드 코드 — 아직 없다면 자료실 #017 맨 위 설치 안내를 보세요.
Node.js(노드) 20 이상 — 연결할 때 필요한 프로그램이에요. 클로드에게 "제 컴퓨터에 Node.js 20 이상이 있는지 보고, 없으면 깔아 주세요"라고 말하면 돼요.
구글 계정 — 무료 키를 받을 때 써요. 대부분 카드 등록 없이 돼요.

직접 명령어로 하고 싶다면

클로드 코드 설치는 PowerShell(윈도우 기본 명령어 창)에 아래를 붙여 넣으세요.

irm https://claude.ai/install.ps1 | iex

Node.js 확인은 아래를 쳐서 v20 이상이면 돼요. 없으면 nodejs.org 에서 LTS를 설치하세요.

node -v

앱 설치윈도우 설치 파일 받기

아래 깃허브 페이지를 인터넷 창으로 여세요.

https://github.com/tashfeenahmed/freellmapi/releases/latest

페이지 아래 Assets에서 FreeLLMAPI.Setup.(버전).exe 를 눌러 받고, 받은 파일을 두 번 눌러 설치하세요(2026-10-06 기준 0.13.4, 약 108MB). 맥은 .dmg 파일이에요.

"Windows의 PC 보호" 파란 창이 뜨면 추가 정보 → 실행을 누르세요. 서명 안 된 무료 공개 앱이라 뜨는 경고예요.

이렇게 되면 성공 — 화면 오른쪽 아래 시계 옆 ^ 아이콘 안에 FreeLLMAPI 아이콘이 생겨요. 로그인·비밀번호는 없어요.

무료 키 받기하나만 있어도 시작 가능

AI 회사 사이트에 가입하고 API 키(내 사용량을 알아보는 비밀번호 같은 글자)를 만들어요. 처음엔 구글 AI 스튜디오 하나만 해도 돼요. 많이 넣을수록 한도에 덜 걸려요.

구글 AI 스튜디오   https://aistudio.google.com/apikey
Groq              https://console.groq.com/keys
Cerebras          https://cloud.cerebras.ai
OpenRouter        https://openrouter.ai/keys

키는 남에게 보여 주지 마세요. 카톡·스크린샷·깃허브에 올리면 다른 사람이 내 사용량을 써요.

앱에 키 넣기Keys 페이지

시계 옆 FreeLLMAPI 아이콘 클릭 → Open Dashboard(관리 화면 열기) → 왼쪽 Keys → 회사 이름을 고르고 받아 온 키를 붙여 넣어 저장하세요.

이렇게 되면 성공 — 키 옆에 상태 점이 켜져요. 앱이 키가 살아 있는지 스스로 확인한 표시예요.

주소와 통합 키 복사freellmapi- 로 시작하는 키

시계 옆 아이콘을 누르면 작은 창이 떠요. 여기서 주소와 통합 키를 복사해 메모장에 붙여 두세요. 통합 키는 freellmapi- 로 시작해요(관리 화면 Keys 페이지 맨 위에도 있어요).

주소는 보통 http://127.0.0.1:31415 예요. 다른 프로그램이 그 번호를 쓰고 있으면 바뀔 수 있으니, 꼭 창에서 복사한 주소를 쓰세요.

클로드 코드에 연결 부탁주소와 키만 붙여 넣기

앱이 켜진 상태에서 클로드 코드에 이렇게 말하고, 4단계에서 복사한 주소와 통합 키를 붙여 넣으세요.

프리 LLM API(FreeLLMAPI) 앱을 켜 뒀어요. 클로드 코드가 이 앱의 무료 모델로 돌아가게 연결해 주세요. 바꾸기 전에 뭐가 바뀌는지 먼저 보여 주시고, 원래 설정은 꼭 백업해 두세요. 주소: (붙여 넣기) 통합 키: (붙여 넣기)

클로드 코드는 내 컴퓨터에서 돌아서 키를 넣어도 괜찮아요. 다만 카톡·스크린샷·깃허브에는 절대 올리지 마세요.

직접 명령어로 하고 싶다면

PowerShell을 열고 아래를 붙여 넣으세요. 주소와 통합 키만 4단계에서 복사한 것으로 바꾸세요.

npx freellmapi setup-claude --url http://127.0.0.1:31415 --api-key freellmapi-여기에통합키

바꾸기 전에 미리 보고 싶으면 맨 뒤에 --dry-run 을 붙이세요. 실제로 바꾸지 않고 바뀔 내용만 보여 줘요. 바뀌는 파일은 사용자폴더\.claude\settings.json 이고, 원래 파일은 날짜가 붙은 백업으로 남아요.

이렇게 되면 성공 — 클로드가 "연결했어요"라고 답하고, 원래 설정은 날짜가 붙은 백업으로 남아요.

앱이 꺼져 있으면 실패해요. 연결 확인을 먼저 하기 때문이에요. 시계 옆에 아이콘이 있는지 보고 다시 하세요.

클로드 코드 다시 켜기이제 무료 모델로 돌아가요

클로드 코드를 완전히 끄고 새 창에서 다시 켜면 무료 모델로 돌아가요. 한 곳이 한도에 걸리면 앱이 알아서 다음 모델로 넘겨요.

직접 명령어로 하고 싶다면

새 PowerShell 창에서 아래를 치세요.

claude

클로드 코드 쓸 때만 잠깐 무료로 쓰고 싶다면, 5단계 대신 아래로 켜세요. 설정 파일을 건드리지 않아요.

npx freellmapi launch --url (주소) --api-key (통합 키)

되돌리기 · 막히면자주 나오는 것

원래 클로드 코드로 돌아가고 싶어요 — 클로드에게 이렇게 말하세요. 나중에 유료 결제를 했다면 꼭 되돌리세요. 안 그러면 계속 무료 모델로 돌아가요.

클로드 코드 설정을 무료 모델 연결하기 전 백업으로 되돌려 주세요.

직접 명령어로 하고 싶다면

사용자폴더\.claude\ 에 날짜가 붙은 settings.json 백업이 있어요. 그 파일을 settings.json 으로 되돌리면 돼요.

"npx 를 찾을 수 없다"고 나와요 — Node.js 가 없거나, 설치 뒤 창을 새로 열지 않은 거예요. 클로드에게 "Node.js 깔아 주세요"라고 하거나, 설치 후 창을 다시 여세요.

답이 느리거나 엉뚱해요 — 무료 모델은 클로드보다 약할 수 있어요. 관리 화면 Fallback Chain에서 쓰는 모델 순서를 바꿔 보세요.

앱을 지우고 싶어요 — 윈도우 설정 → 앱에서 제거한 뒤, 클로드에게 이렇게 말하면 남은 키까지 깨끗이 지워요.

FreeLLMAPI 앱을 지웠어요. 제 컴퓨터에 남은 FreeLLMAPI 폴더도 지워 주세요.

직접 명령어로 하고 싶다면

아래 폴더를 지우면 키까지 지워져요.

%APPDATA%\FreeLLMAPI\

확인한 것

설치 파일·버전·별 개수 — GitHub tashfeenahmed/freellmapi 릴리스 v0.13.4, 별 30,965 (2026-10-06)
명령어(setup-claude · launch · --dry-run)·설정 파일 위치·백업 — 공식 README, docs/en/cli, npm freellmapi 0.7.0 도움말 (2026-10-06)
데스크톱 앱 주소 127.0.0.1:31415 · 트레이에서 주소·키 복사 · 비밀번호 없음 — 공식 desktop/README, install 문서 (2026-10-06)
"개인 테스트·공부용, 실서비스 금지" — 공식 README 마지막 안내

AI 공부방 오픈카카오톡 · 막히면 같이 공부해요

입장하기 ‹ 다른 자료 보러 가기

트렌드코어 스킬공유자료실 · 무료