Claude Code에 OpenRouter 무료 모델 연결하기: 바뀐 설정과 지금 기준으로 다시 정리 | DAKER 커뮤니티

Claude Code를 쓰다 보면 작업 흐름이 한창 붙었는데도 구독 한도나 API 크레딧 때문에 멈춰야 하는 순간이 생깁니다. 이럴 때 눈에 들어오는 선택지가 OpenRouter의 무료 모델 연동입니다. Claude Code의 작업 방식은 그대로 두고, 뒤에서 응답하는 모델만 바꾸는 식입니다.

다만 이 주제는 반년 사이에 설정 방식과 무료 모델 사정이 꽤 달라졌습니다. 2026년 3월 19일에 올라온 오후다섯씨 채널의 영상 https://www.youtube.com/watch?v=0HtSBV-77vU는 출발점으로 좋지만, 제작자도 5월에 설명란 정정본을 따로 올렸습니다. 이 글은 영상의 흐름을 바탕으로, 정정본과 2026년 9월 기준 OpenRouter 공식 문서를 함께 확인해 다시 정리한 내용입니다.

클로드 코드에 무료 엔진 달기 — OpenRouter 연결법과 무료·저가·정식 모델 사용 전략 요약 카드

한 줄 답: Claude Code 작업 흐름은 유지한 채 OpenRouter API로 무료·저가 모델을 엔진처럼 연결할 수 있습니다. 설정·모델 목록은 반년 사이 바뀌었으므로, 2026-03-19 오후다섯씨 영상과 OpenRouter 공식 Claude Code 연동 가이드·모델 페이지를 함께 확인해야 합니다.

Claude Code와 모델은 분리해서 볼 수 있습니다

영상에서 가장 이해하기 쉬운 비유는 Claude Code를 경주차, AI 모델을 엔진으로 보는 설명입니다. Claude Code는 터미널에서 코드를 읽고, 고치고, 실행까지 이어 가는 Anthropic의 AI 코딩 에이전트입니다. 여기에 어떤 모델을 연결하느냐에 따라 성능과 비용이 달라집니다.

순정 엔진에 해당하는 것은 Anthropic의 Claude 모델들입니다. 영상에서는 Opus, Sonnet, Haiku를 예로 들며, 성능이 높을수록 비용도 커진다고 설명합니다. 반대로 OpenRouter를 거치면 다른 회사의 모델도 같은 틀 안에서 불러올 수 있습니다. 무료 모델도 있고, 아주 저렴한 모델도 있습니다.

차는 그대로 두고 엔진만 바꾸는 것이 이 연동의 핵심입니다.

OpenRouter는 여러 회사의 AI 모델을 한곳에서 호출할 수 있게 해 주는 서비스입니다. https://openrouter.ai/ 에서 API 키 하나를 발급받으면, Claude Code의 요청을 Anthropic 대신 OpenRouter로 보내고 그 뒤에서 다른 모델이 응답하게 만들 수 있습니다.

무료 모델은 어떻게 고르는가

영상에서는 OpenRouter 모델 목록 https://openrouter.ai/models 에서 무료 모델만 추려 보는 방법을 보여 줍니다. 텍스트 입력과 텍스트 출력을 기준으로 필터를 걸고, 가격 슬라이더를 무료(FREE)까지 내리면 됩니다. Claude Code는 텍스트를 주고받으며 일하기 때문에, 텍스트 입력·텍스트 출력 모델이면 기본 조건은 충족합니다.

촬영 당시 영상에서는 전체 약 650개 중 무료 모델이 28개였다고 설명합니다. 하지만 이 숫자는 계속 바뀝니다. 원문에서도 다시 확인했을 때 전체 459개, 무료는 20개 남짓이었다고 적고 있습니다. 따라서 숫자 자체보다 필터링 방법을 기억해 두는 편이 낫습니다.

제작자가 테스트해 보고 언급한 선택지는 세 가지였습니다. 무료 모델 가운데 하나를 자동으로 골라 주는 openrouter/free, 구글의 Gemma 3, 그리고 무료는 아니지만 매우 저렴한 Gemini 2.5 Flash Lite입니다. 다만 지금은 Gemma 3가 무료 목록에서 빠지고 Gemma 4 계열이 무료로 올라와 있다는 점도 함께 짚고 있습니다.

여기서 특히 헷갈리기 쉬운 부분이 있습니다. 설명란의 원래 설정 예시에는 openrouter/auto가 들어 있었지만, 이것은 무료 전용이 아니라 요청에 따라 유료 모델까지 고를 수 있는 자동 라우터입니다. 무료 모델만 자동 선택하려면 영상에서 말로 소개한 openrouter/free를 써야 합니다.

openrouter/auto와 openrouter/free는 다르며, 전자는 요금이 발생할 수 있습니다.

설정은 프로젝트 폴더에 두는 편이 낫습니다

영상에서 제작자가 강조한 지점은 설정 파일의 위치입니다. Claude Code 설정은 모든 프로젝트에 적용되는 전역 설정과, 특정 프로젝트에만 적용되는 로컬 설정으로 나뉩니다. 전역에 넣어 두면 순정 Claude와 OpenRouter 모델을 오갈 때 불편해질 수 있어서, 프로젝트 폴더 안의 .claude/settings.local.json에만 두는 방식을 권합니다.

다만 영상 속 설정은 지금 그대로는 동작하지 않습니다. 제작자의 정정본과 OpenRouter 공식 Claude Code 연동 문서 https://openrouter.ai/docs/guides/guides/claude-code-integration 를 함께 보면 바뀐 점은 세 가지입니다.

사용할 모델은 ANTHROPIC_MODEL에 적으면 됩니다. 공식 문서에 따르면 예전에 Anthropic 계정으로 Claude Code에 로그인한 적이 있다면 /logout을 한 번 실행한 뒤 다시 시작하는 것이 좋습니다. 연결이 제대로 됐는지는 Claude Code 안에서 /status를 입력해 확인할 수 있습니다. 인증 토큰 항목이 ANTHROPIC_AUTH_TOKEN, 주소가 https://openrouter.ai/api로 보이면 성공입니다.

API 키와 Git 관리에서 놓치기 쉬운 점

API 키는 OpenRouter의 API Keys 페이지 https://openrouter.ai/settings/keys 에서 만들 수 있습니다. 여기서 중요한 것은 키가 들어 있는 설정 파일을 Git에서 제외하는 일입니다.

Claude Code 설정 문서 https://code.claude.com/docs/en/settings 에 따르면 settings.local.json은 Claude Code가 직접 만들면 자동으로 git에서 빠지지만, 영상처럼 손으로 만들면 직접 .gitignore에 넣어야 합니다. 실수로 GitHub에 올리면 다른 사람이 내 계정으로 모델을 호출할 수 있습니다.

손으로 만든 settings.local.json은 직접 .gitignore에 넣어야 합니다.

또 하나, 영상에서는 Google Antigravity https://antigravity.google/ 안에서 Claude Code를 실행합니다. 정정본에는 VS Code 계열 에디터의 Claude 확장 패널은 Anthropic 직결만 인식하므로, OpenRouter를 쓸 때는 통합 터미널에서 claude 명령으로 실행해야 한다는 안내가 추가돼 있습니다.

실제로 써 보면 어떤가

영상에서 제작자는 무료 모델로 두 가지 작업을 시연합니다. 하나는 Processing https://processing.org/ 스케치를 만드는 일입니다. 점 두 개가 원을 그리며 도는 간단한 코드는 금방 만들었지만, 더 화려하게 만들어 달라고 하자 3D, 소리 반응, 파티클 효과까지 붙이며 코드가 크게 늘어납니다.

다른 하나는 새 세션에서 행복에 관한 짧은 에세이를 부탁하는 장면입니다. 이때 모델이 옆에 열려 있던 Processing 코드까지 읽고, 코드가 예상대로 움직일 때의 감각을 끌어와 세 단락짜리 글을 파일로 저장해 줍니다. 이 시연은 무료 모델도 기본적인 문서 작업과 가벼운 코드 작업에는 충분히 쓸 수 있다는 점을 보여 줍니다.

다만 작업 중 Unsupported content type: thinking 경고가 뜨는 장면도 나옵니다. 영상에서는 계속 진행하면 이어서 일한다고 설명했지만, 정정본에서는 이 에러 때문에 막히는 경우가 있으니 이름에 reasoning, r1, thinking이 들어간 모델은 피하라고 수정했습니다.

무료 모델의 한계와 지금 기준의 전략

정정본에서 제작자는 2026년 들어 무료 모델의 요청 제한이 너무 심해져 사실상 쓰기 어려워졌다고 적었습니다. OpenRouter의 무료 모델은 분당 20회 제한이 있고, 크레딧을 10달러 이상 산 적이 없는 계정은 하루 50회까지만 호출할 수 있습니다. 10달러 이상이면 하루 1,000회입니다. 이 내용은 OpenRouter 요금 안내 https://openrouter.ai/pricing 에서 확인할 수 있습니다.

문제는 Claude Code가 한 번 답을 받는 데서 끝나지 않는다는 점입니다. 파일을 읽고, 명령을 실행하고, 다시 수정하는 과정마다 모델 호출이 일어나기 때문에 하루 50회는 생각보다 빨리 소진됩니다. 그래서 정정본은 무료 모델 대신 아주 싼 유료 모델인 DeepSeek V3-0324 deepseek/deepseek-chat-v3-0324를 권합니다. 모델 페이지는 https://openrouter.ai/deepseek/deepseek-chat-v3-0324 입니다.

원문에 따르면 제작자가 5월에 적은 가격은 입력 100만 토큰당 0.20달러, 출력 0.77달러였고, 2026년 9월 기준 OpenRouter에서는 입력 0.25달러, 출력 1달러였습니다. 반면 Gemini 2.5 Flash Lite는 영상에서 Claude Haiku 4.5보다 열 배쯤 싸다고 설명했는데, 원문에서도 오늘 기준 가격이 대략 그 설명과 맞는다고 정리하고 있습니다.

중요한 프로젝트에는 정식 Claude를 쓰고, 연습이나 초안, 번역, 텍스트 정리 같은 가벼운 작업은 무료나 저가 모델에 맡기는 전략이 현실적입니다.

OpenRouter 공식 문서도 Claude Code는 Anthropic 모델에 맞춰 설계돼 있어서 다른 모델에서는 제대로 동작하지 않을 수 있다고 밝힙니다. 제작자의 결론도 크게 다르지 않습니다. Claude Pro처럼 주간 한도가 빨리 차는 사용자에게는 보조 수단이 될 수 있지만, Max 사용자라면 굳이 필요하지 않을 수 있다는 조언도 덧붙였습니다.

지금 이 정보를 볼 때 함께 챙길 점

이 주제의 핵심은 단순히 공짜로 쓰는 법보다, Claude Code가 모델과 분리된 도구라는 점을 이해하는 데 있습니다. 경주차와 엔진 비유를 받아들이고 나면, 에이전트와 모델을 따로 고를 수 있다는 감각이 분명해집니다.

동시에 이런 튜토리얼은 시간이 지나면 금방 낡습니다. 실제로 반년 사이에 설정 방식도 바뀌었고, 무료 모델 목록과 무료 한도도 달라졌습니다. 따라서 영상을 볼 때는 설명란의 정정본과 공식 문서를 먼저 함께 확인하는 편이 시간을 아끼는 길입니다.

원문이 마지막에 짚은 두 가지 주의점도 여전히 중요합니다. 하나는 API 키가 들어 있는 파일을 Git에서 확실히 제외하는 일이고, 다른 하나는 무료 모델에 어떤 데이터를 보내는지 의식하는 일입니다. 무료 모델은 제공 업체마다 입력 기록이나 학습 활용 정책이 다를 수 있으므로, 회사 코드나 개인정보가 들어간 작업이라면 각 모델 페이지의 제공 업체 정책을 먼저 확인하는 편이 안전합니다.

출처

직접 써 보셨다면, 무료 모델이나 저가 모델을 Claude Code에 붙였을 때 어느 작업까지는 괜찮았는지 궁금합니다.