내 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 로그인을 계속 사용합니다.
shell
export ANTHROPIC_BASE_URL="https://api.uplinkswitch.com/v1"
export ANTHROPIC_AUTH_TOKEN="sk-uplink-live-..."
claude

settings.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.001,000,000
Claude Fable 5.1claude-fable-5.1Anthropic$6.00정가 $10.00$2.00정가 $0.25$30.00정가 $50.001,000,000
Claude Opus 5.5claude-opus-5-5Anthropic$2.716정가 $4.00$0.1455정가 $0.20$9.70정가 $20.001,000,000
Claude Sonnet 5.5claude-sonnet-5-5Anthropic$1.20정가 $2.00$0.075정가 $0.10$3.00정가 $10.001,000,000
Claude Haiku 5.5claude-haiku-5-5Anthropic$0.0582정가 $0.10$0.01정가 $0.01$0.1455정가 $0.501,000,000
Claude Fable 5claude-fable-5Anthropic$3.00정가 $10.00$0.30정가 $1.00$15.00정가 $50.001,000,000
Claude Opus 5claude-opus-5Anthropic$1.80정가 $5.00$0.16정가 $0.50$7.50정가 $25.001,000,000
Claude Sonnet 5claude-sonnet-5Anthropic$1.20정가 $2.00$0.12정가 $0.20$3.00정가 $10.001,000,000
Claude Opus 4.8claude-opus-4-8Anthropic$1.80정가 $5.00$0.16정가 $0.50$7.50정가 $25.001,000,000
Claude Opus 4.7claude-opus-4-7Anthropic$1.80정가 $5.00$0.16정가 $0.50$7.50정가 $25.001,000,000
Claude Opus 4.6claude-opus-4-6Anthropic$1.80정가 $5.00$0.16정가 $0.50$7.50정가 $25.001,000,000
Claude Sonnet 4.6claude-sonnet-4-6Anthropic$1.80정가 $3.00$0.18정가 $0.30$9.00정가 $15.001,000,000
Claude Haiku 4.5claude-haiku-4-5Anthropic$0.60정가 $1.00$0.06정가 $0.10$3.00정가 $5.00200,000

백만 토큰당 USD

동작 확인

작은 메시지 하나를 보내 보세요. -i를 붙이면 curl이 응답 헤더를 출력합니다. x-uplink-request-id는 요청을 식별하고, x-uplink-charge는 USD 기준 비용입니다.

그런 다음 claude를 실행하세요. 요청은 몇 초 안에 콘솔에 나타납니다. Claude Code 안에서 /status를 실행하면 UplinkSwitch 주소가 적힌 Anthropic base URL 줄과, 설정한 키 변수의 이름이 적힌 줄이 보입니다. base URL 줄이 없다면 변수가 세션에 전달되지 않은 것입니다.

curl
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을 사용하세요.

자주 묻는 질문

네. 이곳에서는 모든 채팅 모델을 Anthropic 형식으로 제공하므로 GPT, Gemini, DeepSeek 또는 무검열 모델의 id를 모델 변수에 넣을 수 있고, 도구 호출을 포함해 Messages 응답으로 답합니다.

네. 캐시된 입력은 캐시 요금으로 과금됩니다. 요청 기록에 캐시 읽기 토큰이 하나라도 있으면 캐싱이 동작한 것입니다.

Remote Control과 음성 받아쓰기는 claude.ai 로그인이 필요하므로 키 변수가 설정된 동안에는 꺼집니다. MCP 도구 검색은 Anthropic이 아닌 호스트에서는 꺼지며, ENABLE_TOOL_SEARCH=true로 설정하면 켜집니다.

ANTHROPIC_BASE_URL과 ANTHROPIC_AUTH_TOKEN 설정을 해제하고, settings.json에 넣었다면 거기서도 지우세요.

콘솔의 사용량 페이지에 실제로 낸 금액이 표시됩니다. 요청 하나를 보려면 request id로 조회하세요. 기록에는 입력 토큰, 캐시 읽기 토큰, 출력 토큰과 USD 청구액이 나오며, 약 일 분 안에 로그에 올라옵니다.

크레딧은 콘솔에서 $10부터 카드, WeChat Pay, Apple Pay, Google Pay 또는 암호화폐로 선불 충전하며 구독은 없습니다. 충전할 때마다 가격이 30일간 고정됩니다.

Claude Code용 키 발급받기

변수 두 개, $10부터 선불, 구독 없음, 충전할 때마다 30일 가격 고정.

키 발급받기
Join on Telegram