무료 LLM API(free LLM API)를 클로드에 연결하려면, 먼저 Claude Code 기준인지 확인하면 좋아요. 이 글은 채팅 웹페이지가 아닌 터미널용 도구에 OpenRouter를 연결하는 방법이에요. 무료 모델을 쓰는 것이지, Claude 모델 자체가 무료로 바뀌는 건 아니에요.
키 발급부터 설정·확인 순서까지 두 서비스의 공식 안내 기준으로 정리했습니다.
무료 LLM API, 먼저 구분할 점
| 원하는 것 | 확인할 점 |
|---|---|
| 클로드에 외부 API 연결 | 이 글은 터미널용 Claude Code 기준 |
| 무료 모델 이용 | OpenRouter 모델 목록에서 입·출력 가격 모두 확인 |
| Claude 모델 무료 사용 | 외부 무료 모델 연결과 다른 이야기 |
공식 연결 안내는 Anthropic 직접 제공 모델에서만 작동을 보장해요. 다른 무료 모델은 도구 호출 등이 안 될 수 있어, 가볍게 시험하는 용도로 접근하는 게 좋아요. (연결·호환성 안내)
API 키와 무료 모델 ID 준비
- API 키 페이지에서 로그인한 뒤 키를 발급받으세요.
- 모델 목록에서 텍스트 생성·도구 호출 지원 여부와 입·출력 가격이 모두 0달러인지 확인하세요.
- 모델 상세 화면의
:free로 끝나는 ID 전체를 복사하세요. 모델 이름만 적으면 안 돼요.
무료 모델의 종류와 제공 상태는 바뀔 수 있어요. 처음에는 짧은 질문 하나로 확인해 보세요.
Claude Code에 적용하는 방법
설치 전이라면 공식 설치 안내에서 운영체제에 맞게 설치하세요. 작업할 폴더에 .claude/settings.local.json을 만들고 아래 내용을 넣으면 돼요. 기존 파일이 있다면 덮어쓰지 말고 env 항목에 합쳐 주세요.
{
"env": {
"ANTHROPIC_BASE_URL": "https://openrouter.ai/api",
"ANTHROPIC_AUTH_TOKEN": "발급받은-API-키",
"ANTHROPIC_API_KEY": "",
"ANTHROPIC_MODEL": "복사한-무료-모델-ID:free"
}
}발급받은-API-키와 복사한-무료-모델-ID:free는 본인 값으로 바꾸세요. ID에는 :free를 중복해서 붙이지 마세요. 일반 .env 파일에 넣는 방식은 아니에요.
API 키가 담긴 파일은 공개 저장소나 화면 캡처에 올리지 마세요. 기존 환경변수나 로그인 정보와 충돌할 수 있으니 설정 뒤 재실행이 필요해요.
- 기존 Anthropic 계정으로 로그인했다면
/logout을 실행한 뒤 종료하세요. - 설정 파일이 있는 프로젝트 폴더에서
claude를 다시 실행하세요. /status에서 인증이ANTHROPIC_AUTH_TOKEN, 주소가https://openrouter.ai/api인지 확인하세요.
위 예시는 주 대화 모델 설정이에요. 보조 작업까지 무료로 제한하려면 공식 안내의 ANTHROPIC_DEFAULT_*_MODEL과 CLAUDE_CODE_SUBAGENT_MODEL도 같은 무료 ID로 지정하고 실제 사용 내역을 확인하세요. (모델별 설정 안내)
연결이 안 되면 여기부터 확인하세요
- 인증 오류: 키가 토큰 항목에 들어갔는지,
ANTHROPIC_API_KEY는 빈 문자열인지 확인해요. - 모델 오류: ID 오타·무료 제공 종료·도구 호출 호환성을 확인해요.
- 429 오류: 호출 한도나 제공처 혼잡일 수 있어요. 바로 반복 실행하지 말고 잠시 기다리세요.
무료 모델도 호출 한도가 있고, 작업 한 번에 여러 요청이 나갈 수 있어요. 유료 모델로 바꾸면 별도 비용이 생기므로 가격과 실제 모델을 확인하고 쓰세요. (무료 이용 한도 안내)
함께 보면 좋은 글: 챗GPT 무료 시작 방법, 챗GPT 이미지 만드는 방법