본문으로 건너뛰기

트렌딩 - GitHub 인기 레포 & HuggingFace 모델

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 인자는 기존 방식대로 전달되어 기존 워크플로와 호환된다.

이미지 분석

터미널에서 Claude Code 에이전트가 Free Claude Code 프록시를 통해 작동하는 스크린샷으로, 에이전트의 탐색·플래닝 로그가 표시되어 있다.
이미지는 Claude Code 세션이 프록시와 통신하면서 코드베이스 탐색(agent exploration) 작업을 수행하는 실행 로그를 캡처하고 있다. 로그에는 에이전트들이 아키텍처·클래스 설계·데드 코드 검색 같은 하위 작업을 병렬로 수행한 사용 기록과 각 탐색의 토큰 사용량이 표기되어 있어 프록시를 이용한 복합 작업 흐름과 토큰 소비 관찰이 가능하다. 이 화면은 FCC가 에이전트 작업의 플로우와 상태를 중계하면서도 클라이언트 쪽 행위를 유지한다는 역할을 시각적으로 전달한다.
Codex CLI가 Free Claude Code의 로컬 Responses 제공자를 통해 모델 목록을 수집하고 디렉터리 트리 조회 명령을 실행한 스크린샷이다.
스크린샷은 Codex가 FCC의 로컬 제공자와 통신하여 파일 트리 및 모델 카탈로그를 조회하는 과정을 보여준다. 상단의 경고 문구는 특정 모델 메타데이터가 누락되어 폴백 메타데이터로 전환되었다는 메시지를 포함하고 있어 프록시가 외부 모델 메타데이터 의존성 문제를 중개할 수 있음을 보여준다. 이 이미지는 Codex와 FCC 간의 호환성 및 일부 모델에서 메타데이터 결손이 발생할 수 있는 현실적 제약을 드러낸다.
Claude Code의 /model 선택기가 FCC가 노출한 게이트웨이 모델 목록을 표시하는 스크린샷이다.
이미지에는 Claude Code 네이티브 모델 선택 UI가 FCC 카탈로그 항목을 나열하는 모습이 포착되어 있어 클라이언트의 네이티브 UI가 프록시의 모델 목록을 그대로 사용할 수 있음을 시각적으로 확인할 수 있다. 선택 목록에는 여러 open_router/google/gemma 계열 모델 항목이 보이며 사용자가 키보드로 선택을 확정할 수 있는 인터페이스가 유지되어 있음을 보여준다. 이 화면은 FCC가 모델 탐색과 선택 경험을 클라이언트 측 UI에 투명하게 통합하는 방식을 전달한다.
Codex의 /model 선택기가 FCC가 생성한 모델 카탈로그 항목을 보여주는 스크린샷으로, 현재 선택된 모델 표시가 포함되어 있다.
이미지는 Codex가 FCC를 통해 제공되는 여러 모델 옵션을 인식하여 선택 상태를 표시하는 장면을 보여준다. 목록에는 nvidia_nim 계열 모델과 기타 로컬/클라우드 제공자 모델이 혼재해 있어 FCC가 다양한 소스의 모델을 하나의 카탈로그로 통합하는 동작을 확인할 수 있다. 이 화면은 Codex와 FCC의 통합이 모델 선택 경험을 보존하면서도 백엔드 호환성을 제공한다는 기능적 증거를 제공한다.

49.8k

STARS

8.1k

FORKS

+207

TRENDING

88

조회수

watchers 49.8kopen issues 352MIT License

관련 토론

아직 관련 토론이 없습니다.

댓글

댓글을 작성하려면 로그인이 필요합니다.