raine/claude-code-proxy

Use Claude Code with your ChatGPT, Kimi, Cursor or Grok subscription via a local Anthropic-compatible proxy

무엇인가

claude-code-proxy는 Claude Code 편집기(Anthropic의 Claude 기반 코딩 어시스턴트 UI)와 OpenAI Codex, Kimi, Grok, OpenCode Go, Cursor Agent와 같은 다양한 대규모 언어 모델 제공업체 사이에 위치한 작은 로컬 서버입니다. Claude Code가 기대하는 Anthropic 스타일 API 호출을 해당 제공업체의 네이티브 API로 변환하고, 인증, 모델 라우팅, 스트리밍 응답 및 기본 진단을 처리합니다.

왜 중요한가

Claude Code는 이미 풍부한 코딩 어시스턴트 기능(코드 완성, 리팩토링, 문서화, 하위 에이전트, 편집기 통합)을 제공합니다. 그러나 Claude Code는 Anthropic의 유료 API에 하드와이어되어 있습니다. 프록시를 사용하면 동일한 UI를 유지하면서 지원되는 구독 기반 백엔드를 사용할 수 있어 비용을 절감하거나 다른 강점을 가진 모델(예: Kimi-for-coding, Grok, Cursor)에 액세스할 수 있습니다. 또한 요청 속도, 토큰 사용량 및 오류를 실시간으로 확인할 수 있는 로컬 모니터 UI를 제공합니다.

시작 방법

설치 – macOS/Linux에서는 brew install raine/claude-code-proxy/claude-code-proxy 또는 저장소에서 한 줄 설치 스크립트를 실행할 수 있습니다. Windows 바이너리는 GitHub releases 페이지에 있습니다.
인증 – ChatGPT Plus 또는 Pro 계정으로 로그인합니다(프록시는 ChatGPT 세션 토큰을 사용하며 OpenAI API 키를 사용하지 않습니다):
```
claude-code-proxy codex auth login
```
프록시 실행 – 터미널에서 시작합니다:
```
claude-code-proxy serve
```
선택적으로 --no-monitor를 추가하여 백그라운드 서비스로 실행하고 나중에 claude-code-proxy monitor로 TUI 모니터를 연결할 수 있습니다.
Claude Code 실행 – 몇 가지 환경 변수를 설정하여 편집기를 로컬 프록시로 지정합니다. 예:
```
ANTHROPIC_BASE_URL=http://127.0.0.1:18765 \
ANTHROPIC_AUTH_TOKEN=unused \
ANTHROPIC_MODEL=gpt-6-sol \
claude
```
프록시는 인증한 제공업체로 요청을 전달합니다.
선택적 이미지 생성 – CCP_CODEX_IMAGES_API=1로 Codex 이미지 엔드포인트를 활성화하고 로컬 /v1/images/generations 엔드포인트를 호출합니다. 프록시는 요청을 로그인한 ChatGPT 계정의 이미지 할당량으로 전달합니다.

주요 기능

기능	설명
다중 제공업체 지원	Codex, Kimi, Grok, OpenCode Go 및 Cursor Agent와 함께 작동합니다. `claude-code-proxy models`로 사용 가능한 모델을 나열할 수 있습니다.
인증 처리	선택한 제공업체(예: ChatGPT Plus)에 로그인하고 세션 토큰을 로컬에 저장합니다.
프로토콜 변환	Claude Code의 Anthropic 스타일 HTTP 요청을 수락하고 제공업체의 네이티브 API 형식으로 변환합니다.
스트리밍 응답	Claude Code가 기대하는 토큰별 스트리밍을 유지하여 UI가 즉각적으로 느껴지도록 합니다.
로컬 모니터 TUI	`claude-code-proxy monitor`는 활성 세션, 최근 요청, 오류, 토큰 사용량 및 처리량을 표시합니다.
진단 및 라우팅	환경 변수에 따라 요청을 적절한 모델로 라우팅합니다. 프로젝트별로 구성할 수 있습니다.
이미지 생성(옵트인)	ChatGPT 이미지 할당량을 사용하여 base64로 인코딩된 이미지를 반환하는 `/v1/images/generations` 엔드포인트를 노출합니다.
안전 경고	기본적으로 `127.0.0.1`에만 바인딩됩니다. 외부 노출에는 방화벽 또는 리버스 프록시 보호를 추가해야 합니다.

누가 사용할까

Claude Code를 좋아하는 개발자로, 더 저렴하거나 특화된 모델로 교체하고 싶은 사람.
여러 코딩 에이전트를 실행하는 파워 유저(예: 저자의 aven 작업 큐를 통해)로, 다른 백엔드로 라우팅할 수 있는 단일 로컬 엔드포인트가 필요한 사람.
모델 성능을 실험하는 연구자가 Claude Code 클라이언트를 다시 작성하지 않고 Codex, Kimi, Grok 등에서 실험하고 싶은 사람.

제한 사항

프록시는 로컬(루프백) 연결만 허용합니다. 공개적으로 노출하려면 추가 보안 단계가 필요합니다.
각 제공업체의 구독 계정에 의존합니다. 프록시는 무료 티어 액세스를 제공하지 않습니다.
비공식 사용은 제공업체 약관을 위반할 수 있으므로 사용자가 위험을 감수합니다.

추가 자료

저장소는 claude-code-proxy.raine.dev에서 호스팅되는 광범위한 문서(시작 가이드, 제공업체 비교, 구성 옵션, HTTP API 참조 및 모니터 TUI 가이드)에 대한 링크를 제공합니다.

라이선스: MIT