Claude Code를 영원히 무료로 쓰는 방법

BBetter Stack
컴퓨터/소프트웨어AI/미래기술

스크립트

00:00:00Claude Code는 확실히 훌륭하지만, 사소한 작업마다 프리미엄 모델 비용을 지불하는 건
00:00:05부담이 될 수 있습니다. 4만 8천 개의 별을 받은 이 오픈소스 프로젝트를 사용하면 Claude Code, Codex
00:00:10또는 Pi를 유지하면서 밑단에 있는 모델을 무료, 저렴한 모델, 혹은 완전한 로컬 모델로 바꿀 수 있습니다.
00:00:16완벽하게 들리겠지만, Claude가 없는 Claude Code는 완전히 다른 이야기입니다.
00:00:20그래서 직접 설치하고 실제로 어떻게 작동하는지 테스트해 봤습니다.
00:00:28이것이 바로 Free Claude Code입니다. 네, 이름 참 별나죠? 저도 동의합니다.
00:00:33물론 이 도구가 Claude Code를 대체하는 것은 아닙니다. Codex나 Pi를 대체하지도 않죠.
00:00:40기존 클라이언트는 그 자리에 그대로 있고, 터미널 작업 방식도 익숙하게 유지됩니다.
00:00:45파일 수정, 도구 호출, 프로젝트 액세스 같은 기능은 그대로 유지됩니다. Free Claude Code는 그 중간에 위치합니다.
00:00:52Claude Code가 Anthropic과 직접 통신하는 대신, 동일한 요청을 다른 곳으로 보낼 수 있게 해줍니다.
00:00:57하지만 인터페이스는 그대로 유지됩니다. 무료 제공자나 더 저렴한 모델,
00:01:02심지어 내 컴퓨터에서 로컬로 실행되는 모델을 사용하여 에이전트는 그대로 유지할 수 있죠.
00:01:07배후에 있는 두뇌만 선택하면 되는 겁니다.
00:01:09코딩 도구를 즐겨 사용하고 워크플로를 가속하고 싶다면 꼭 구독해 주세요.
00:01:12유익한 영상이 계속해서 업로드됩니다.
00:01:14좋습니다. 현재 저는 Mac M4 Pro 환경에 있습니다.
00:01:16먼저 설치 스크립트를 실행한 다음, fcc 서버로 프록시를 시작해 보겠습니다.
00:01:22기본적으로 이게 전부입니다. 로컬 서버가 실행되고, 사용할 모델을 설정할 수 있는 관리자 인터페이스가 나타납니다.
00:01:31이 시점에서 Claude Code 자체는 전혀 바뀐 게 없습니다.
00:01:34단지 에이전트와 모델 사이에 새로운 경로를 하나 만들었을 뿐이죠.
00:01:37이제 그 경로의 반대편에 무언가를 배치해야 합니다.
00:01:39이번 테스트에서는 무료 제공자를 사용해 보겠습니다.
00:01:43NVIDIA NIM, 무료 OpenRouter 모델, 또는 이미 이곳에서 지원하는 다른 모델 중 하나가 될 수 있겠죠.
00:01:50그냥 하나 생성하면 됩니다.
00:01:52저는 이번에 NVIDIA를 선택했습니다.
00:01:53키를 추가하고, 모델을 선택한 다음 저장하기만 하면 됩니다.
00:01:56여기서 할 일은 정말 이게 전부입니다.
00:01:58이제 프록시 뒤에 무료 모델이 배치되었습니다.
00:02:01설정은 쉬운 부분이었죠.
00:02:03더 어려운 질문은 과연 Claude Code가 이 상태로 유용한 작업을 수행할 수 있는가 하는 점입니다.
00:02:07자, 그럼 'fcc claude'를 통해 Claude Code를 실행해 보겠습니다.
00:02:11바로 이 부분이 혼란스러운 지점인데, 최소한 제겐 아무것도 달라진 게 없어 보이기 때문입니다.
00:02:15말 그대로 모든 게 완전히 똑같아 보입니다.
00:02:18동일한 Claude Code 인터페이스와 동일한 프로젝트 설정.
00:02:21사용할 수 있는 도구도 같습니다.
00:02:22말 그대로 모든 것이 똑같습니다.
00:02:24심지어 상단을 보면 여전히 Opus 5라고 적혀 있어서 머리를 긁적이게 만들죠.
00:02:30하지만 실제로는 Claude가 이 요청 중 그 어떤 것도 처리하고 있지 않을 수 있습니다.
00:02:33모델 상태를 확인해 보면 Opus가 여전히 기본값으로 설정되어 있습니다.
00:02:37즉, Claude Code 자신은 여전히 Anthropic의 Opus 모델과 통신하고 있다고 믿고 있는 겁니다.
00:02:42하지만 현실에서는 Free Claude Code가 그 요청을 가로채서 관리자 UI에 설정된 모델로 라우팅합니다.
00:02:49그래서 저는 NVIDIA를 사용했습니다.
00:02:51여기 작동은 하지만 비동기 로직이 지저분하고 에러 처리가 형편없는 React 컴포넌트가 하나 있습니다.
00:02:57여기에 요청을 던져보겠습니다.
00:02:59"이 컴포넌트를 리팩터링하고, 적절한 에러 처리를 추가하고, 비동기 로직을 정리해 줘. 기존 동작은 바꾸지 말고."
00:03:07자, 이제 이게 실제로 쓸모가 있는지 확인해 보겠습니다.
00:03:10프로젝트를 읽고, 컴포넌트를 검사하고, 코드를 수정합니다. 일반적인 Claude Code에서 기대할 수 있는 것과 똑같은 작업 흐름이죠.
00:03:20이제 작업이 끝났습니다.
00:03:21로딩 상태가 깔끔해졌고, 에러 경로도 적절히 처리되었으며, 원래의 기능도 그대로 유지되었습니다.
00:03:26따라서 이 작업에 한해서는 잘 작동합니다.
00:03:28하지만 이것도 핵심적인 시사점 중 하나입니다.
00:03:30흥미로운 점은 다른 무료 모델도 코드를 편집할 수 있다는 사실 그 자체에 있지 않습니다.
00:03:34그건 이미 꽤 오래전부터 가능했죠.
00:03:36흥미로운 점은 이 모든 걸 쓰기 위해 내 작업 방식을 바꿀 필요가 전혀 없었다는 것입니다.
00:03:40나는 늘 쓰던 대로 Claude Code를 쓰고 있고,
00:03:42여전히 Claude Code를 사용하고 있으니까요.
00:03:44정말 그럴까요?
00:03:45코딩 에이전트에 요청하는 작업 중 굳이 Opus 5까지는 필요 없는 작업이 얼마나 많은지 생각해 보세요.
00:03:50이름 몇 개 바꾸기, 보일러플레이트 작성, 파일 설명하기 등등.
00:03:54이런 작업들은 모두 아주 단순한 작업들입니다.
00:03:57이러한 요청 중 하나가 프리미엄 모델로 향한다면, 무료 모델로도 충분히 해낼 수 있는 평범한 작업에 프리미엄 비용을 지불하고 있는 셈입니다.
00:04:05이 설정을 사용하면 그런 작업들은 더 저렴한 곳으로 보낼 수 있습니다.
00:04:07앞서 말했듯이 완전히 무료인 곳으로 말이죠.
00:04:09그리고 정말로 고성능 모델이 필요한 순간을 위해 강력한 모델들을 아껴둘 수 있습니다.
00:04:13자, Claude Code의 인터페이스를 유지한다고 해서 로컬 모델이 마법처럼 더 좋아지는 것은 아닙니다.
00:04:18모델이 도구 계획이나 긴 작업에서 고전한다면, Claude Code라는 멋진 인터페이스가 그 한계를 구해주진 못합니다.
00:04:25이 점은 그것을 실행하는 순간 곧바로 체감하게 될 것입니다.
00:04:29제가 보기에 더 흥미로운 워크플로는 바로 이런 것입니다.
00:04:31모든 작업에 하나의 모델만 고집하지 마세요.
00:04:33작업이 어려울 때는 더 강력한 모델을 쓰고, 아닐 때는 무료나 더 저렴한 모델을 사용하는 것입니다.
00:04:37우리 중 많은 이들이 이미 이렇게 하고 있죠?
00:04:39Free Claude Code는 친숙한 인터페이스를 유지하면서 정확히 그러한 용도의 계층형 라우팅을 제공합니다.
00:04:45새로운 걸 배울 필요가 전혀 없습니다.
00:04:47그냥 Claude Code를 쓰면 됩니다.
00:04:48이제 Anthropic 모델이 아닌 다른 모델들도 선택할 수 있게 된 것이죠.
00:04:51자, 여기서 당연한 의문이 듭니다. '그냥 OpenRouter를 쓰면 되지 않나요?'
00:04:55그것도 물론 대안이 될 수 있습니다.
00:04:57하지만 그것은 완전히 다른 문제를 해결하는 방식입니다.
00:04:59OpenRouter는 일반적인 라우팅 레이어입니다.
00:05:02공통 API 뒤에서 수많은 모델에 접근할 수 있게 해 주죠.
00:05:06반면 Free Claude Code는 코딩 에이전트에 훨씬 더 초점을 맞추고 있으며, 특히 기존 클라이언트들이 원래 설계되지 않았던 모델들과도 작동하도록 만드는 데 집중합니다.
00:05:14따라서 "자, 완전히 새로운 코딩 에이전트가 있으니 이걸 배우세요"라고 말하는 대신,
00:05:18"이미 좋아하는 에이전트인 Claude Code를 그대로 유지하세요"라고 말하는 셈입니다.
00:05:22이것은 훨씬 더 작은 변화입니다.
00:05:24그리고 일상적인 업무에서는 이러한 작은 변화가 실제로 계속 사용하게 되는 요인이 되곤 합니다.
00:05:28이런 관점에서 생각해보면 라우팅 기능도 훨씬 더 납득이 갑니다.
00:05:32다양한 모델 계층, 폴백, 다양한 제공자, 그리고 작업에 따른 맞춤형 모델 선택까지.
00:05:37모든 요청이 무조건 똑같이 비싼 모델로 향하는 대신 말이죠.
00:05:42이제 작업이 어디로 향할지 우리가 어느 정도 통제할 수 있게 됩니다.
00:05:45이것이 진정한 가치입니다.
00:05:47Claude를 공짜로 쓴다는 의미가 아닙니다. 그랬다가는 큰 오산이니까요.
00:05:50진짜 Claude 수준의 지능이 필요한 순간과, 단순히 습관 때문에 비용을 지불하고 있는 순간을 구분하는 것입니다.
00:05:56자, 그럼 과연 제가 Free Claude Code를 실제로 쓸까요?
00:05:58글쎄요, 잘 모르겠습니다.
00:06:00가지고 놀기엔 재미있었습니다.
00:06:01취지는 충분히 이해합니다.
00:06:03저는 늘 Claude Code를 사용하니까요.
00:06:04따라서 새로운 인터페이스를 배우고 싶지 않다는 점은 일리가 있습니다.
00:06:07그건 타당해요.
00:06:08Max 구독을 이용 중이라면, 한계치에 끊임없이 부딪히는 게 아닌 이상 아마 신경도 쓰지 않을 겁니다.
00:06:13하지만 Claude 기본 구독을 사용 중이고 Claude Code를 잘 이해하고 있다면, 이게 훨씬 더 나을 수도 있습니다.
00:06:19이미 아는 방식을 계속 쓰면서도, 수많은 부하 작업에는 다른 모델로 전환할 수 있으니까요.
00:06:23그렇다고 이걸로 Claude를 완전히 대체하진 않겠습니다.
00:06:26더 저렴한 플랜을 쓰고 있다면 Claude가 낭비되는 것을 막는 용도로 쓸 겁니다.
00:06:30그러다 엄청난 버그나 강력한 추론 능력이 꼭 필요한 작업에 부딪히면, 그때 더 좋은 모델에 돈을 쓰는 거죠.
00:06:36몇 푼 아끼는 건 쉽습니다.
00:06:38더 저렴한 모델이 한 시간 동안 수습해야 할 뒷일을 만들어내기 전까지만 말이죠.
00:06:40결국 그 시점에서는 토큰 비용보다 신뢰성이 훨씬 더 중요해집니다.
00:06:43그리고 바로 거기에 선을 그어야 합니다.
00:06:45그러므로 이건 진짜 Free Claude Code가 아닙니다.
00:06:48그것보다 훨씬 유용하지만, 결국 우리가 얻는 건 그 인터페이스뿐입니다.
00:06:52두뇌를 선택할 수 있는 Claude Code인 셈이죠.
00:06:54필요한 모든 링크는 아래에 남겨두었습니다.
00:06:56이와 같은 코딩 팁과 트릭이 마음에 드셨다면 BetterStack 채널을 꼭 구독해 주세요.
00:07:00다음 영상에서 뵙겠습니다.

핵심 요약

Free Claude Code는 기존 Claude Code의 익숙한 인터페이스와 워크플로를 유지하면서 백엔드 모델을 무료 또는 저렴한 모델로 라우팅하여 단순 반복 작업의 프리미엄 비용을 절감하는 도구이다.

하이라이트

  • Free Claude Code는 기존 Claude Code 인터페이스와 터미널 작업 방식을 그대로 유지하면서 밑단 모델만 무료 또는 저렴한 모델로 교체해 주는 프록시 도구이다.

  • Mac M4 Pro 환경에서 설치 스크립트 실행 후 fcc 서버로 프록시를 시작하고 관리자 인터페이스에서 NVIDIA NIM이나 OpenRouter 같은 무료 모델을 설정할 수 있다.

  • Opus 같은 프리미엄 모델이 불필요한 이름 변경, 보일러플레이트 작성, 파일 설명 등의 단순 작업에 프리미엄 비용을 지불하는 것을 방지한다.

  • OpenRouter는 일반적인 API 라우팅 레이어인 반면, Free Claude Code는 코딩 에이전트에 특화되어 기존 클라이언트와 호환되도록 설계되었다.

  • 복잡한 버그 수정이나 강력한 추론 능력이 필요한 작업에서는 저렴한 모델의 한계로 인해 신뢰성이 떨어질 수 있으므로 적절한 모델 선택이 중요하다.

타임라인

Free Claude Code의 개념과 작동 원리

  • 사소한 작업마다 프리미엄 모델 비용을 지불하는 부담을 줄이기 위해 밑단 모델을 무료나 로컬 모델로 바꿀 수 있다.
  • 기존 Claude Code 인터페이스, 터미널 작업 방식, 파일 수정, 도구 호출 기능은 그대로 유지된다.
  • Anthropic과 직접 통신하는 대신 요청을 가로채 다른 제공자로 라우팅하는 중간 프록시 역할을 한다.

Claude Code는 훌륭하지만 모든 요청에 프리미엄 모델 비용을 지불하는 것은 부담이다. 이 오픈소스 프로젝트는 클라이언트와 터미널 환경을 그대로 둔 채 백엔드 두뇌만 교체할 수 있게 해 준다.

설정 방법과 무료 모델 연동 테스트

  • 설치 스크립트를 실행하고 fcc 서버로 프록시를 시작하면 관리자 인터페이스가 나타난다.
  • NVIDIA NIM 또는 무료 OpenRouter 모델의 API 키를 추가하고 모델을 선택하여 저장할 수 있다.
  • 상단에 Opus 5라고 표시되더라도 Free Claude Code가 요청을 가로채 설정된 모델로 처리한다.

Mac M4 Pro 환경에서 설치를 진행하고 NVIDIA 모델을 연동하여 지저분한 React 컴포넌트 리팩터링 요청을 테스트한 결과, 로딩 상태 정리와 에러 처리 등 일반 Claude Code와 동일한 작업 흐름이 정상적으로 수행된다.

계층형 라우팅의 효용과 한계

  • 이름 변경이나 보일러플레이트 작성 같은 단순 작업은 무료 모델로 처리하고 고성능 모델은 아껴둘 수 있다.
  • OpenRouter가 일반적인 API 라우팅 레이어라면 Free Claude Code는 코딩 에이전트에 집중하여 기존 클라이언트의 호환성을 유지한다.
  • 복잡한 작업에서 저렴한 모델이 고전할 경우 토큰 비용보다 신뢰성이 더 중요해지므로 상황에 맞는 모델 선택이 필수적이다.

작업의 난이도에 따라 모델을 다르게 선택하는 계층형 라우팅이 진정한 가치를 지닌다. 다만, 모델 자체의 추론 한계가 인터페이스로 극복되지는 않으므로 복잡한 버그 상황에서는 신뢰성을 위해 강력한 모델을 사용해야 한다.

커뮤니티 글

아직 글이 없습니다. 이 영상에 대한 첫 번째 글을 작성해 보세요!

이 영상에 대해 글쓰기