Alishahryar1/free-claude-code
Python88 / 0
로컬 프록시와 Admin UI로 Claude Code와 Codex를 터미널·VS Code·JetBrains에서 provider·local 모델로 실행하고 모델 라우팅을 지원한다.
TL;DR
Free Claude Code는 로컬 프록시 서버와 Admin UI를 통해 Claude Code와 Codex를 다양한 클라우드 제공자 또는 로컬 OpenAI 호환 서버에 연결하는 도구로, fcc-server로 로컬 프록시를 띄우고 fcc-claude 또는 fcc-codex를 실행해 네이티브 /model 선택기를 통해 FCC가 노출한 모델을 사용할 수 있다. 설치 스크립트는 필요한 런타임과 종속성을 점검하고 실패 시 즉시 중단하며 설치 후 Admin UI에서 각 제공자의 API 키와 MODEL을 검증해 적용하는 방식으로 동작한다. 모델 티어 라우팅과 에디터 통합(VS Code, JetBrains), 메시징/음성 전사 옵션을 통해 멀티모델 운영과 IDE 연동을 쉽게 구성할 수 있지만 각 제공자별 API 키와 로컬 서버 구동이 전제되어야 하며 일부 모델에서는 메타데이터 누락 같은 제약이 발생할 수 있다.
핵심 포인트
- 다수의 상용 및 로컬 제공자를 한곳에서 구성·검증하도록 Admin UI를 제공하여 사용자가 개별 클라이언트 설정을 직접 수정할 필요를 줄였다. README에는 NVIDIA NIM, OpenRouter, Gemini, Hugging Face, Ollama, llama.cpp 등 여러 제공자별 설정 예시와 검증 절차를 나열하여 즉시 적용 가능한 템플릿을 제공한다. 이 접근은 개별 제공자 API를 직접 다루는 수고를 줄여 통합 운영을 단순화한다.
- 클라이언트의 네이티브 /model 선택기와의 통합을 유지하여 사용자가 익숙한 워크플로를 그대로 사용할 수 있도록 설계되었다. README 예시는 Claude Code와 Codex의 네이티브 /model UI가 FCC가 노출하는 모델 카탈로그를 통해 동작하는 모습을 스크린샷과 설명으로 제시한다. 결과적으로 클라이언트 측 변경을 최소화하면서 프록시 기반 모델 전환을 가능하게 한다.
- 모델 티어 라우팅 기능을 제공하여 Opus·Sonnet·Haiku 같은 요청 레벨별로 서로 다른 모델을 지정할 수 있으므로 비용과 성능을 분리된 경로로 제어할 수 있다. 환경변수 기반 설정으로 특정 티어를 빈 칸으로 두면 기본 MODEL을 상속하도록 설계되어 유연한 설정이 가능하다. 이 기능은 멀티모델 운영에서 요청 특성에 따른 최적화를 쉽게 적용하도록 한다.
- 로컬 프록시와 Admin UI로 Claude Code와 Codex 런처를 시작할 수 있으며 fcc-server가 Admin UI 주소와 포트를 로그에 출력한다. 런처는 fcc-claude 및 fcc-codex 명령으로 실행되며 클라이언트 내에서 /model 명령을 통해 FCC가 노출하는 모델 카탈로그를 사용한다. CLI 인자는 기존 방식대로 전달되어 기존 워크플로와 호환된다.
이미지 분석




49.8k
STARS
8.1k
FORKS
+207
TRENDING
88
조회수
관련 토론
아직 관련 토론이 없습니다.
댓글
댓글을 작성하려면 로그인이 필요합니다.