CC 리버스 프록시 설정 가이드: Claude Code와 Codex를 하나의 중계 서버로 통합하기

1. 이것은 무엇인가요

CC 리버스 프록시(흔히 cc-switch, claude-code-proxy 등으로 지칭)는 일종의 로컬/자체 호스팅 전달 프록시입니다. 외부로 통합된 엔트리 포인트(Anthropic/OpenAI 호환)를 제공한 다음, 요청을 상위 서버로 전달합니다. 이를 통해 로컬의 Claude Code(Anthropic)와 Codex(OpenAI)를 모두 동일한 리버스 프록시에 연결하여, 하나의 sk- 키와 잔액으로 통합 관리할 수 있습니다.

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

2. 준비 사항

1. 지능형 API 콘솔에 로그인하여 sk-… 형식의 API 키를 생성합니다(한 번만 표시되므로 반드시 저장하세요).
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

② 리버스 프록시의 「상위 서버(Upstream)」를 본 사이트 게이트웨이로 설정(핵심 요소: 상위 서버 주소 + 키). 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.4

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

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

5. 자주 묻는 질문(FAQ)

현상	해결 방법
401 / 403	키가 유효하지 않거나 잔액이 부족함. sk- 키가 정확한지 확인하고 충전하세요.
404 / 모델 유효하지 않음	상위 서버 주소가 본 사이트의 엔트리 포인트인지 확인하고, 모델이 활성화되어 있는지 확인하세요.

보안 권장 사항: 플랫폼 sk- 키를 공개 저장소에 올리지 마세요. 리버스 프록시 전용 키를 별도로 생성하여 통계 및 한도 관리에 활용하는 것을 권장합니다.