CC 리버스 프록시 연결 튜토리얼: Claude Code와 Codex를 동일한 중계 플랫폼에 연동하기

1. 이것은 무엇인가요

CC 리버스 프록시(일반적으로 cc-switch, claude-code-proxy 등)는 일종의 로컬/자체 구축 전달 프록시입니다. 외부로 통합된 엔트리 포인트(Anthropic / OpenAI 호환)를 제공하고 요청을 상위 서버로 전달합니다. 이를 통해 로컬의 Claude Code(Anthropic)와 Codex(OpenAI)가 동일한 리버스 프록시에 연결되어, 본 사이트의 게이트웨이로 통합 흐름을 만들고 하나의 sk- 키와 잔액을 공유할 수 있습니다.

로컬의 Claude Code(Anthropic)와 Codex(OpenAI)를 본 사이트의 게이트웨이를 통해 통합 관리해야 할 때, 리버스 프록시를 사용하여 요청을 단일 엔트리 포인트로 전달하고 하나의 키와 잔액으로 사용할 수 있습니다.

2. 준비 작업

1. 지능형 API 콘솔에 로그인하여 sk-… API Key를 생성합니다(한 번만 표시되므로 반드시 저장하세요).
2. 사용할 모델 슬러그(Claude 및 GPT 각각 또는 필요에 따라)를 확인합니다.
3. 게이트웨이 주소: https://www.relay-api.com을 확인합니다.

3. CC 리버스 프록시 설정

① 설치 및 시작

npm install -g cc-switch   # 또는 claude-code-proxy / 해당 리버스 프록시 도구
cc-switch start            # 기본 로컬 포트 127.0.0.1:8787

② 리버스 프록시의 '상위 서버'를 본 사이트 게이트웨이로 지정(핵심 두 가지: 상위 주소 + 키). cc-switch 설정을 예로 들면:

# cc-switch 설정 예시
anthropic_upstream = "https://www.relay-api.com"
openai_upstream    = "https://www.relay-api.com/v1"
api_key            = "sk-당신의 키"

③ Claude Code와 Codex를 각각 연결(리버스 프록시의 로컬 포트로 지정):

export ANTHROPIC_BASE_URL="http://127.0.0.1:8787"
export ANTHROPIC_API_KEY="sk-당신의 키"
export ANTHROPIC_MODEL="claude-sonnet-5"
claude

export OPENAI_BASE_URL="http://127.0.0.1:8787"
export OPENAI_API_KEY="sk-당신의 키"
codex --model gpt-5.5

4. 상위 엔드포인트 대조표

용도	상위 Base URL
Claude Code (Claude)	https://www.relay-api.com
Codex (GPT)	https://www.relay-api.com/v1

5. 자주 묻는 질문

현상	조치
401 / 403	키가 유효하지 않거나 잔액이 부족합니다. sk- 키가 정확한지 확인하고 충전하세요.
404 / 모델 유효하지 않음	상위 주소가 본 사이트의 엔트리 포인트인지 확인하고, 모델이 활성화되었는지 확인하세요.

보안 권장사항: 플랫폼의 sk- 키를 공개 저장소에 올리지 마십시오. 통계 확인 및 한도 설정을 위해 리버스 프록시 전용 키를 별도로 생성하는 것을 권장합니다.

Base URL 설명: 본 사이트는 /v1beta/models/...와 /v1beta/v1beta/models/...(및 /v1/...와 /v1/v1/...)을 모두 허용하므로, 클라이언트가 /v1이나 /v1beta를 직접 추가하는지 여부는 호출에 영향을 주지 않습니다. Base URL에 도메인 루트를 입력하거나 /v1beta가 포함된 주소를 입력해도 모두 작동합니다. 모델 ID는 콘솔의 '토큰' 페이지 오른쪽 상단 '모델 ID'에서 조회 및 복사할 수 있습니다.