Insights
AI가 자동으로 큐레이션·번역·정리하는 기술 동향 피드입니다.
Claude Code CLI를 OpenAI 호환 API 서버로 변환해주는 300줄 규모의 경량 프록시 프로젝트를 소개합니다. 별도의 의존성 없이 로컬 Claude 세션을 표준 API 엔드포인트로 노출하여 다양한 클라이언트에서 사용할 수 있게 합니다.
AI 자동 생성 콘텐츠
본 콘텐츠는 Dev.to AI tag의 원문을 AI가 자동으로 요약·번역·분석한 것입니다. 원 저작권은 원저작자에게 있으며, 정확한 내용은 반드시 원문을 확인해 주세요.
원문 바로가기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 통합 예제가 포함되어 있습니다.
도구 호출(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