Claude Code를 구독 없이 API 키로만 쓸 수 있나요?

쓸 수 있습니다. ANTHROPIC_BASE_URL을 https://api.relayswitch.io/v1 로, ANTHROPIC_AUTH_TOKEN을 RelaySwitch 키로 설정하면 매 턴이 선불 잔액에서 토큰 단위로 차감됩니다. 계정과 잔액은 RelaySwitch에 있으므로 claude.ai 로그인은 쓰이지 않습니다.

ANTHROPIC_BASE_URL 끝에 /v1을 붙여야 하나요?

붙여도 되고 빼도 됩니다. 이 사이트의 예시는 https://api.relayswitch.io/v1 로 통일했습니다. Claude Code는 주소 뒤에 /v1/messages를 직접 붙이는데, 게이트웨이가 중복된 /v1을 처리합니다.

클로드 코드 요금은 어떻게 계산되나요?

요청마다 입력, 캐시 입력, 출력 토큰 수에 모델별 단가를 곱해 잔액에서 차감합니다. 주간 한도나 초기화되는 할당량이 없고 쓴 만큼만 나갑니다. 요청별 실제 금액은 영수증과 콘솔의 Usage 페이지에서 확인합니다.

호출되는 모델이 진짜 Claude인지 어떻게 확인하나요?

두 가지를 직접 볼 수 있습니다. 모든 모델에 매일 같은 점검 프롬프트를 보내 이전 응답과 비교한 결과가 https://api.relayswitch.io/v1/proof 에 키 없이 공개되고, 요청마다 모델 id와 과금 토큰, 비용이 적힌 서명된 영수증이 발급됩니다.

401, 402, 429 오류가 나면 무엇을 확인해야 하나요?

401은 키가 틀렸거나 폐기되었거나 Claude Code가 읽지 않는 변수에 들어 있는 경우이니 /status로 확인합니다. 402는 잔액이 부족하거나 키에 설정한 예산 또는 한도에 닿은 경우입니다. 429는 키의 속도 제한이며 응답의 retry-after 값만큼 기다린 뒤 다시 시도합니다. 429, 502, 503은 과금되지 않습니다.

결제는 어떻게 하고 최소 금액은 얼마인가요?

카드(Apple Pay, Google Pay) 또는 암호화폐로 충전하며 최소 $10입니다. 잔액은 달러로 표시되고 만료되지 않습니다.

확인일 2026-11-12

Claude Code를 API 키 하나로 쓰기

환경 변수 두 개만 바꾸면 됩니다. ANTHROPIC_BASE_URL을 https://api.relayswitch.io/v1로, ANTHROPIC_AUTH_TOKEN을 RelaySwitch 키로 지정하면 Claude Code가 그대로 동작하고, 요금은 구독이 아니라 쓴 토큰만큼 선불 잔액에서 차감됩니다.

01환경 변수 두 개

Claude Code는 Anthropic Messages 형식으로 요청을 보내고, 요청을 보낼 주소를 ANTHROPIC_BASE_URL에서 읽습니다. 이 값을 https://api.relayswitch.io/v1로 바꾸고 ANTHROPIC_AUTH_TOKEN에 sk-relay-... 형태의 키를 넣으면 준비가 끝납니다. macOS, Linux, WSL용 설정은 코드 블록과 같습니다.

ANTHROPIC_AUTH_TOKEN은 키를 Authorization: Bearer 헤더로 보냅니다. ANTHROPIC_API_KEY를 대신 써도 되며 이 경우 x-api-key 헤더로 전송됩니다. 둘 중 하나만 설정하십시오. 주소만 바꾸고 키 변수를 넣지 않으면 Claude Code는 저장된 claude.ai 로그인을 계속 사용합니다.

bash

1export ANTHROPIC_BASE_URL="https://api.relayswitch.io/v1"

2export ANTHROPIC_AUTH_TOKEN="sk-relay-..."

3claude

02Windows PowerShell과 settings.json

PowerShell에서는 $env: 문법으로 같은 두 변수를 설정합니다. 터미널에서 설정한 변수는 그 창에서만 유효합니다.

매번 입력하지 않으려면 ~/.claude/settings.json의 env 블록에 두 변수를 넣습니다. 이 파일은 모든 프로젝트에 적용되고, 같은 변수가 셸과 설정 파일 양쪽에 있으면 설정 파일 값이 우선합니다. 프로젝트의 .claude/settings.json은 커밋해서 공유하는 파일이므로 키를 넣지 마십시오. VS Code 확장은 자체 설정 항목인 claudeCode.environmentVariables에서 값을 읽습니다.

powershell

1$env:ANTHROPIC_BASE_URL = "https://api.relayswitch.io/v1"

2$env:ANTHROPIC_AUTH_TOKEN = "sk-relay-..."

3claude

03연결 확인

ANTHROPIC_AUTH_TOKEN을 설정한 뒤 claude를 실행하면 로그인 화면이 나오지 않습니다. 세션 안에서 /status를 실행했을 때 Anthropic base URL 줄에 RelaySwitch 주소가 보이면 요청이 이 키로 나가고 있는 것입니다. 그 줄이 없다면 변수가 세션에 전달되지 않은 것입니다.

요청은 몇 초 안에 콘솔에 나타납니다. Claude Code 화면에 표시되는 비용은 Anthropic 공식 가격으로 계산한 자체 추정치이고, 실제로 차감된 금액은 콘솔의 Usage 페이지와 요청별 영수증에 있습니다.

04Claude 모델 실시간 가격

카탈로그에 있는 Claude 모델 13개의 현재 가격입니다. 숫자는 페이지를 렌더링할 때 카탈로그에서 읽어 오며, 표에 보이는 달러 단가가 그대로 차감됩니다.

모델	개발사	입력	출력	컨텍스트
Claude Fable 5.1claude-fable-5.1	Anthropic	$6.00	$30.00	1,000,000
Claude Fable 5.2claude-fable-5.2	Anthropic	$4.00	$20.00	1,000,000
Claude Fable 5claude-fable-5	Anthropic	$3.00	$15.00	1,000,000
Claude Opus 5.5claude-opus-5-5	Anthropic	$2.716	$9.70	1,000,000
Claude Sonnet 4.6claude-sonnet-4-6	Anthropic	$1.80	$9.00	1,000,000
Claude Opus 4.6claude-opus-4-6	Anthropic	$1.80	$7.50	1,000,000
Claude Opus 4.7claude-opus-4-7	Anthropic	$1.80	$7.50	1,000,000
Claude Opus 4.8claude-opus-4-8	Anthropic	$1.80	$7.50	1,000,000
Claude Opus 5claude-opus-5	Anthropic	$1.80	$7.50	1,000,000
Claude Haiku 4.5claude-haiku-4-5	Anthropic	$0.60	$3.00	200,000
Claude Sonnet 5claude-sonnet-5	Anthropic	$1.20	$3.00	1,000,000
Claude Sonnet 5.5claude-sonnet-5-5	Anthropic	$1.20	$3.00	1,000,000
Claude Haiku 5.5claude-haiku-5-5	Anthropic	$0.0582	$0.1455	1,000,000

백만 토큰당 가격(USD)

05세션 비용이 정해지는 방식

Claude Code는 매 턴마다 대화 전체를 다시 보내고 프롬프트 캐시 대상으로 표시합니다. 캐시에서 읽힌 토큰은 입력 단가보다 낮은 캐시 입력 단가로 과금되므로, 긴 세션의 비용은 대부분 캐시 입력과 출력에서 나옵니다. 캐시는 기본 5분 동안 유지되어, 그보다 오래 쉬었다가 이어 가면 그 턴에서는 전체 컨텍스트가 입력 단가로 한 번 과금됩니다.

/model은 opus, sonnet, haiku 세 별칭 사이를 전환합니다. 각 별칭이 어떤 모델 id를 가리킬지는 ANTHROPIC_DEFAULT_OPUS_MODEL, ANTHROPIC_DEFAULT_SONNET_MODEL, ANTHROPIC_DEFAULT_HAIKU_MODEL 세 환경 변수로 정하며, 가격표에 있는 Claude id를 넣으면 됩니다. 평소 작업은 sonnet 등급으로 하고, 여러 번 고쳐도 풀리지 않는 문제에서만 상위 모델로 올리면 처음부터 끝까지 가장 비싼 모델을 쓸 때보다 비용이 줄어듭니다.

06Claude Code 전용 키에 예산 걸기

코딩 에이전트는 스스로 요청을 연달아 보내기 때문에 문제가 생기면 비용이 빠르게 늘어납니다. 콘솔에서 Claude Code 전용 키를 따로 만들고 달러 예산과 일일 사용 한도를 설정해 두십시오. 한도에 닿으면 게이트웨이가 402를 반환하고 그 키만 멈추며, 계정의 나머지 잔액은 그대로입니다.

제한 전체와 각 제한이 반환하는 오류 코드는 API 키 발급 페이지에, 충전 방법은 결제 페이지에 정리했습니다. 설정 파일 예시와 MCP 연결까지 다룬 단계별 가이드는 영어 문서에 있습니다. 예산 외에 같은 키에 함께 걸 수 있는 제한은 다음과 같습니다.

모델 허용 목록: 정해 둔 Claude id만 호출하도록 제한합니다.
속도 제한: 분당 요청 수와 분당 토큰 수의 상한입니다.
만료일: 지정한 시점이 지나면 키가 401을 반환합니다.

07Claude 이외의 모델을 Claude Code에서 쓸 때

Claude id는 Messages 형식 그대로 처리됩니다. GPT, Gemini, DeepSeek id를 넣어도 응답합니다. 게이트웨이가 Messages 요청을 해당 모델의 OpenAI 형식 요청으로 바꾸고 응답을 다시 바꿔 주며, 이 과정에서 thinking과 cache_control 필드는 빠집니다. Anthropic은 Claude가 아닌 모델에서의 Claude Code 사용을 지원하지 않으므로 tool use 동작이 덜 매끄러울 수 있습니다.

자주 묻는 질문

Claude Code를 구독 없이 API 키로만 쓸 수 있나요?: 쓸 수 있습니다. ANTHROPIC_BASE_URL을 https://api.relayswitch.io/v1 로, ANTHROPIC_AUTH_TOKEN을 RelaySwitch 키로 설정하면 매 턴이 선불 잔액에서 토큰 단위로 차감됩니다. 계정과 잔액은 RelaySwitch에 있으므로 claude.ai 로그인은 쓰이지 않습니다.
ANTHROPIC_BASE_URL 끝에 /v1을 붙여야 하나요?: 붙여도 되고 빼도 됩니다. 이 사이트의 예시는 https://api.relayswitch.io/v1 로 통일했습니다. Claude Code는 주소 뒤에 /v1/messages를 직접 붙이는데, 게이트웨이가 중복된 /v1을 처리합니다.
클로드 코드 요금은 어떻게 계산되나요?: 요청마다 입력, 캐시 입력, 출력 토큰 수에 모델별 단가를 곱해 잔액에서 차감합니다. 주간 한도나 초기화되는 할당량이 없고 쓴 만큼만 나갑니다. 요청별 실제 금액은 영수증과 콘솔의 Usage 페이지에서 확인합니다.
호출되는 모델이 진짜 Claude인지 어떻게 확인하나요?: 두 가지를 직접 볼 수 있습니다. 모든 모델에 매일 같은 점검 프롬프트를 보내 이전 응답과 비교한 결과가 https://api.relayswitch.io/v1/proof 에 키 없이 공개되고, 요청마다 모델 id와 과금 토큰, 비용이 적힌 서명된 영수증이 발급됩니다.
401, 402, 429 오류가 나면 무엇을 확인해야 하나요?: 401은 키가 틀렸거나 폐기되었거나 Claude Code가 읽지 않는 변수에 들어 있는 경우이니 /status로 확인합니다. 402는 잔액이 부족하거나 키에 설정한 예산 또는 한도에 닿은 경우입니다. 429는 키의 속도 제한이며 응답의 retry-after 값만큼 기다린 뒤 다시 시도합니다. 429, 502, 503은 과금되지 않습니다.
결제는 어떻게 하고 최소 금액은 얼마인가요?: 카드(Apple Pay, Google Pay) 또는 암호화폐로 충전하며 최소 $10입니다. 잔액은 달러로 표시되고 만료되지 않습니다.

환경 변수 두 개면 끝

Base URL과 키를 바꾸고, 쓴 토큰만큼만 선불 잔액에서 결제하십시오.

모델 API 키 받기