Claude Code API 중계(중국에서 사용 가능, 사용한 만큼 지불)

Claude Code 중계란 무엇인가요

Claude Code 자체는 명령줄 클라이언트이며 ANTHROPIC_BASE_URL로 지정된 엔드포인트로 요청을 보냅니다. 기본값은 Anthropic 엔드포인트이며, 중국 내 네트워크에서는 보통 접속할 수 없고 결제에도 해외 신용카드가 필요합니다. 중계는 Anthropic API와 호환되는 주소를 제공하므로 클라이언트를 변경할 필요 없이 엔드포인트 주소와 Key만 바꾸면 됩니다.

중계는 API Key 호출을 사용하므로 Claude 계정에 로그인할 필요가 없고 Claude 구독을 사용하지 않습니다.

중계 vs. Claude 구독 vs. 미러 사이트

"미러 사이트"는 일반적으로 Claude 웹 버전에 대한 공유 또는 유료 제공 접근 권한을 의미하며, Claude Code CLI와 함께 사용하는 API 중계와는 다릅니다.

3단계 설정

1. 1. Key 발급받기

   AICodeWith에 가입하고 로그인한 뒤 콘솔의 API Keys 페이지에서 Key를 생성하세요. 자세한 스크린샷은 API Key 발급 페이지에서 확인할 수 있습니다.

2. 2. ANTHROPIC_BASE_URL 및 ANTHROPIC_AUTH_TOKEN 설정

   ~/.claude/settings.json에 작성하는 것을 권장합니다. CLI, VS Code, JetBrains 플러그인이 모두 이 파일을 읽습니다. 충돌을 피하려면 ANTHROPIC_API_KEY를 비워 두세요.

   ~/.claude/settings.json

   {
     "env": {
       "ANTHROPIC_AUTH_TOKEN": "你的_API_KEY",
       "ANTHROPIC_API_KEY": "",
       "ANTHROPIC_BASE_URL": "https://api.aicodewith.ai"
     }
   }

3. 3. 확인

   터미널을 다시 열고 claude를 실행한 뒤 /status를 입력해 API 엔드포인트가 api.aicodewith.ai인지 확인하세요. 환경 변수로 임시 확인할 수도 있습니다:

   macOS / Linux

   export ANTHROPIC_BASE_URL="https://api.aicodewith.ai"
   export ANTHROPIC_AUTH_TOKEN="你的_API_KEY"
   export ANTHROPIC_API_KEY=""

스크린샷이 포함된 API Key 발급 튜토리얼Claude Code 연동 가이드Claude Code 제3자 API 설정 가이드

지원 모델 및 가격

Claude 계열 모델을 지원하며, Claude Code에서 /model을 사용해 전환할 수 있습니다. 모델별 실시간 단가, 사용 가능한 채널, 채널 상태는 Models 페이지에서 확인할 수 있습니다. 청구는 실제 토큰 사용량을 기준으로 합니다.

모델 및 실시간 가격충전 및 요금제

중계 선택 방법

• •안정성: 여러 채널을 사용할 수 있는지, Models 페이지에 채널 상태가 공개되는지, 피크 시간대에 overloaded가 발생할 때 채널을 전환할 수 있는지 확인하세요.
• •청구: 토큰 사용량이 투명하게 청구되는지, 요청별 사용 기록을 확인할 수 있는지, Key에 지출 한도를 설정할 수 있는지 확인하세요.
• •개인정보: 개인정보 처리방침에 설명된 데이터 처리 방식을 확인하고, 출처를 알 수 없는 "공유 계정"에 Key를 제공하지 마세요.
• •환불: 명확한 환불 규칙이 있는지 확인하세요. AICodeWith: 미사용 잔액은 90일 이내에 환불할 수 있으며 10% 처리 수수료가 차감됩니다. 자세한 내용은 환불 정책을 참조하세요.

자주 발생하는 오류

가장 흔한 것은 401(Key 또는 변수 오류), 429(동시성 초과), overloaded(모델 혼잡), 구성 변경이 적용되지 않는 경우입니다. 각 오류의 원인과 해결 방법은 오류 참조에서 확인하세요.

Claude Code 자주 발생하는 오류 및 해결 방법

FAQ