Infinite Claude Code란 무엇인가?
Infinite Claude Code는 공식 Anthropic 클라이언트인 Claude Code CLI, Claude Desktop, 지원되는 IDE 확장 프로그램을 여러 OpenAI 호환 모델 제공업체 풀에 연결하는 종속성 없는 Node.js 프록시입니다. /v1/messages에서 Anthropic Messages API 요청을 받아 제공업체 형식으로 변환한 다음, 응답을 Anthropic 호환 실시간 Server-Sent Events로 다시 변환합니다.
이 프로젝트는 무료 클라우드 모델을 우선하며, 선택적으로 제공업체 인증 정보를 지원하고 로컬 Ollama 인스턴스로 대체할 수 있습니다. 프로젝트 README에 따르면 라우터는 빠르게 시작되고, 30 MB 미만의 RAM을 사용하며, 유휴 상태에서는 CPU를 사용하지 않습니다.
저장소에서는 사전 구성된 클라우드 풀을 무료로 사용할 수 있다고 설명합니다. 하지만 관련 외부 서비스에 따라 제공업체 이용 가능 여부, 요청 한도, 모델 액세스 권한 및 가격이 변경될 수 있으므로, 지속적인 작업에 사용하기 전에 각 제공업체의 최신 약관을 확인하세요.
라우터 작동 방식
로컬 라우터는 기본적으로 127.0.0.1:20129에서 수신 대기합니다. Claude Code가 이 엔드포인트로 Anthropic 형식의 요청을 보내면 Infinite Claude Code가 작업을 분류하고, 적합한 모델을 선택하며, 도구 호출을 변환한 뒤 결과를 클라이언트로 다시 스트리밍합니다.
Claude Code, Claude Desktop 또는 IDE 확장 프로그램이
/v1/messages로 요청을 보냅니다.의미 기반 분류기가 프롬프트와 사용 가능한 도구를 검사합니다.
디스패처가 우선순위 풀에서 제공업체와 모델을 선택합니다.
해당 제공업체를 사용할 수 없거나 요청 한도에 도달하면 라우터가 구성된 다른 제공업체로 전환합니다.
OpenAI 스타일 함수 호출이 Anthropic 도구 사용 메시지로 변환됩니다.
응답 토큰이 실시간 SSE 스트리밍을 통해 반환됩니다.
클라우드 경로를 사용할 수 없고 Ollama가 구성되어 있으면 라우터가 로컬 모델을 사용할 수 있습니다.
주요 기능
동시 서브에이전트 디스패치
Claude Code가 여러 서브에이전트 또는 백그라운드 세션을 시작하면 swarm 디스패처가 동시 요청을 여러 제공업체에 분산할 수 있으므로 모든 작업이 하나의 모델로 몰리지 않습니다. 이를 통해 단일 제공업체의 병목 현상과 요청 한도 초과 오류를 줄일 수 있습니다.
의미 기반 작업 라우팅
라우터는 예상 작업량에 따라 모델을 선택합니다. 문서화된 라우팅 전략은 아키텍처 작업에 Nemotron 120B 또는 Kimi K3 같은 추론 모델을, 코드 생성 및 파일 수정에 North Mini Code 또는 Qwen Coder 같은 코드 중심 모델을, 빠른 명령에는 Nemotron Lightning을 우선합니다.
도구 호출 복구
일부 오픈 웨이트 모델은 도구 인수에 잘못된 JSON을 생성합니다. Infinite Claude Code에는 Claude Code가 도구 호출을 실행하기 전에 이스케이프되지 않은 따옴표나 닫히지 않은 괄호 같은 문제를 복구하려는 AST 기반 정리기가 포함되어 있습니다.
자동 제공업체 장애 조치
이 프로젝트는 OpenRouter, NVIDIA NIM, OmniRouter, 9Router, Groq, Cerebras, Together AI, Google Gemini, Mistral AI, OpenAI, Anthropic 및 기타 선택적 서비스를 포함하는 우선순위 풀을 지원합니다. 실패하거나 요청 한도에 도달한 요청은 사용 가능한 다른 제공업체를 통해 재시도할 수 있습니다.
모니터링 대시보드
브라우저 기반 HUD에 활성 서브에이전트, 제공업체 활동, 생성된 토큰, 지연 시간 및 공식 Claude 3.7 Sonnet API 가격을 기준으로 추정한 절약 금액 카운터가 표시됩니다.
오프라인 대체 기능
Ollama는 qwen3:4b 또는 deepseek-r1 같은 모델을 통해 로컬 복원력을 제공할 수 있습니다. 로컬 성능과 도구 안정성은 선택한 모델과 하드웨어에 따라 달라집니다.
사전 요구 사항
Node.js 18 이상.
수동 설치 방법을 사용할 경우 Git.
Claude Code CLI, Claude Desktop 또는 호환 IDE 통합.
Windows에서는 PowerShell, macOS 및 Linux에서는 셸.
로컬 오프라인 대체 기능이 필요한 경우에만 Ollama.
프로젝트 자체에는 Python 환경이나 추가 Node.js 패키지가 필요하지 않습니다.
Infinite Claude Code 설치
옵션 1: Windows 한 줄 설치 프로그램
PowerShell을 열고 저장소의 설치 명령을 실행합니다.
& ([scriptblock]::Create((irm "https://raw.githubusercontent.com/juanitogit/infinite-claude-code/main/install.ps1")))이 명령은 원격 스크립트를 다운로드한 후 즉시 실행하므로, 보안 정책상 필요한 경우 먼저 install.ps1을 검토하세요.
옵션 2: Windows 수동 설치
git clone https://github.com/juanitogit/infinite-claude-code.git
cd infinite-claude-code
powershell -ExecutionPolicy Bypass -File .\install.ps1옵션 3: macOS 또는 Linux 설치
git clone https://github.com/juanitogit/infinite-claude-code.git
cd infinite-claude-code
chmod +x install.sh && ./install.sh설치 모드 선택
대화형 설치 프로그램은 두 가지 모드를 제공합니다.
빠른 설치: 선택적 제공업체 인증 정보를 묻지 않고 문서에 설명된 사전 구성 무료 티어를 설정합니다.
사용자 지정 설치: 추가 제공업체의 API 키를 입력하라는 메시지를 표시합니다. 구성하지 않을 제공업체는
Enter를 눌러 건너뛸 수 있습니다.
로컬 라우터 확인
저장소 디렉터리에서 서비스 상태를 확인합니다.
node bin/infinite-claude.js status정상적으로 설치되었다면 Infinite Claude Code가 활성 상태임을 보고하고, 로컬 URL을 http://127.0.0.1:20129로 표시하며, SSE 스트리밍을 확인하고 풀에서 활성화된 제공업체를 나열해야 합니다.
Infinite Claude Code가 활성 상태이며 정상 작동 중입니다!
URL: http://127.0.0.1:20129
스트리밍: 활성화됨 (SSE 실시간)
풀의 활성 프로바이더: ...서비스가 정상 작동하지 않는 경우 Node.js 18 이상이 설치되어 있는지, 다른 애플리케이션이 이미 포트 20129를 사용하고 있지 않은지 확인하세요.
Claude Code 실행
라우터가 실행되고 설치 프로그램이 클라이언트를 구성하면 Claude Code를 평소처럼 실행하세요.
claude그런 다음 대화형 세션에서 코딩 요청을 입력할 수 있습니다.
이 프로젝트를 검사하고, 아키텍처를 설명하며, 가장 안전한 첫 번째 리팩터링 작업을 식별하세요.요청은 로컬 프록시를 통해 라우팅되며, 응답은 생성되는 즉시 스트리밍되어 반환됩니다.
직접 작업 시도
Claude Code는 터미널에서 프롬프트를 직접 전달받을 수도 있습니다.
claude "인증 모듈을 검토하고 리팩터링 계획을 제안하세요"빈 대화형 세션으로 시작할 필요가 없는 집중 작업에 유용합니다. 모델 선택은 명령 자체가 아니라 Infinite Claude Code의 라우팅 로직에서 처리됩니다.
Cyber HUD에서 요청 모니터링
라우터가 활성 상태일 때 다음 로컬 주소를 여세요.
http://localhost:20129/hudHUD는 현재 세션에 대한 실시간 텔레메트리를 제공하며 다음 정보를 포함합니다.
각 요청을 처리하는 프로바이더
생성된 토큰 수
밀리초 단위의 요청 지연 시간
현재 활성화된 동시 서브에이전트 수
Claude 3.7 Sonnet API 요금을 기준으로 한 예상 절감액 카운터
이 대시보드를 사용해 요청이 구성된 풀 전체에 분산되고 있는지 확인하고, 지연 시간이 비정상적으로 높은 프로바이더를 찾아내세요.
프로바이더 및 환경 변수 구성
src/providers.js에서 프로바이더 정의를 사용자 지정하거나, 환경 변수를 통해 인증 정보와 엔드포인트를 제공할 수 있습니다. README에는 다음 변수가 문서화되어 있습니다.
OPENROUTER_API_KEY: 사용자 지정 OpenRouter 인증 정보입니다. 문서에 설명된 기본값은 사전 구성된 무료 티어를 사용합니다.NVIDIA_API_KEY: 사용자 지정 NVIDIA NIM 인증 정보입니다. 저장소에는 사전 구성된 NIM 키가 기본값으로 문서화되어 있습니다.OMNIROUTER_API_KEY: 사용자 지정 OmniRouter 인증 정보입니다.ROUTER9_API_KEY: 사용자 지정 9Router 인증 정보입니다.GROQ_API_KEY: 선택적 Groq 인증 정보입니다.TOGETHER_API_KEY: 선택적 Together AI 인증 정보입니다.OLLAMA_HOST: Ollama 엔드포인트이며 기본값은http://localhost:11434입니다.PORT: 로컬 프록시 포트이며 기본값은20129입니다.
예를 들어 macOS 또는 Linux 셸에서는 라우터를 시작하기 전에 다른 Ollama 호스트와 포트를 지정할 수 있습니다.
export OLLAMA_HOST="http://localhost:11434"
export PORT="20129"PowerShell에서는 다음과 같이 세션 변수를 설정합니다.
$env:OLLAMA_HOST = "http://localhost:11434"
$env:PORT = "20129"개인 API 키는 소스 관리 시스템 외부에 보관하세요. 비밀 정보가 포함된 셸 프로필, 환경 파일 또는 수정된 프로바이더 구성을 커밋하지 마세요.
로컬 폴백으로 Ollama 설정
Infinite Claude Code는 오프라인 또는 긴급 경로로 Ollama를 지원합니다. README에는 qwen3:4b와 deepseek-r1이 로컬 모델의 예시로 나와 있습니다.
Ollama를 별도로 설치하고 시작합니다.
Ollama 설치 환경에서 원하는 모델을 사용할 수 있도록 준비합니다.
OLLAMA_HOST를http://localhost:11434로 유지하거나 사용자 지정 엔드포인트로 변경합니다.상태 명령으로 Infinite Claude Code 라우터를 다시 확인합니다.
인터넷이 중단된 상황에서 로컬 폴백이 특히 유용하지만, 모델 속도, 컨텍스트 용량 및 코딩 품질은 로컬 모델과 사용 가능한 CPU, 메모리 또는 GPU 리소스에 따라 달라집니다.
자율 서브에이전트 실행
분할이 유용한 작업의 경우 Claude Code에 동시 서브에이전트를 생성하도록 명시적으로 요청하세요.
claude "이 작업을 나누고 동시 서브에이전트를 병렬로 사용해 전체 플랫폼을 구축하세요"문서화된 --bg 옵션을 사용해 백그라운드 작업을 실행할 수도 있습니다.
claude --bg "인증 모듈을 리팩터링하고 단위 테스트를 작성하세요"라우터는 동시에 실행되는 서브에이전트 호출을 별도의 프로바이더에 분산하도록 설계되었습니다. 작업이 실행되는 동안 HUD를 확인해 스웜 부하와 프로바이더 선택을 관찰하세요.
고급 팁
프로바이더 가용성에 맞춰 동시성 조정
프로젝트는 높은 수준의 동시성을 지원하지만 외부 프로바이더에는 자체 속도 제한이나 가용성 제한이 있을 수 있습니다. 대규모 백그라운드 작업을 시작하기 전에 HUD와 활성 프로바이더 목록을 확인하세요.
선택적 키를 사용해 풀 확장
사전 구성된 경로가 혼잡한 경우 Custom Install을 통해 Groq 또는 Together AI와 같은 프로바이더를 추가할 수 있습니다. 구성된 풀이 넓어지면 장애 조치 시스템에서 사용할 수 있는 경로가 늘어나지만, 각 선택적 서비스에는 별도의 할당량과 약관이 적용될 수 있습니다.
문제 해결 중 상태 명령 사용
Claude 클라이언트 자체를 디버깅하기 전에 node bin/infinite-claude.js status를 실행하세요. 이를 통해 로컬 라우터 문제인지 모델 프로바이더 또는 클라이언트 문제인지 빠르게 구분할 수 있습니다.
필요한 경우 포트 변경
포트 20129가 다른 서비스와 충돌하는 경우 PORT를 다른 값으로 설정하세요. 변경한 후 Anthropic 클라이언트 구성이 동일한 로컬 엔드포인트를 가리키는지 확인하세요.
프로바이더 구성 주의 깊게 검사
고급 사용자는 src/providers.js를 수정하여 모델을 사용자 지정할 수 있습니다. 예상되는 provider 형식을 유지하고, 동시 에이전트를 시작하기 전에 간단한 요청으로 변경 사항을 테스트하세요.
독점 코드 보호
클라우드로 라우팅되는 프롬프트에는 소스 코드, 도구 출력 또는 프로젝트 컨텍스트가 포함될 수 있습니다. 라우터를 기밀 저장소와 함께 사용하기 전에 활성화된 모든 provider의 개인정보 보호 및 데이터 처리 정책을 검토하세요. 작업을 로컬에서 유지해야 한다면 Ollama 경로를 우선 사용하세요.
결론
Infinite Claude Code는 Anthropic 클라이언트와 대규모 클라우드 또는 로컬 모델 풀 사이에 가벼운 번역 및 라우팅 계층을 제공합니다. 설치 프로그램을 실행한 후 서비스를 확인하고 claude를 실행한 다음 HUD를 사용하여 스트리밍, 장애 조치, 동시 하위 에이전트를 모니터링하세요. 선택적 provider 키와 Ollama를 사용하면 워크플로에 따라 모델 풀을 확장하거나 로컬 복원력을 추가할 수 있습니다.
이 프로젝트는 JuaneX가 유지 관리하며 MIT 라이선스에 따라 배포됩니다. 소스 코드와 설치 스크립트는 Infinite Claude Code 저장소에서 확인할 수 있습니다.