Molayo

© 2026 Molayo

GH Trending릴리즈2026. 04. 24. 13:42

Alishahryar1/free-claude-code

요약

본 프로젝트는 Claude Code가 Anthropic API를 호출할 때 사용하는 트래픽을 NVIDIA NIM, OpenRouter, DeepSeek, LM Studio 등 다양한 백엔드 제공업체로 라우팅하는 경량 프록시입니다. 이 프록시는 40 req/min 무료 할당(NVIDIA NIM 기준) 및 로컬 모델 사용을 통해 API 비용 부담 없이 Claude Code의 기능을 활용할 수 있게 합니다. 환경 변수 설정만으로 기존 Claude Code CLI나 VSCode 확장 프로그램에 수정 없이 적용 가능하며, 복잡한 속성 처리(

핵심 포인트

  • NVIDIA NIM을 이용해 분당 40회 요청까지 무료로 API를 사용할 수 있습니다.
  • OpenRouter, DeepSeek, LM Studio 등 5가지 이상의 다양한 백엔드 제공업체를 지원합니다.
  • 환경 변수 설정만으로 Claude Code CLI 및 VSCode 확장 프로그램에 수정 없이 적용 가능합니다 (Drop-in Replacement).
  • Opus/Sonnet/Haiku 모델별로 다른 API 제공업체(Provider)를 자유롭게 혼합하여 사용할 수 있습니다.

Claude Code의 Anthropic API 호출을 라우팅하는 경량 프록시

이 프로젝트는 Claude Code의 Anthropic API 호출을 NVIDIA NIM (40 req/min 무료), OpenRouter (수백 개의 모델), DeepSeek (직접 API), LM Studio (완전 로컬), 또는 llama.cpp (Anthropic 엔드포인트를 사용한 로컬) 등 다양한 제공업체로 라우팅하는 경량 프록시를 제공합니다.

✨ 주요 기능

  • 무료 비용: NVIDIA NIM에서 40 req/min 무료 제공. OpenRouter에서 무료 모델 이용 가능. LM Studio에서는 완전 로컬 환경 지원.
  • 드롭인 대체(Drop-in Replacement): 환경 변수(env vars) 2개만 설정하면 됩니다. Claude Code CLI나 VSCode 확장 프로그램 수정이 필요 없습니다.
  • 5가지 제공업체: NVIDIA NIM, OpenRouter, DeepSeek, LM Studio (로컬), llama.cpp (llama-server).
  • 모델별 매핑(Per-Model Mapping): Opus / Sonnet / Haiku를 다른 모델 및 제공업체로 라우팅할 수 있습니다. 여러 제공업체를 자유롭게 혼합하여 사용할 수 있습니다.
  • 사고 토큰 지원(Thinking Token Support): <think> 태그와 reasoning_content를 네이티브 Claude 사고 블록으로 파싱합니다.
  • 휴리스틱 도구 파서(Heuristic Tool Parser): 텍스트로 도구 호출을 출력하는 모델의 출력을 구조화된 도구 사용(structured tool use)으로 자동 파싱합니다.
  • 요청 최적화(Request Optimization): 사소한 API 호출 5가지 카테고리를 로컬에서 가로채어 할당량(quota)과 지연 시간(latency)을 절약합니다.
  • 스마트 속도 제한(Smart Rate Limiting): 사전 예방적 롤링 윈도우 스로틀(rolling-window throttle) + 반응형 429 지수 백오프(exponential backoff) + 선택적 동시성 제한(concurrency cap).
  • Discord / Telegram 봇: 트리 기반 스레딩, 세션 지속성, 실시간 진행 상황을 갖춘 원격 자율 코딩 기능을 제공합니다.
  • 서브 에이전트 제어(Subagent Control): 작업 도구 가로채기(Task tool interception)는 run_in_background=False를 강제하여 무분별한 서브 에이전트 실행을 방지합니다.
  • 확장성(Extensible): 깔끔한 BaseProvider 및 MessagingPlatform ABCs(Abstract Base Classes). 새로운 제공업체나 플랫폼을 쉽게 추가할 수 있습니다.

🔑 시작하기

API 키 및 로컬 설정

  • API 키를 받거나 (또는 LM Studio / llama.cpp로 로컬 사용):
    • NVIDIA NIM: build.nvidia.com/settings/api-keys
    • OpenRouter: openrouter.ai/keys
    • DeepSeek: platform.deepseek.com/api_keys
    • LM Studio: API 키가 필요하지 않습니다. LM Studio로 로컬 실행합니다.
    • llama.cpp: API 키가 필요하지 않습니다. llama-server를 로컬에서 실행합니다.

🚀 설치

  1. Claude Code 설치:

pip install uv

   *(이미 `uv`가 설치되어 있다면, 최신 버전을 받으려면 `uv self update`를 실행하세요.)*

2. **리포지토리 클론 및 설정:**
   ```bash
git clone https://github.com/Alishahryar1/free-claude-code.git
cd free-claude-code
cp .env.example .env
  1. 제공업체를 선택하고 .env 파일 편집:

NVIDIA NIM (40 req/min 무료, 권장)

NVIDIA_NIM_API_KEY=

AI 자동 생성 콘텐츠

본 콘텐츠는 GitHub Trending Python (daily)의 원문을 AI가 자동으로 요약·번역·분석한 것입니다. 원 저작권은 원저작자에게 있으며, 정확한 내용은 반드시 원문을 확인해 주세요.

원문 바로가기
8

댓글

0