🎬 How To Use Claude Code FREE Forever (OpenRouter Setup)

▶️ 유튜브

• 원본 링크: https://youtu.be/XFSN6Tw5bqI?si=AdqJQlYFfa4xk5z3

🖼️ 4컷 인포그래픽

💡 한 줄 결론

무료 OpenRouter 모델만으로도 Claude Code를 상당 부분 굴릴 수 있지만, 실전 생산성을 지키려면 프로젝트별·전역 설정을 분리하고 혼잡 시 즉시 대체할 무료/저가 유료 모델까지 준비한 다층 운영이 필요하다.

📌 핵심 요점

1. OpenRouter의 free 필터만 적용해도 Claude Code에 연결 가능한 무료 모델 풀이 넓지만, 실사용 만족도는 벤치마크보다 혼잡 시간대의 응답 성공률과 지연 편차에 더 크게 좌우된다.
2. Claude Code 연동은 OpenRouter API 키와 모델명을 Anthropic 호환 설정에 넣는 방식으로 이뤄지며, 동일한 구조를 프로젝트 로컬 설정과 전역 설정에 각각 적용할 수 있다.
3. 파라미터가 큰 무료 모델이 항상 더 좋은 선택은 아니며, 트래픽이 몰릴 때는 더 가벼운 무료 모델이 오히려 응답 성공률과 작업 연속성을 높여준다.
4. 프로젝트 내부 설정은 실험용 모델 전환에 유리하고, 운영체제별 글로벌 settings.json 수정은 어떤 폴더에서든 같은 기본 모델을 쓰는 운영 표준화에 적합하다.
5. 완전 무료 전략은 가능하지만 장애 회피 비용까지 고려하면 OpenRouter에 소액 크레딧을 넣고 MiniMax 같은 저가 유료 모델을 백업으로 두는 편이 비용 대비 안정성이 높다.

🧠 상세 요약

1) 배경과 문제 정의

출발점은 구독형 상위 모델이나 로컬 호스팅 없이도 Claude Code를 지속적으로 실무에 투입할 수 있느냐는 질문이다. 핵심 관찰 포인트는 단순 연결 성공 여부가 아니라, 무료 모델의 혼잡 리스크를 어떻게 흡수하고 프로젝트 단위 실험과 전역 운영을 어떻게 분리하느냐다.

2) 섹션별 상세 정리

1. 무료 모델 기반 Claude Code 운영이라는 문제 설정 [00:04]

• 발표자는 돈을 거의 쓰지 않으면서도 코딩 에이전트를 굴리는 방법으로 OpenRouter 무료 모델 활용을 제시한다.
• 핵심 전제는 로컬 모델을 직접 띄우지 않고, OpenRouter가 제공하는 무료 추론 경로를 Claude Code에 연결해 대체 워크플로를 만드는 것이다.

2. OpenRouter에서 무료 후보군을 고르는 시작점 [00:24]

• 모델 목록에서 free 필터를 적용하면 Claude Code에 연결해 볼 수 있는 무료 후보들을 빠르게 좁힐 수 있다.
• Stone, Z.ai, Nvidia, Qwen, Mistral 계열 등 선택지가 여러 개 존재하지만, 여기서 중요한 것은 “무엇이 무료인가”보다 “지금 안정적으로 응답하는가”라는 점이다.

3. 프로젝트 내부 설정 파일로 우선 연결하는 이유 [00:54]

• 발표자는 VS Code 기준으로 설명하지만, 본질은 특정 프로젝트 폴더 안에 Claude용 로컬 설정 파일을 두는 방식이다.
• 이렇게 하면 기존 전역 환경을 건드리지 않고 특정 프로젝트에서만 OpenRouter 모델을 시험해 볼 수 있어, 실패 비용이 낮고 롤백도 쉽다.

4. OpenRouter 문서의 Claude Code 가이드를 설정 템플릿으로 활용 [01:30]

• OpenRouter 문서의 coding agents 내 Claude Code 가이드는 단순 참고 문서가 아니라 바로 복사해 적용할 수 있는 설정 템플릿 역할을 한다.
• 영상은 터미널에서 수동으로 만지는 방법보다 설정 파일에 필요한 블록을 넣어 재현 가능한 구성으로 만드는 흐름을 택한다.

5. API 키와 모델명을 Anthropic 호환 형식으로 연결 [02:03]

• 실제 연결의 핵심은 OpenRouter API 키를 발급받아 Claude 설정에 넣고, 사용할 모델명을 명시하는 것이다.
• 즉, Claude Code 입장에서는 Anthropic 호환 인터페이스를 쓰되, 실제 백엔드는 OpenRouter를 통해 다른 모델로 우회하는 구조다.

6. 무료 모델 선택 기준과 파라미터 해석 [03:00]

• 발표자는 예시로 Mistral Small 3.1 24B를 선택하며, 파라미터 수를 모델 지식량을 가늠하는 감각적 지표로 설명한다.
• 다만 이 구간의 실무적 함의는 “큰 모델이 더 똑똑할 수 있다”가 아니라 “큰 모델이라고 무료 환경에서 항상 더 잘 굴러가지는 않는다”는 점으로 이어진다.

7. 첫 번째 테스트에서 드러난 무료 모델의 운영 리스크 [04:03]

• 설정 후 claude를 실행하자 선택한 무료 모델이 표시되지만, 간단한 인사 입력조차 오류로 이어지며 실제 병목이 드러난다.
• 이 장면은 무료 전략의 핵심 리스크가 성능 점수 부족만이 아니라, 사용자 몰림에 따른 실시간 가용성 저하라는 점을 보여준다.

8. 더 가벼운 무료 모델로 스위칭해 성공률을 높이는 방식 [04:49]

• 발표자는 곧바로 더 작은 무료 모델로 바꾸고 세션을 재실행해 정상 응답을 확보한다.
• 여기서 중요한 운영 원칙은 “최고 성능 모델 하나”를 고집하는 것이 아니라, 혼잡 시 즉시 갈아탈 수 있는 대체 모델 체계를 갖추는 것이다.

9. 프로젝트 설정과 전역 설정을 분리해 운영하는 방법 [05:44]

• 로컬 설정은 특정 프로젝트에서만 적용되므로, 기본 터미널에서 claude를 실행하면 기존 Claude Pro 기반 모델이 그대로 남아 있을 수 있다.
• 따라서 실험용 모델은 프로젝트별로, 기본 운영 모델은 전역 설정으로 나눠 관리해야 디버깅과 작업 문맥 전환이 쉬워진다.

10. 운영체제별 글로벌 설정 변경과 원복 전략 [06:13]

• Mac/Linux와 Windows는 전역 settings.json 파일에 접근하는 방식이 다르지만, 넣어야 할 설정 블록 자체는 동일하다.
• 이 파일을 수정하면 어느 폴더에서 실행하든 같은 OpenRouter 모델을 기본값으로 쓸 수 있고, 필요하면 블록 삭제만으로 원래 Claude Pro 환경으로 되돌릴 수 있다.

11. 벤치마크 격차와 실사용 타협점 [07:41]

• 무료 모델의 intelligence·coding·agentic 지표는 Claude Opus 4.6보다 확실히 낮아, 고난도 코딩 작업에서는 격차가 클 가능성이 높다.
• 그럼에도 무료 모델의 전략적 가치는 “최고 성능 대체”가 아니라 “저비용 기본 작업 처리 + 필요 시 상위 모델 전환”이라는 역할 분담에 있다.

12. MiniMax를 저가 유료 백업으로 두는 이유 [08:37]

• 발표자는 MiniMax를 Opus 대비 훨씬 낮은 가격에 꽤 강한 코딩 성능을 제공하는 대안으로 제시한다.
• 이 비교가 말하는 바는 완전 무료 고집보다, 소액 비용으로 실패율을 낮추는 백업 체계를 두는 편이 전체 예산 효율과 작업 연속성 측면에서 더 현실적이라는 점이다.

13. 실전 운영 팁: 무료 우선, 소액 크레딧 백업 [09:56]

• 무료 모델은 시간대에 따라 막히거나 불안정할 수 있으므로, OpenRouter에 5~10달러 수준의 크레딧을 미리 넣어 두라는 조언이 나온다.
• 이렇게 해두면 무료 경로가 막혔을 때 MiniMax나 다른 대체 모델로 즉시 넘어갈 수 있어, 세션 중단 없이 작업을 이어가기 쉽다.

✅ 액션 아이템

• 현재 가장 자주 쓰는 Claude Code 프로젝트 1개를 골라 로컬 설정에 OpenRouter API 키와 무료 모델 1개를 먼저 붙이고, 동일 프롬프트 5회 테스트로 응답 성공률과 평균 지연을 기록한다.
• 무료 모델 3개를 후보로 정해 같은 코드 수정 작업을 반복 실행하고, 성공률·출력 품질·세션 끊김 빈도를 기준으로 주력 1개와 백업 1개를 확정한다.
• 프로젝트 로컬 설정과 전역 settings.json을 분리 운영하는 규칙을 문서화해, “실험용은 로컬, 기본 운영은 전역” 원칙이 실제 팀 환경에서도 재현되게 만든다.
• OpenRouter 크레딧에 소액을 충전한 뒤 MiniMax 같은 저가 유료 모델을 백업으로 등록하고, 무료 모델 실패 시 어떤 조건에서 자동 또는 수동 스위칭할지 기준을 정한다.
• 리팩터링, 다단계 에이전트 작업, 단순 질의응답을 각각 한 번씩 돌려 무료 모델이 감당 가능한 작업 범위와 상위 모델 투입 기준을 작업 유형별로 나눈다.

❓ 열린 질문

• OpenRouter 무료 모델의 벤치마크 격차는 실제 Claude Code의 파일 수정 성공률, 재시도 횟수, 툴 호출 안정성에서 어느 정도까지 선형적으로 반영될까?
• 프로젝트 로컬 설정과 전역 설정을 함께 쓰는 환경에서, 특정 프로젝트만 다른 모델을 강제할 때 우선순위 충돌이나 디버깅 혼선은 얼마나 자주 발생할까?
• MiniMax 같은 저가 유료 모델은 단발성 응답 품질뿐 아니라 긴 세션 유지, 컨텍스트 누적, 에이전트형 작업 완주율에서도 무료 모델 대비 의미 있는 우위를 보일까?
• 무료 모델 혼잡은 단순 시간대 문제인지, 아니면 특정 공급자·모델군의 구조적 가용성 문제인지 로그를 장기간 쌓아보면 어떤 패턴이 드러날까?