Claude Code에서 API 중계 서비스 사용하기

환경 변수 또는 settings.json으로 Claude Code를 사용자 지정 API 주소로 연결합니다.

4분 읽기

Claude Code는 요청을 사용자 지정 API 주소로 보낼 수 있으며, 해당 환경 변수를 설정하거나 설정 파일에 작성하기만 하면 됩니다. 이 문서에서는 Anthropic 인터페이스와 호환되는 API 중계 서비스에 Claude Code를 연결하는 방법을 설명합니다.

준비할 정보

시작하기 전에 사용 중인 API 플랫폼에서 다음 정보를 확인하세요:

API 주소(Base URL): 플랫폼이 제공하는 인터페이스 루트 주소
API 키(Key): 인증에 사용하는 토큰
모델 이름: 플랫폼이 지원하고, 사용하려는 모델의 식별자

방법 1: 환경 변수

터미널에서 다음 환경 변수를 설정합니다(~/.zshrc 또는 ~/.bashrc에 작성하면 계속 적용됩니다):

export ANTHROPIC_BASE_URL="https://example.com"   # 플랫폼이 제공하는 API 주소로 교체
export ANTHROPIC_AUTH_TOKEN="your-key"            # 자신의 API 키로 교체
export ANTHROPIC_MODEL="your-model-name"          # 플랫폼이 지원하는 모델 이름으로 교체

설정한 뒤 터미널을 다시 열고 claude를 실행하면 적용됩니다.

방법 2: settings.json

Claude Code의 설정 파일 ~/.claude/settings.json(전역) 또는 프로젝트 내 .claude/settings.json에 작성할 수도 있습니다:

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://example.com",
    "ANTHROPIC_AUTH_TOKEN": "your-key",
    "ANTHROPIC_MODEL": "your-model-name"
  }
}

설정에 키가 포함된 경우, 버전 관리에 포함되지 않는 .claude/settings.local.json을 사용하는 것이 좋습니다.

자주 묻는 질문

404가 발생하는 경우: 일부 서비스는 끝의 슬래시에 민감하므로, API 주소 끝에 /를 추가하거나 제거해 보세요.
모델 이름이 일치하지 않는 경우: Claude Code는 모델 이름을 자동으로 변환하지 않으므로, 플랫폼이 인식할 수 있는 이름으로 설정하세요.
GUI 앱에서 적용되지 않는 경우: Dock이나 바로 가기로 실행한 GUI 앱은 터미널에서 설정한 환경 변수를 읽지 않습니다.
구독과 충돌하는 경우: Claude 구독 계정에 동시에 로그인되어 있으면 사용자 지정 주소가 구독을 덮어씁니다. 공식 서비스로 되돌리려면 위 설정을 제거하세요.

더 알아보기