Alishahryar1/free-claude-code
코딩 AI 에이전트를 무료 모델 49곳에 자유롭게 연결해주는 로컬 프록시
free-claude-code(FCC)는 Claude Code, Codex, Pi, OpenCode 같은 코딩 에이전트가 실제로는 Anthropic 서버가 아니라 사용자가 고른 무료·저가 AI 모델 제공사와 통신하도록 중간에서 요청을 바꿔치기하는 로컬 프록시 도구다. 매달 13억 개 이상의 무료 토큰(모델에게 보낼 수 있는 글자 조각의 최대 사용량)을 제공하는 49개 제공사 중에서 관리자 화면(Admin UI)으로 모델을 고르면 터미널, VS Code, JetBrains, Discord, 텔레그램, 음성 입력까지 같은 방식으로 붙는다. 한 제공사가 장애를 일으키면 재시도 끝에 자동으로 다음 설정된 모델로 넘어가 작업이 끊기지 않는다.
무엇을 하는 레포인가
- Claude Code, Codex, Pi, OpenCode, Cline, Hermes, DeepSeek Harness, Grok Build, Muse Code 등 9개 코딩 에이전트를 하나의 모델 목록으로 통합해 실행
- NVIDIA NIM, OpenRouter, Groq, DeepSeek, Gemini, Ollama 등 49개 제공사에서 무료·유료·구독·로컬 모델을 골라 API 키만 입력하면 연결
- 자동 폴백 목록을 설정하면 한 모델이 실패해도 재시도 후 다음 모델로 넘어가 작업이 중단되지 않음
- RTK라는 도구와 FCC 자체 최적화로 터미널 출력에서 모델에 보내는 토큰 사용량을 최대 90%까지 줄임
- 로컬 Whisper나 NVIDIA NIM 음성 인식으로 음성 메모를 텍스트로 바꿔 에이전트에게 지시 가능
왜 중요한가
AI 코딩 비서를 매달 요금 걱정 없이 쓰고 싶은 개발자에게, 여러 무료 API를 직접 연동하는 번거로움 없이 한 곳에서 관리하고 서비스 장애에도 끊김 없이 작업을 이어갈 방법을 준다. 다만 각 제공사의 이용약관 범위 안에서 동작하도록 설계됐다는 점에서 계정 정지 위험을 줄이는 데 초점을 둔다.
이 레포의 용어
- 토큰 · AI 모델이 글을 처리할 때 세는 최소 단위, 요청·응답 분량을 재는 기준
- 프록시 · 클라이언트와 서버 사이에서 요청을 대신 받아 전달해주는 중계 서버
- Admin UI · FCC 설정을 웹 화면에서 관리하는 관리자 페이지
- ToS(이용약관) · 서비스 제공사가 정한 사용 규칙, 위반 시 계정이 정지될 수 있음
- 폴백(Fallback) 모델 · 주 모델이 실패했을 때 자동으로 대신 시도할 예비 모델 목록
레포 원문 소개 (영문)
Use Claude Code, Codex, Pi, and OpenCode for free (1.3B+ free tokens) from your terminal, app, IDE, or phone like OpenClaw (voice supported + ToS friendly)
GitHub에서 보기주목받는 레포
- vorssaint/vorssaint-utils메뉴바 아이콘 하나로 유료 맥 앱 열 개 값을 대신하는 오픈소스 도구
- freestylefly/awesome-gpt-image-2GPT-Image2로 원하는 이미지를 정확히 뽑아내는 프롬프트 설계도 532개를 모아놓은 저장소
- block/buzz사람과 AI 에이전트가 같은 채팅방에서 함께 일하는 오픈소스 협업 플랫폼
- NousResearch/hermes-agentNous Research가 만든, 쓰면 쓸수록 스스로 똑똑해지는 AI 에이전트 Hermes
- virgiliojr94/book-to-skill기술서 PDF를 AI 에이전트가 언제든 펼쳐볼 수 있는 '스킬'로 바꿔주는 도구
- VoltAgent/awesome-agent-skillsAI 코딩 도구가 특정 작업을 '전문가처럼' 하도록 도와주는 매뉴얼 1000개 이상을 한곳에 모았다
- anthropics/claude-plugins-community누구나 만든 Claude 확장 기능을 한곳에 모아 설치하게 해주는 저장소
- Comfy-Org/ComfyUI코드 한 줄 없이 그림 그리듯 이미지·영상·음성 AI를 조립하는 도구, ComfyUI