Quickstart: Claude Code, Codex, Cursor를 AI API 중계 서비스에 연결하기

먼저 확인할 세 가지

Claude Code, Codex, Cursor를 API 중계 서비스에 연결할 때는 도구 UI부터 시작하지 마세요. 먼저 다음 세 가지를 확인합니다.

1. 쓰는 도구: Claude Code, Codex, Gemini CLI, OpenCode는 설정 파일이 다릅니다.
2. 서비스가 지원하는 프로토콜: Anthropic 호환, OpenAI 호환, 또는 둘 다인지 확인합니다.
3. Base URL의 정확한 형식: /v1이 필요한 서비스와 /v1을 빼야 하는 서비스가 있습니다. 각 서비스 문서를 따르세요.

이 세 가지가 맞지 않으면 CLI는 보통 로그인 오류, 401, 404, model not found로 실패합니다.

서비스를 아직 고르는 중이라면 AI API 중계 서비스에서 지원 모델, 결제 방법, 확인 정보를 비교할 수 있습니다. 요금을 먼저 보려면 AI API 가격 비교를 확인하세요.

Claude Code에서 확인할 것

Claude Code는 보통 Anthropic 환경 변수를 사용합니다.

export ANTHROPIC_BASE_URL="https://your-proxy.example"
export ANTHROPIC_AUTH_TOKEN="your proxy API key"
claude

서비스가 Anthropic 형식 API 키를 주면 다음 설정을 요구할 수 있습니다.

export ANTHROPIC_API_KEY="sk-..."
claude

주의: ANTHROPIC_API_KEY를 설정하면 Claude Code는 Claude 구독 로그인 경로가 아니라 API 키 과금 경로를 쓰는 경향이 있습니다.

Codex에서 확인할 것

Codex는 OpenAI의 로컬 CLI입니다. 공식 설치 흐름은 다음과 같습니다.

npm i -g @openai/codex
codex

처음 실행하면 ChatGPT 로그인 또는 API 키를 고르라고 합니다. 중계 서비스를 쓸 때는 OpenAI Responses API 또는 Chat Completions 호환 인터페이스 지원 여부와 OPENAI_BASE_URL, OPENAI_API_KEY, ~/.codex/config.toml 중 무엇을 설정해야 하는지를 확인하세요.

다음 단계

인증 오류가 나면 401 Unauthorized 문제 해결을 확인하세요. 충전하기 전에 모델 바꿔치기 신호를 보려면 API Relay Check를 사용하세요.