중국에서 Claude Code 사용법

중국에서 Claude Code를 사용할 때의 3가지 장애물

설치(npm 및 중국 레지스트리)

1. 1. Node.js 22 이상 설치

   node -v를 실행하여 버전을 확인하세요.

2. 2. (선택) 중국 npm 레지스트리로 전환

   npm 다운로드가 느리면 먼저 레지스트리를 전환할 수 있습니다.

   터미널

   npm config set registry https://registry.npmmirror.com

3. 3. Claude Code 설치

   전역 설치 후 claude --version을 실행하여 확인하세요.

   터미널

   npm install -g @anthropic-ai/claude-code

command not found가 표시되면 npm 전역 디렉터리가 PATH에 없을 가능성이 높습니다. npm config get prefix를 실행하고 출력된 경로 아래의 bin 디렉터리를 PATH에 추가한 다음 터미널을 다시 여세요.

중국에서 사용 가능한 API에 연결

AICodeWith 콘솔에서 API 키를 만든 후 ~/.claude/settings.json에 추가하세요. 터미널을 다시 열고 claude를 실행한 다음 /status를 입력하여 API 엔드포인트가 api.aicodewith.ai인지 확인하세요.

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

Claude Code 릴레이 가이드API 키 받기

문제 해결: 작동하지 않을 때

1. /status를 실행하고 엔드포인트가 Anthropic 기본 엔드포인트가 아니라 api.aicodewith.ai인지 확인하세요.
2. 새 터미널에서 echo $ANTHROPIC_API_KEY를 실행하세요. 이전 값이 있으면 ~/.zshrc 또는 ~/.bashrc에서 제거하세요. ANTHROPIC_API_KEY는 비워 두어야 합니다.
3. 첫 실행이 로그인 화면에서 멈추면 ~/.claude.json에 "hasCompletedOnboarding": true를 추가하세요.
4. 요청 시간 초과: 로컬 프록시나 VPN을 일시적으로 끄고 다시 시도하세요. 중국 네트워크에서 직접 연결할 수 있습니다.
5. 401 / 429 / overloaded 오류가 발생하면 오류 가이드를 참조하세요.

Claude Code 일반 오류 및 해결 방법지원 지역

요금제 비교(Claude 구독 vs API 릴레이)

Claude Code 사용 한도충전 및 요금제

FAQ