구독 없이 Claude Code API 사용하기
Claude Code 로컬 terminal은 월간 Claude plan 대신 API billing을 사용할 수 있습니다. 무료가 되는 것이 아니라 인증과 과금 방식이 바뀝니다.
구독 없이 Claude Code API를 사용하려면 유료 Claude.ai plan으로 로그인하는 대신 API billing Provider를 선택합니다. Anthropic은 Claude Console API, cloud provider, LLM gateway와 Pro, Max, Team, Enterprise subscription 인증을 별도로 지원합니다.
OmniaKey를 사용하면 prepaid balance를 충전하고 API key를 만든 뒤 Anthropic-compatible Base URL과 bearer token을 Claude Code에 제공합니다. 이 경로에는 월간 Claude subscription이 없지만 모든 model request는 유료입니다.
구독이 없다고 무료 또는 무제한이라는 뜻은 아닙니다. 정액 plan과 포함된 사용량을 종량제 API billing으로 바꾸는 것입니다. 잔액이 있고 권한이 있는 API 또는 gateway account가 필요합니다.
Claude Code에 subscription이 필요한가요?
Local terminal workflow에서는 필수가 아닙니다.
| 경로 | 인증 | 결제 | 적합한 경우 |
|---|---|---|---|
| Claude Pro/Max/Team/Enterprise | /login subscription OAuth | 사용량이 포함된 정액 plan | 일반 대화 사용과 hosted surface |
| Claude Console | Console login 또는 ANTHROPIC_API_KEY | Anthropic API usage | 공식 API 직접 과금 |
| OmniaKey 같은 LLM gateway | ANTHROPIC_BASE_URL + ANTHROPIC_AUTH_TOKEN | Gateway balance/contract | 종량제, 하나의 잔액, 중앙 사용량 관리 |
| Bedrock, Google Cloud, Foundry | Cloud credentials | Cloud provider 청구 | Cloud platform 표준화 조직 |
Anthropic authentication 문서는 ANTHROPIC_AUTH_TOKEN이 ANTHROPIC_API_KEY와 저장된 subscription OAuth보다 우선한다고 설명합니다. 따라서 gateway session은 Claude subscription과 독립적으로 실행할 수 있습니다.
이 글은 local Claude Code CLI를 다룹니다. Claude Code on the Web은 subscription credentials를 사용하며 환경 API key로 hosted surface를 덮어쓸 수 없습니다.
OmniaKey로 Claude Code 종량제 설정
1. Claude Code 설치
Anthropic의 현재 Claude Code 설치 안내를 따른 뒤 확인합니다.
claude --version
Client 설치는 model request를 위한 잔액을 만들지 않습니다. 다음 credential이 청구 경로를 결정합니다.
2. 잔액과 API key 준비
OmniaKey에 잔액을 넣고 API Keys dashboard에서 key를 만드세요. Machine 또는 automation environment마다 별도 key를 쓰면 하나를 revoke해도 다른 환경은 유지됩니다.
3. Base URL과 bearer token 설정
macOS/Linux:
export ANTHROPIC_BASE_URL="https://api.omniakey.com"
export ANTHROPIC_AUTH_TOKEN="your-omniakey-api-key"
claude
PowerShell:
$env:ANTHROPIC_BASE_URL = "https://api.omniakey.com"
$env:ANTHROPIC_AUTH_TOKEN = "your-omniakey-api-key"
claude
ANTHROPIC_AUTH_TOKEN은 Authorization: Bearer credential로 전송됩니다.
Base URL에는 /v1을 넣지 마세요. Claude Code가 /v1/messages를 추가합니다. 설정값 https://api.omniakey.com/v1 produces the wrong /v1/v1/messages path.
Windows 설정과 endpoint 계약은 Claude Code API key guide, 제품별 절차는 OmniaKey Claude Code setup에서 확인하세요.
4. 활성 billing 경로 확인
Claude Code에서 실행합니다.
/status
작은 read-only request를 보내고 OmniaKey dashboard에 usage가 기록되는지 확인하세요. ANTHROPIC_BASE_URL만 설정하면 subscription credential이 교체되지 않습니다.
같은 shell에 ANTHROPIC_API_KEY도 있다면 의도한 경로를 분명히 하도록 제거합니다.
unset ANTHROPIC_API_KEY
공유 automation에서는 credential을 확인하지 않고 unset하지 마세요.
Pay-as-you-go Claude Code 비용
Claude Code는 agent loop라서 repository, context, cache, thinking, retry, MCP, parallel session에 따라 비용이 달라집니다.
2026년 9월 18일 확인한 OmniaKey의 1M token당 USD 요금:
| Model | Input | Cache hit | Output | 예: 1M input + 100K output |
|---|---|---|---|---|
| Claude Haiku 4.5 | $0.28 | $0.028 | $1.40 | $0.42 |
| Claude Sonnet 5 | $0.84 | $0.084 | $4.20 | $1.26 |
| Claude Opus 5 | $1.40 | $0.14 | $7.00 | $2.10 |
예시는 uncached input이며 cache write, long-context modifier, retry, 추가 tool turn을 제외합니다. 전체 coding task 예측이 아닌 비교 단위입니다.
API billing이 적합한 경우
- Claude Code를 매일이 아니라 가끔 또는 bursty하게 사용;
- 실제 request에 맞춰 지불;
- 여러 coding tool을 하나의 잔액으로 관리;
- local machine/CI에 revoke 가능한 key 필요;
- routine은 저렴한 모델, 어려운 task는 명시적 escalation.
매일 많이 사용하거나 Web이 필요하고 subscription-only 기능이 필요하면 subscription이 더 나을 수 있습니다. 자신의 usage를 측정하지 않고 어느 쪽이 더 싸다고 단정하지 마세요.
API spend 줄이기
Usage 자체를 줄이려면 Claude Code token 절감 가이드를 사용하세요. Context, tool output, effort, 완료 task 측정을 다룹니다.
작업에 맞는 model로 시작
Sonnet 5는 daily default, Haiku 4.5는 좁고 반복적인 task, Opus 5는 ambiguity와 error cost가 큰 task에 적합합니다. 자세한 정책은 Claude Code model guide를 참고하세요.
관련 없는 작업 사이에 오래된 context 정리
긴 대화는 context를 재전송합니다. 필요한 session을 rename하고 다른 작업 전에 /clear를 사용하세요.
사용하지 않는 tool 끄기
Active integration은 tool definition과 result를 context에 넣습니다. MCP를 필요한 만큼만 켜고 큰 log를 그대로 주지 마세요.
한 응답이 아닌 완료된 결과 평가
싼 token rate도 correction이 반복되면 이점이 사라집니다. Merge된 fix, 승인된 review, 통과한 feature의 전체 비용을 retry와 human cleanup까지 포함해 기록하세요.
자주 하는 실수
ANTHROPIC_BASE_URL만 설정
URL은 network destination만 바꿉니다. 대응하는 ANTHROPIC_AUTH_TOKEN을 설정하고 /status로 확인하세요.
Base URL에 /v1 추가
올바른 값은 https://api.omniakey.com, 잘못된 값은 https://api.omniakey.com/v1. Claude Code가 Messages API path를 추가합니다.
Direct와 gateway credential 혼합
ANTHROPIC_AUTH_TOKEN이 우선하지만 관련 없는 secret을 같은 환경에 두면 디버깅이 어려워집니다.
Hosted web product가 API key를 사용할 것으로 기대
Claude Code on the Web은 subscription credentials를 사용합니다. 이 설정은 local CLI용입니다.
“구독 없음”을 “결제 없음”으로 이해
API billing에는 잔액이 필요합니다. Zero balance, revoked key, spending limit은 request를 멈춥니다.
FAQ
Claude Pro/Max 없이 Claude Code를 쓸 수 있나요?
네. Local CLI는 Claude Console API, 지원되는 cloud provider, LLM gateway로 인증할 수 있습니다. 유효한 credential과 잔액이 필요합니다.
Subscription 없이 API usage가 무료인가요?
아닙니다. Model call은 API 또는 gateway account에 종량제로 청구됩니다.
API key가 Claude subscription allowance를 사용하나요?
의도한 API/gateway credential이 active라면 사용하지 않습니다. /status와 Provider dashboard로 확인하세요.
Claude Code on the Web에서 이 설정을 쓸 수 있나요?
아니요. Hosted web product는 subscription credentials를 사용합니다.
OmniaKey에는 어떤 변수를 쓰나요?
ANTHROPIC_AUTH_TOKEN에 bearer token을 넣고 ANTHROPIC_BASE_URL=https://api.omniakey.com. URL 끝에 /v1을 넣지 마세요.
확인한 출처
- Anthropic: Claude Code authentication
- Anthropic: manage Claude Code costs
- Anthropic: connect Claude Code to an LLM gateway
- Anthropic: Claude API pricing
- OmniaKey Claude Code API key guide
팩트체크 날짜: 2026년 9월 18일. 인증, 모델 availability, 가격은 바뀔 수 있으므로 실제 사용 전 1차 문서와 live catalog를 다시 확인하세요.
Related English references: Claude Sonnet 5 (English), Claude Haiku 4.5 (English), Claude Opus 5 (English), transparent billing (English), and model catalog (English).