Claude Code 설정 및 프록시(2026): 중국 내 사용, 사용자 지정 API 주소, 환경 변수, 모델 및 네트워크 설정

중국 내 사용: VPN 없이 게이트웨이로 연결

# ~/.zshrc / ~/.bashrc / PowerShell 配置文件
export ANTHROPIC_BASE_URL=https://aiprimetech.io
export ANTHROPIC_API_KEY=你的网关密钥
claude

Claude Code는 공식 SDK와 마찬가지로 이 두 변수를 읽습니다. 요청이 api.anthropic.com 대신 게이트웨이로 전송되므로 중국 내 네트워크에서 직접 연결할 수 있습니다. 주소에는 도메인만 입력하고 다음은 포함하지 마세요: /v1. 설정 후 터미널을 다시 열고 세션에 들어가 다음으로 확인하세요: /status . VS Code 확장 프로그램과 데스크톱 앱은 해당 프로그램을 실행한 셸의 환경을 읽습니다. 설정을 변경한 뒤에는 편집기를 완전히 종료하고 새 터미널에서 다시 실행해야 합니다.

프록시가 필요한 경우

사용 중인 네트워크에서 게이트웨이 자체에 대한 연결도 불안정할 때만 필요합니다. 설정 방법은 다른 명령줄 도구와 같습니다:

export HTTPS_PROXY=http://127.0.0.1:7890
export HTTP_PROXY=http://127.0.0.1:7890

만약 /login 의 OAuth 로그인 시간이 초과된다면("timeout of 15000ms exceeded"), 대부분 프록시 또는 DNS 문제입니다. API 키로 로그인하면 OAuth를 완전히 우회할 수 있습니다.

모델 설정

export ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-5
export ANTHROPIC_DEFAULT_OPUS_MODEL=claude-opus-5
export ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-haiku-4-5

Claude Code는 등급(Sonnet / Opus / Haiku)을 기준으로 작동하며, 이 세 변수가 각 등급에 해당하는 구체적인 모델을 결정합니다. Haiku 등급은 생각보다 중요합니다. Claude Code는 각 세션의 작은 작업에 이 등급을 사용하므로 저렴한 모델로 지정하면 비용을 상당히 절약할 수 있습니다. 게이트웨이는 현재 Claude 모델 ID 33개를 제공하며,/model 에서 모두 선택할 수 있습니다.

설정 파일 위치

CLAUDE.md(프로젝트 루트) — 프로젝트 메모리: 빌드 및 테스트 명령어, 규칙;CLAUDE.local.md 는 개인 메모이며 저장소에 포함하지 않습니다.
.claude/settings.json(프로젝트)/ ~/.claude/settings.json(전역) — 권한, 훅, 환경 변수, statusLine.
.claude/agents/ — 하위 에이전트 정의;.claude/skills/ 및 ~/.claude/skills/ — 스킬.
.mcp.json — 프로젝트에서 공유하는 MCP 서버 설정.

설정 오류 해결

404이 발생하고 로그에 다음이 표시되는 경우: /v1/v1/messages → BASE_URL에 다음을 불필요하게 추가했습니다: /v1。
401 / 잘못된 키 → 키와 주소가 일치하지 않습니다. 게이트웨이 주소에는 게이트웨이 키를 사용해야 합니다.
Max에 로그인했는데 토큰 기준으로 요금이 차감됨 → 환경에 ANTHROPIC_API_KEY이 아직 남아 있습니다. 키가 로그인보다 우선하므로 사용하지 않으려면 unset으로 해제하세요.
모델이 존재하지 않음 → 해당 ID가 현재 엔드포인트의 /v1/models 목록에 없습니다.
settings.json을 수정한 뒤 실행하자마자 종료됨 → JSON 구문 오류(불필요한 쉼표)가 있습니다. 검증 도구로 확인하세요.

비용

게이트웨이로 연결하면 과금 방식도 바뀝니다. 크레딧은 액면가의 7.69231배 가격으로 판매되며, $13로 $100의 크레딧을 받을 수 있습니다. 사용량이 많다면 $0.80부터 시작하는 무제한 요금제를 선택할 수 있습니다. 자세한 내용은 가격 페이지를 참조하세요.

먼저 무료로 사용해 보세요

신규 계정은 프로모션 코드 CLAUDECODE 를 사용해 가입하면 $5 의 API 잔액을 받을 수 있습니다. 카드 등록은 필요 없으며, Claude Code를 저녁 내내 실행하기에 충분합니다. 동일한 Claude 모델을 환경 변수 두 줄로 전환할 수 있습니다.

export ANTHROPIC_BASE_URL=https://aiprimetech.io
export ANTHROPIC_API_KEY=your_key

프로모션 코드 CLAUDECODE으로 가입

자주 묻는 질문

중국에서 Claude Code를 사용할 수 있나요?

네. Claude Code는 사용자 지정 API 주소(ANTHROPIC_BASE_URL)를 지원합니다. 이 게이트웨이로 연결하면 중국 내 네트워크에서 직접 접속할 수 있으며, VPN이나 해외 계정, 해외 은행 카드가 필요하지 않습니다.

Claude Code에서 프록시를 어떻게 설정하나요?

HTTPS_PROXY / HTTP_PROXY 환경 변수를 설정하면 됩니다. 다만 게이트웨이로 연결하면 대부분의 사용자는 프록시가 필요하지 않습니다.

ANTHROPIC_BASE_URL에 /v1을 추가해야 하나요?

아니요. SDK가 /v1/messages를 자동으로 붙이므로 경로를 한 번 더 추가하면 404이 발생합니다.

게이트웨이에서 Claude Code 실행

동일한 모델을 환경 변수 두 줄로 사용하고, 액면가의 7.69231배 가격으로 크레딧을 충전하거나 무제한 요금제를 선택하세요. 신규 계정은 프로모션 코드 CLAUDECODE을 사용하면 $5의 API 잔액을 받을 수 있습니다.

API 키 받기 요금제 보기

AI Prime Tech는 독립 API 게이트웨이이며 Anthropic과 제휴 관계가 없고, Anthropic의 보증이나 후원을 받지 않습니다. “Claude”와 “Claude Code”는 Anthropic의 상표입니다. 여기에 설명된 Claude Code 기능은 작성 당시 Anthropic의 공개 문서를 기준으로 하며 자주 변경됩니다. 이 페이지의 가격과 모델 목록은 이 게이트웨이의 실시간 설정에서 가져옵니다.

Claude Code 설정: 중국 내 사용 방법, 프록시와 API 주소, 자주 사용하는 환경 변수

핵심 사항