ClaudeCode 모델 로테이터은(는) 무엇을 하나요?
동적 프록시를 통해 Claude Code를 로컬 Ollama 모델 및 OpenRouter에 연결하여 생태계 제한을 우회하고 무료 API를 사용하세요.
개요
ClaudeCode-Model-Rotator는 Claude Code가 선호하는 모델 제공자와 통신할 수 있도록 요청을 가로채고 리디렉션하는 프록시 서버를 제공합니다. 이를 통해 사용자는 Ollama를 사용한 로컬 모델 추론 또는 OpenRouter와 같은 서비스를 통한 무료 API 액세스 등 대체 모델을 활용할 수 있습니다.
기능
- 로컬 모델 지원: Ollama를 사용하여 모델을 로컬에서 실행합니다.
- 외부 API 지원: OpenRouter에 연결하여 다양한 무료 및 유료 모델에 액세스합니다.
- 동적 라우팅: 구성에 따라 요청을 자동으로 적절한 제공자로 라우팅합니다.
- 생태계 우회: Claude Code를 특정 제공자에 종속시키지 않고 사용할 수 있습니다.
설치
- 리포지토리를 클론합니다:
git clone https://github.com/tullextraterrestrial3175/ClaudeCode-Model-Rotator.git
cd ClaudeCode-Model-Rotator
- 필요한 종속성을 설치합니다:
npm install
- 환경 변수를 구성합니다:
cp .env.example .env
# .env 파일을 편집하여 API 키와 기본 설정을 추가하세요.
사용법
프록시 서버를 시작합니다:
npm start
그런 다음 Claude Code가 프록시를 통해 요청하도록 구성합니다. 일반적으로 다음 환경 변수를 설정하면 됩니다:
export CLAUDE_CODE_PROXY=http://localhost:3000
자세한 내용은 SKILL.md 설명서를 참조하세요.
구성
.env 파일을 편집하여 모델 제공자 및 라우팅 규칙을 지정합니다:
# Ollama 구성
OLLAMA_HOST=http://localhost:11434
OLLAMA_MODEL=llama2
# OpenRouter 구성
OPENROUTER_API_KEY=your-api-key
OPENROUTER_MODEL=openai/gpt-3.5-turbo
# 라우팅 규칙
DEFAULT_PROVIDER=ollama
문제 해결
- 프록시가 실행 중인지 확인하세요 (
npm start). - 환경 변수가 올바르게 설정되었는지 확인하세요.
- Ollama의 경우 서비스가 실행 중인지 확인하세요 (
ollama serve). - 네트워크 연결 및 방화벽 설정을 확인하세요.
라이선스
MIT