Rishurajgautam24/free-claude-code

해결하는 문제

이 프로젝트는 공식 Anthropic API 키 없이도 Claude Code CLI 및 VSCode 확장을 사용할 수 있는 방법을 제공합니다. 이 프로젝트는 경량 프록시 역할을 하여 NVIDIA NIM과 같은 무료 티어, LM Studio 또는 Ollama를 통한 로컬 모델, 기타 OpenAI 호환 서비스를 포함한 다양한 대체 LLM 제공업체로 요청을 라우팅합니다.

작동 방식

이 프로젝트는 로컬 프록시 서버를 실행하여 Claude Code 클라이언트로부터의 API 호출을 가로챕니다. 이러한 요청을 Anthropic의 형식에서 대부분의 다른 LLM 제공업체가 사용하는 OpenAI 호환 형식으로 변환합니다. 모델 매핑을 처리하고, 모델 실패 시 폴백 체인을 관리하며, 할당량을 절약하기 위해 사소한 API 호출을 최적화하고, 사고 토큰(thinking tokens) 및 이미지 입력과 같은 기능이 대상 모델에 맞게 올바르게 변환되도록 보장합니다.

대상 사용자

Claude Code 에이전트 워크플로우를 사용하고 싶지만 Anthropic의 유료 API에 종속되지 않고 더 저렴하거나 로컬 LLM 백엔드를 사용하려는 개발자를 위한 것입니다.

주요 특징

• 제로 비용 옵션: NVIDIA NIM 및 OpenRouter와 같은 제공업체의 무료 티어 또는 LM Studio 및 Ollama를 통한 완전한 로컬 실행을 지원합니다.
• 드롭인 호환성: Claude Code CLI나 VSCode 확장을 수정할 필요 없이 투명한 프록시로 작동합니다.
• 고급 라우팅: 모델별 매핑, 안정성을 위한 폴백 체인, 세션 중에 백엔드를 전환할 수 있는 모델 선택기를 지원합니다.
• 기능 동등성: 사고 블록, 도구 호출, 이미지 입력과 같은 Claude 고유 기능을 다른 모델과 호환되도록 변환합니다.
• 원격 제어: 코딩 세션을 원격으로 관리하기 위한 Discord/Telegram 봇이 포함되어 있습니다.