Claude Proxy: Claude Code CLI를 OpenAI 호환 API 서버로 전환하기

문제점: Claude Max에는 API 키가 없습니다

해결책: 300줄 규모의 의존성 없는 프록시 (Zero-Dependency Proxy)

claude-proxy는 로컬의 claude CLI를 래핑(wrap)하여 표준 /v1/chat/completions 엔드포인트를 노출합니다. OpenAI 호환 클라이언트라면 무엇이든 사용자의 인증된 Claude Code 세션을 백엔드로 사용할 수 있습니다.

OpenAI-API 클라이언트 --> /v1/chat/completions --> claude_openai_proxy.py --> claude CLI --> Anthropic

실행을 위한 3개의 명령어면 충분합니다. pip install이 필요 없습니다. Docker도 필요하지 않습니다. 스트리밍(Stream) 및 비스트리밍(non-stream)을 지원합니다. 프롬프트 기반의 함수/도구 호출 (function/tool calling) 및 허위 거부(false-refusal) 방지 강화 기능이 포함되어 있습니다.

sonnet, opus, haiku를 지원합니다. 동시성 제어(Concurrency-controlled)가 가능합니다 (CLI 프로세스당 200-400MB). systemd 및 Docker 배포가 포함되어 있습니다. 저장소(repo)에 Evonic 통합 예제가 포함되어 있습니다.

트레이드오프 (Trade-offs)

도구 호출(Tool calling)은 프롬프트로 에뮬레이션(emulated)된 방식이며(네이티브 API 아님), 요청당 하나의 CLI 프로세스를 사용합니다(stateless). 또한 Claude Max를 범용 API 백엔드로 사용하는 것은 Anthropic의 서비스 약관(ToS)을 위반할 수 있습니다. 프로덕션 환경에서는 실제 API 키를 사용하는 것이 권장되는 경로입니다. 예산이 한정된 내부 도구 및 에이전트 프레임워크(agent frameworks) 용도로는 매우 유용합니다.

전체 아키텍처 분석, 동시성 설계, 환경 변수(env var) 참조, Docker compose, 그리고 비교 표는 devtocash.com에서 자세히 설명합니다. 저장소: github.com/rephapeng/claude-proxy