내 API 키로 Claude Code 실행하기
환경 변수 두 개를 설정하면 Claude Code가 UplinkSwitch 키로 동작합니다. 같은 도구, 같은 모델, 실시간 가격입니다.
확인일 2026-11-13
준비물
- Claude Code가 설치되어 있고
claude가 PATH에 있어야 합니다. - 콘솔에서 발급한, 잔액이 충전된 UplinkSwitch 키. 크레딧은 $10부터 카드, WeChat Pay, Apple Pay, Google Pay 또는 암호화폐로 선불 충전합니다.
변수 두 개
ANTHROPIC_BASE_URL은 Claude Code가 UplinkSwitch를 향하게 합니다./v1까지 포함해 붙여 넣으세요. 게이트웨이는 Claude Code가 이 값으로 만드는 경로를 받아들입니다.ANTHROPIC_AUTH_TOKEN은 키를Authorization: Bearer로 보냅니다. 그 대신ANTHROPIC_API_KEY를 써도 되며, 이때는 키를x-api-key로 보냅니다. 둘 중 하나만 설정하세요.- 서로 다른 키 두 개가 담긴 요청은
400으로 거부됩니다. - base URL만으로는 부족합니다. 키 변수 중 하나가 없으면 Claude Code는 저장된 claude.ai 로그인을 계속 사용합니다.
export ANTHROPIC_BASE_URL="https://api.uplinkswitch.com/v1"
export ANTHROPIC_AUTH_TOKEN="sk-uplink-live-..."
claudesettings.json에 저장해 두기
두 변수를 ~/.claude/settings.json의 env 아래에 추가하면 모든 프로젝트에 적용됩니다. .claude/settings.local.json은 프로젝트 하나에만 적용됩니다.
- 별칭 뒤의 모델을 지정하는 변수가 세 개 더 있습니다:
ANTHROPIC_DEFAULT_OPUS_MODEL,ANTHROPIC_DEFAULT_SONNET_MODEL,ANTHROPIC_DEFAULT_HAIKU_MODEL. 여기에claude-opus-5-5,claude-sonnet-5-5,claude-haiku-5-5같은 id를 설정하세요. - 프로젝트의
.claude/settings.json에는 키를 넣지 마세요. 이 파일은 커밋해서 공유하는 용도입니다. - 셸의 export와 설정 파일이 같은 변수를 설정하면 설정 파일이 우선합니다.
- VS Code 확장은 VS Code 사용자 설정에 있는 자체 설정
claudeCode.environmentVariables에서 자격 증명을 읽습니다.
모델 선택
opus, sonnet, haiku 별칭은 세 모델 변수가 지정한 모델로 연결됩니다. Haiku 변수를 설정하면 세션 제목 생성 같은 백그라운드 작업도 그 모델로 옮겨 갑니다. 세션 중에는 /model로, 시작할 때는 claude --model claude-opus-5-5로, 한 세션에만 적용하려면 ANTHROPIC_MODEL로 전환하세요.
Claude Code는 Anthropic의 API 형식을 사용하며, 이곳에서는 GPT, Gemini, DeepSeek, Kimi와 무검열 빌드를 포함한 모든 채팅 모델을 이 형식으로 제공합니다. 모델 목록의 채팅 id는 무엇이든 같은 변수에 넣을 수 있고, 도구 호출을 포함해 Messages 응답으로 답합니다.
이 키로 쓰는 Claude Code 비용
표는 Claude 모델의 백만 토큰당 가격을 카탈로그에서 실시간으로 가져와 Anthropic이 공개한 정가와 나란히 보여 줍니다. 이 키로 쓸 수 있는 모든 Claude 모델은 Claude API 가격 페이지에 있습니다.
Claude Code는 턴마다 대화 전체를 보내며 프롬프트 캐시 대상으로 표시합니다. 캐시에서 읽은 토큰은 입력 요금의 일부에 불과한 캐시 요금으로 과금됩니다. 캐시는 기본적으로 오 분 동안 유지되므로, 그보다 오래 쉰 뒤의 턴에서는 전체 컨텍스트에 대해 입력 요금을 한 번 냅니다.
Claude Code가 표시하는 비용은 Anthropic 정가로 계산한 자체 추정치입니다. 실제로 낸 금액은 콘솔의 사용량 페이지에 있습니다.
| 모델 | 입력 | 캐시된 입력 | 출력 | 컨텍스트 |
|---|---|---|---|---|
| Claude Fable 5.2claude-fable-5.2Anthropic | $4.00정가 $8.00 | $0.10정가 $0.20 | $20.00정가 $40.00 | 1,000,000 |
| Claude Fable 5.1claude-fable-5.1Anthropic | $6.00정가 $10.00 | $2.00정가 $0.25 | $30.00정가 $50.00 | 1,000,000 |
| Claude Opus 5.5claude-opus-5-5Anthropic | $2.716정가 $4.00 | $0.1455정가 $0.20 | $9.70정가 $20.00 | 1,000,000 |
| Claude Sonnet 5.5claude-sonnet-5-5Anthropic | $1.20정가 $2.00 | $0.075정가 $0.10 | $3.00정가 $10.00 | 1,000,000 |
| Claude Haiku 5.5claude-haiku-5-5Anthropic | $0.0582정가 $0.10 | $0.01정가 $0.01 | $0.1455정가 $0.50 | 1,000,000 |
| Claude Fable 5claude-fable-5Anthropic | $3.00정가 $10.00 | $0.30정가 $1.00 | $15.00정가 $50.00 | 1,000,000 |
| Claude Opus 5claude-opus-5Anthropic | $1.80정가 $5.00 | $0.16정가 $0.50 | $7.50정가 $25.00 | 1,000,000 |
| Claude Sonnet 5claude-sonnet-5Anthropic | $1.20정가 $2.00 | $0.12정가 $0.20 | $3.00정가 $10.00 | 1,000,000 |
| Claude Opus 4.8claude-opus-4-8Anthropic | $1.80정가 $5.00 | $0.16정가 $0.50 | $7.50정가 $25.00 | 1,000,000 |
| Claude Opus 4.7claude-opus-4-7Anthropic | $1.80정가 $5.00 | $0.16정가 $0.50 | $7.50정가 $25.00 | 1,000,000 |
| Claude Opus 4.6claude-opus-4-6Anthropic | $1.80정가 $5.00 | $0.16정가 $0.50 | $7.50정가 $25.00 | 1,000,000 |
| Claude Sonnet 4.6claude-sonnet-4-6Anthropic | $1.80정가 $3.00 | $0.18정가 $0.30 | $9.00정가 $15.00 | 1,000,000 |
| Claude Haiku 4.5claude-haiku-4-5Anthropic | $0.60정가 $1.00 | $0.06정가 $0.10 | $3.00정가 $5.00 | 200,000 |
백만 토큰당 USD
동작 확인
작은 메시지 하나를 보내 보세요. -i를 붙이면 curl이 응답 헤더를 출력합니다. x-uplink-request-id는 요청을 식별하고, x-uplink-charge는 USD 기준 비용입니다.
그런 다음 claude를 실행하세요. 요청은 몇 초 안에 콘솔에 나타납니다. Claude Code 안에서 /status를 실행하면 UplinkSwitch 주소가 적힌 Anthropic base URL 줄과, 설정한 키 변수의 이름이 적힌 줄이 보입니다. base URL 줄이 없다면 변수가 세션에 전달되지 않은 것입니다.
curl -i https://api.uplinkswitch.com/v1/messages \
-H "Authorization: Bearer sk-uplink-live-..." \
-H "anthropic-version: 2023-06-01" \
-H "content-type: application/json" \
-d '{"model": "claude-fable-5.2", "max_tokens": 16, "messages": [{"role": "user", "content": "Reply with ok"}]}'오류와 해결법
invalid_api_key(401): 키가 잘못되었거나 폐기되었거나, Claude Code가 읽지 않은 변수에 들어 있습니다./status를 확인하세요.insufficient_balance(402): 콘솔에서 충전하세요.monthly_limit_reached(402)는 키에 설정한 월간 지출 한도에 도달했다는 뜻입니다.model_not_found(404): id가 모델 목록에 없습니다. 모델 변수에 오타가 없는지 확인하세요.- curl 테스트는 되는데 Claude Code가 로그인을 요구하는 경우: 키를 셸 export나
~/.claude/settings.json에 설정하세요. 프로젝트 설정 파일은 최초 실행 설정과 신뢰 확인을 마친 뒤에만 적용됩니다. - 시작할 때 자격 증명 출처가 두 개라는 경고가 뜨는 경우: 저장된 로그인과 변수가 모두 활성 상태입니다.
/logout을 실행해 키만 남기세요. ANTHROPIC_API_KEY를 설정했는데 무시되는 경우: 한 번의 승인이 필요합니다./config에서 Use custom API key를 켜거나ANTHROPIC_AUTH_TOKEN을 사용하세요.