Molayo

© 2026 Molayo

GitHub요약2026. 05. 14. 13:19

StringKe/claudex

요약

Claudex는 지능형 번역 프록시를 갖춘 통합 Claude Code 관리자로, 다양한 AI 제공업체(Anthropic, OpenAI, Grok 등 20개 이상)와 Claude Code가 원활하게 연동되도록 합니다. 이 프록시는 자동 프로토콜 번역, 스트리밍 번역 지원, 그리고 서킷 브레이커 및 페일오버 기능을 통해 안정성을 극대화합니다. 또한 스마트 라우팅, 로컬 RAG를 위한 컨텍스트 엔진 등 고급 기능을 제공하여 개발 워크플로우의 유연성과 효율성을 높입니다.

핵심 포인트

  • 20개 이상의 AI 제공업체(Anthropic, OpenAI, Grok 등)를 지원하는 멀티-제공업체 프록시 역할을 수행합니다.
  • 자동 프로토콜 번역 및 스트리밍 번역을 통해 다양한 API 인터페이스 간의 호환성을 보장합니다.
  • 서킷 브레이커와 페일오버 기능을 내장하여 특정 제공업체의 장애 발생 시 자동으로 백업 시스템으로 전환됩니다.
  • 스마트 라우팅과 컨텍스트 엔진(로컬 RAG)을 활용하여 의도 기반의 최적화된 AI 서비스 이용이 가능합니다.
  • 다양한 설정 파일 형식(TOML, YAML) 및 환경 변수를 지원하며, CLI 명령어를 통해 프로필 관리와 프록시 실행이 용이합니다.

지능형 번역 프록시를 갖춘 멀티 인스턴스 Claude Code 관리자

English | 简体中文 | 繁體中文 | 日本語 | 한국어 | Русский | Français | Português do Brasil | Español | Italiano | Deutsch | Polski

Claudex는 자동 프로토콜 번역을 통해 Claude Code가 여러 AI 제공업체(providers)와 원활하게 작동할 수 있도록 하는 통합 프록시(proxy)입니다.

멀티 제공업체 프록시 (Multi-provider proxy)— DirectAnthropic 통과 + Anthropic <-> OpenAI Chat Completions 번역 + Anthropic <-> Responses API 번역
20개 이상의 제공업체 (20+ providers)— Anthropic, OpenRouter, Grok, OpenAI, DeepSeek, Kimi, GLM, Groq, Mistral, Together AI, Perplexity, Cerebras, Azure OpenAI, Google Vertex AI, Ollama, LM Studio 등
스트리밍 번역 (Streaming translation)— 도구 호출(tool call)을 지원하는 전체 SSE 스트림 번역
서킷 브레이커 + 페일오버 (Circuit breaker + failover)— 구성 가능한 임계값(thresholds)을 통한 백업 제공업체로의 자동 폴백(fallback)
스마트 라우팅 (Smart routing)— 로컬 분류기(classifier)를 통한 의도 기반 자동 라우팅
컨텍스트 엔진 (Context engine)— 대화 압축, 프로필 간 공유, 임베딩(embeddings)을 활용한 로컬 RAG
OAuth 구독 (OAuth subscriptions)— ChatGPT/Codex, Claude Max, GitHub Copilot, GitLab Duo, Google Gemini, Qwen, Kimi
설정 세트 (Configuration sets)— git 리포지토리에서 재사용 가능한 Claude Code 설정 세트를 설치 및 관리
TUI 대시보드 (TUI dashboard)— 실시간 프로필 상태, 메트릭(metrics), 로그 및 빠른 실행
자가 업데이트 (Self-update)— claudex update 명령어로 GitHub에서 최신 릴리스를 다운로드합니다.

# One-liner (Linux / macOS)
curl -fsSL https://raw.githubusercontent.com/StringKe/claudex/main/install.sh | bash
# From source
...
  • macOS (Intel / Apple Silicon) 또는 Linux (x86_64 / ARM64)
  • Claude Code 설치됨
  • Windows: Releases에서 빌드된 바이너리(binary) 다운로드
# 1. 설정 초기화
claudex config init
# 2. 대화형으로 제공업체 프로필 추가
...

claudex run openrouter-claude
│
├── 프록시 시작 (실행 중이 아닌 경우) → 127.0.0.1:13456
...

프록시는 요청을 가로채고 프로토콜 번역을 처리합니다:

DirectAnthropic(Anthropic, MiniMax, Vertex AI) → 올바른 헤더와 함께 전달
OpenAICompatible(Grok, OpenAI, DeepSeek 등) → Anthropic → OpenAI Chat Completions → 응답을 다시 번역하여 반환
OpenAIResponses(ChatGPT/Codex 구독) → Anthropic → Responses API → 응답을 다시 번역하여 반환

제공자 (Provider)유형 (Type)번역 (Translation)인증 (Auth)예시 모델 (Example Model)
AnthropicDirectAnthropic없음 (None)API Keyclaude-sonnet-4-20250514
...

Claudex는 다음 순서로 설정 파일 (config files)을 검색합니다:

$CLAUDEX_CONFIG 환경 변수

또는

./claudex.toml (현재 디렉토리)

./claudex.yaml (현재 디렉토리)

./.claudex/config.toml (상위 디렉토리, 최대 10단계까지)

~/.config/claudex/config.toml (전역 설정, 권장됨)

TOML 및 YAML 형식을 지원합니다. 전체 참조는 config.example.toml을 확인하세요.

명령 (Command)설명 (Description)
claudex run <profile>특정 제공자 (provider)로 Claude Code 실행
claudex run auto스마트 라우팅 (Smart routing) — 최적의 제공자를 자동 선택
claudex run <profile> -m <model>세션에 대해 모델 (model) 재정의
claudex profile list구성된 모든 프로필 (profiles) 목록 표시
claudex profile add대화형 프로필 설정 마법사
claudex profile show <name>프로필 상세 정보 표시
claudex profile remove <name>프로필 삭제
`claudex profile test <nameall>`
claudex proxy start [-p port] [-d]프록시 시작 (선택 사항으로 데몬 (daemon) 모드 실행)
claudex proxy stop프록시 데몬 중지
claudex proxy status프록시 상태 표시
claudex dashboardTUI 대시보드 실행
claudex config show [--raw] [--json]로드된 설정 표시
claudex config init [--yaml]현재 디렉토리에 설정 생성
claudex config edit [--global]$EDITOR로 설정 열기
claudex config validate [--connectivity]설정 유효성 검사
claudex config get <key>설정 값 가져오기
claudex config set <key> <value>설정 값 설정
claudex config export --format <fmt>설정 내보내기 (json/toml/yaml)

claudex update [--check] |
GitHub Releases를 통한 셀프 업데이트 (Self-update) |
claudex auth login <provider> |
OAuth 로그인 |
claudex auth login github --enterprise-url <domain> |
GitHub Enterprise Copilot |
claudex auth status |
OAuth 토큰 상태 표시 |
claudex auth logout <profile> |
OAuth 토큰 제거 |
claudex auth refresh <profile> |
OAuth 토큰 강제 새로고침 |
claudex sets add <source> [--global] |
설정 세트 (configuration set) 설치 |
claudex sets remove <name> |
설정 세트 제거 |
claudex sets list [--global] |
설치된 세트 목록 표시 |
claudex sets update [name] |
세트를 최신 버전으로 업데이트 |

API 키 대신 기존 구독 (subscriptions) 사용:

# ChatGPT 구독 (기존 Codex CLI 자격 증명을 자동 감지)
claudex auth login chatgpt --profile codex-sub
# ChatGPT 브라우저 강제 로그인
...

지원 대상: claude, chatgpt/openai, google, qwen, kimi, github/copilot, gitlab

Claude Code의 /model 스위처 (haiku/sonnet/opus)를 모든 제공자(provider)의 모델로 매핑:

[[profiles]]
name = "openrouter-deepseek"
provider_type = "OpenAICompatible"
...

src/
├── main.rs
├── cli.rs
...

AI 자동 생성 콘텐츠

본 콘텐츠는 GitHub Claude Ecosystem의 원문을 AI가 자동으로 요약·번역·분석한 것입니다. 원 저작권은 원저작자에게 있으며, 정확한 내용은 반드시 원문을 확인해 주세요.

원문 바로가기
1

댓글

0