Claude Code 설치: Windows, macOS, Linux용 명령어, 구독 없이 API 키 사용 및 PayPal 없이 결제

간단히 말해 Claude Code는 터미널에서 한 줄만 실행하면 설치할 수 있으며, Node.js와 관리자 권한이 필요하지 않습니다. 사용할 줄은 창에 따라 달라집니다. macOS, Linux 및 WSL에서는 curl -fsSL https://claude.ai/install.sh | bash, Windows PowerShell에서는 irm https://claude.ai/install.ps1 | iex, 명령 프롬프트(CMD)에서는 아래의 세 번째 줄을 실행합니다. Claude 구독이 없다면 이후 API 키를 통해 Claude Code를 Kunavo에 연결하세요: ANTHROPIC_BASE_URL=https://api.kunavo.com(/v1 제외), ANTHROPIC_AUTH_TOKEN 및 네 개의 모델 변수입니다. 설정이 적용되었는지는 /status에서 확인할 수 있습니다. 결제는 $10부터 선불 잔액에서 토큰별로 차감되며, 직불카드 또는 신용카드(Visa 직불카드와 Mastercard 직불카드 포함), Apple Pay, Google Pay, Link 또는 오스트리아의 EPS로 충전할 수 있습니다. PayPal과 SEPA 자동이체는 사용할 수 없습니다.

# macOS, Linux, WSL
curl -fsSL https://claude.ai/install.sh | bash

# Windows PowerShell
irm https://claude.ai/install.ps1 | iex

:: Windows-Eingabeaufforderung (CMD)
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

Anthropic pflegt die Claude-Code-Dokumentation vollständig auf Deutsch, deshalb verweist diese Anleitung auf die deutschen Seiten. Die Befehle oben sind am 2026년 10월 3일 mit Claude Code 설정 abgeglichen, die Variablen mit der Liste der 환경 변수. Kunavos Preise und Zahlungswege sind auf dem Stand vom 2026년 10월 3일. Deutschland, Österreich und die Schweiz stehen in Anthropics 국가 목록 sowohl für Claude.ai als auch für die API (Stand 2026년 10월 3일). Eine englische Fassung gibt es unter Claude Code 설치.

전체 과정 개요

1. 설치: 위에서 시스템에 맞는 줄을 실행한 후 새 터미널 창을 엽니다.
2. 확인: claude --version이 버전 번호를 출력합니다.
3. 선택: Claude 구독으로 로그인하거나 API 키를 사용합니다(비교 내용은 아래 참조).
4. API 키 사용 시: 잔액 충전, 키 생성, 환경 변수 6개 설정
5. 확인: 세션에서 /status을 입력합니다.

사전 요구 사항: 현재 적용되는 내용

Manche deutschsprachigen Anleitungen beschreiben einen älteren Stand von Claude Code. Die Tabelle stellt verbreitete Angaben neben das, was die 공식 설정 페이지 am 2026년 10월 3일 verlangt.

macOS, Linux 및 WSL에 설치

터미널에 install.sh이 포함된 줄을 입력하세요. 공식 문서에서는 이 방법이 “Native Installation (권장)” 탭에 있습니다. 스크립트는 ~/.local/bin/claude에 실행 파일을 저장하며, 설치 후 백그라운드에서 자동으로 업데이트합니다. WSL에서는 WSL 터미널에서 같은 줄을 실행합니다.

Windows에 Claude Code 설치

Unter Windows entscheidet das offene Fenster, welche Zeile funktioniert, und ein Blick auf die Eingabezeile genügt: PS C:\Users\Name> ist PowerShell, C:\Users\Name> ohne PS ist die Eingabeaufforderung (CMD). Administratorrechte brauchen Sie laut 설정 페이지 für keine der beiden Varianten. Der Installer legt claude.exe unter %USERPROFILE%\.local\bin ab.

창을 잘못 선택하면 영어 메시지가 표시되며, 독일어 Windows에서는 경우에 따라 독일어 메시지가 표시됩니다. PowerShell에서 CMD 줄을 실행하면 The token '&&' is not a valid statement separator로 끝나고, CMD에서 PowerShell 줄을 실행하면 'irm' is not recognized as an internal or external command로 끝납니다. 두 경우 모두 의미는 같습니다. 잘못된 창에서 실행한 것이므로 다른 줄을 사용하세요.

Lassen Sie im Startmenü den Eintrag „Windows PowerShell (x86)“ links liegen. Laut 문제 해결 startet er einen 32-Bit-Prozess, und der Installer bricht dann auch auf einem 64-Bit-PC mit Claude Code does not support 32-bit Windows ab. Gibt [Environment]::Is64BitOperatingSystem in diesem Fenster True aus, ist Ihr Windows in Ordnung, und Sie öffnen einfach „Windows PowerShell“ ohne den Zusatz.

Git for Windows müssen Sie nicht installieren. Ist es vorhanden, führt Claude Code Shell-Befehle in der Git Bash aus, sonst in PowerShell. Findet Claude Code eine installierte Git Bash nicht, tragen Sie den Pfad zur bash.exe als CLAUDE_CODE_GIT_BASH_PATH in den env-Block von ~/.claude/settings.json ein, bei einer Standardinstallation C:\Program Files\Git\bin\bash.exe.

네이티브로 실행할지 WSL에서 실행할지는 프로젝트가 있는 위치에 따라 달라집니다:

WSL을 사용하면 WSL 터미널에서 claude을 설치하고 실행하세요. PowerShell이나 CMD에서는 실행하지 마세요.

대안: Homebrew, WinGet 및 npm

패키지 관리자를 통해 소프트웨어를 관리하고 싶다면 그렇게 할 수 있지만 한 가지 주의할 점이 있습니다. 문서에 따르면 Homebrew 및 WinGet 설치는 자동으로 업데이트되지 않으므로 정기적으로 upgrade을 실행해야 합니다. Homebrew는 두 가지 Cask를 제공합니다. claude-code는 안정 채널을 따르며 약 일주일 늦게 제공되고 주요 회귀가 있는 버전은 건너뜁니다. claude-code@latest는 모든 버전을 즉시 받습니다.

# Homebrew (macOS) – stabiler Kanal; claude-code@latest für den neuesten Stand
brew install --cask claude-code
brew upgrade claude-code              # aktualisiert sich nicht von selbst

# WinGet (Windows)
winget install Anthropic.ClaudeCode
winget upgrade Anthropic.ClaudeCode   # aktualisiert sich nicht von selbst

npm을 통한 설치

npm은 여전히 공식적으로 설명된 방법입니다. 사전 요구 사항은 Node.js 22 이상입니다. npm 패키지는 설치 프로그램과 동일한 네이티브 바이너리를 다운로드하며 실행 시 Node.js가 전혀 필요하지 않습니다. 따라서 이전 Node.js에서는 설치가 중단되지 않고 npm이 EBADENGINE 경고만 표시합니다. 아직 Node.js가 없다면 네이티브 설치 프로그램이 더 간단한 방법입니다.

node -v                                    # muss v22 oder neuer zeigen
npm install -g @anthropic-ai/claude-code   # niemals mit sudo

# später aktualisieren: mit @latest, nicht mit npm update -g
npm install -g @anthropic-ai/claude-code@latest

Drei Regeln aus der 설정 페이지: 없음 sudo npm install -g, weil das Rechteprobleme und Sicherheitsrisiken schafft. Aktualisieren mit @latest, denn npm update -g bleibt im ursprünglichen Versionsbereich hängen. Und optionale Abhängigkeiten nicht abschalten: Die Binärdatei kommt als plattformspezifische optionale Abhängigkeit, mit --omit=optional oder optional=false in der .npmrc fehlt sie, und claude meldet unter macOS und Linux Error: claude native binary not installed.

설치 확인

이를 위해 새 터미널 창을 여세요. 설치 전에 이미 열려 있던 창은 확장된 PATH를 아직 알지 못하므로 claude을 찾지 못합니다.

claude --version   # zeigt eine Versionsnummer wie 2.1.211 (Claude Code)
claude doctor      # Diagnose von Installation und Einstellungen, startet keine Sitzung

문제가 있을 때 사용하는 도구는 claude doctor입니다. 세션을 시작하지는 않지만 설치 상태, 설정 파일의 오류 및 해결 방법 제안이 포함된 경고를 표시합니다. 이를 통해 문제가 설치에 있는지 설정에 있는지 확인할 수 있습니다.

설치에 문제가 있을 때

다운로드가 HTML 또는 403을 반환함

Beginnt die Ausgabe mit syntax error near unexpected token '<' oder meldet curl einen 403, kam laut 문제 해결 (Stand 2026년 10월 3일) statt des Skripts eine Webseite oder ein Fehlerstatus zurück. Steht auf dieser Seite App unavailable in region, hält Anthropic die Verbindung für eine aus einem nicht unterstützten Land. Aus Deutschland, Österreich oder der Schweiz spricht das für einen VPN- oder Proxy-Ausgang im Ausland. Ein 403 ohne Text kann dieselbe Ursache haben oder von einer Firmen-Firewall kommen. Die Dokumentation rät, zuerst die Netzwerkverbindung zu prüfen, weil die anderen Installationswege dieselben Server ansprechen. Ein anderes Netz oder eine Freigabe durch die IT hilft hier mehr als ein anderer Installer.

“claude”를 찾을 수 없음

macOS와 Linux에서 command not found: claude가 표시되거나 Windows에서 claude을 인식하지 못한다는 것은 설치 폴더가 PATH에 없다는 뜻입니다. 대부분 새 창을 열면 해결됩니다. macOS나 Linux에서 해결되지 않으면 ~/.local/bin를 ~/.zshrc 또는 ~/.bashrc에 추가하세요. Windows에서는 문제 해결 안내에 따라 폴더를 확인하고 추가하세요:

# 1. Steht der Installationsordner schon im PATH?
$env:PATH -split ';' | Select-String '\.local\\bin'

# 2. Keine Ausgabe? Ordner zum Benutzer-PATH hinzufügen, dann ein neues Fenster öffnen
$currentPath = [Environment]::GetEnvironmentVariable('PATH', 'User')
[Environment]::SetEnvironmentVariable('PATH', "$currentPath;$env:USERPROFILE\.local\bin", 'User')

# 3. Im neuen Fenster
claude --version

PowerShell이 npm.ps1을 차단함

이는 npm 방식에만 해당합니다. npm.ps1 cannot be loaded because running scripts is disabled on this system 메시지는 실행 정책이 npm의 시작 스크립트를 차단한다는 뜻입니다. 정책의 적용을 받지 않는 npm.cmd 및 claude.cmd를 호출하거나, 네이티브 설치 프로그램으로 전환하거나, 사용자 계정에 대한 로컬 스크립트를 허용할 수 있습니다:

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

구독 또는 API 키?

Beim ersten Start will Claude Code wissen, wer bezahlt. Entweder melden Sie sich mit einem Claude-Konto an, oder Sie geben per Umgebungsvariable einen API-Key mit. Ist ein Key gesetzt, hat er laut Gateway 안내 Vorrang: Ein gespeicherter Login bleibt ungenutzt liegen und greift wieder, sobald Sie die Variable entfernen. Neu installieren müssen Sie für den Wechsel nichts.

Pro 또는 Max가 키보다 유리해지는 시점은 Claude Code 가격 가이드에서 확인할 수 있습니다.

API 키 설정(구독 없이)

Dass Claude Code einen anderen Endpunkt anspricht, ist kein Trick. ANTHROPIC_BASE_URL steht in Anthropics 변수 목록 und ist genau dafür da, Anfragen über einen Proxy oder ein Gateway zu leiten. Ein Plugin oder eine veränderte Claude-Code-Version brauchen Sie nicht.

1. Kunavo에 가입하고 이메일 주소나 Google 계정을 사용하세요.
2. Billing에서 최소 $10을 충전하세요(결제 수단은 결제 섹션 참조).
3. API Keys에서 키를 생성하세요. 키는 sk-kn-로 시작하며 한 번만 표시되므로 즉시 복사하세요.
4. 아래와 같이 변수를 설정하세요.

~/.zshrc 또는 ~/.bashrc에 입력하면 macOS, Linux 및 WSL에서 새로 여는 모든 터미널에 값이 적용됩니다:

export ANTHROPIC_BASE_URL=https://api.kunavo.com   # nur die Domain, ohne /v1
export ANTHROPIC_AUTH_TOKEN=sk-kn-...
export ANTHROPIC_MODEL=claude-sonnet-5
export ANTHROPIC_DEFAULT_OPUS_MODEL=claude-opus-5-5
export ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-5
export ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-haiku-4-5

PowerShell에서는 $env: 할당이 열려 있는 창에만 적용되므로 처음 테스트할 때 유용합니다:

# Gilt nur für dieses PowerShell-Fenster
$env:ANTHROPIC_BASE_URL = "https://api.kunavo.com"
$env:ANTHROPIC_AUTH_TOKEN = "sk-kn-..."
$env:ANTHROPIC_MODEL = "claude-sonnet-5"
$env:ANTHROPIC_DEFAULT_OPUS_MODEL = "claude-opus-5-5"
$env:ANTHROPIC_DEFAULT_SONNET_MODEL = "claude-sonnet-5"
$env:ANTHROPIC_DEFAULT_HAIKU_MODEL = "claude-haiku-4-5"
claude

Auf Dauer gehören die Werte in den env-Block von ~/.claude/settings.json (unter Windows %USERPROFILE%\.claude\settings.json). Diese Datei gilt laut Gateway 안내 (Stand 2026년 10월 3일) für alle Ihre Projekte. Gibt es sie schon, ergänzen Sie nur den env-Block:

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.kunavo.com",
    "ANTHROPIC_AUTH_TOKEN": "sk-kn-...",
    "ANTHROPIC_MODEL": "claude-sonnet-5",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-5-5",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-5",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-4-5"
  }
}

VS Code 확장 프로그램은 VS Code 사용자 설정의 claudeCode.environmentVariables(명령 Preferences: Open User Settings (JSON))에서 변수를 읽습니다.

{
  "claudeCode.environmentVariables": [
    { "name": "ANTHROPIC_BASE_URL", "value": "https://api.kunavo.com" },
    { "name": "ANTHROPIC_AUTH_TOKEN", "value": "sk-kn-..." },
    { "name": "ANTHROPIC_MODEL", "value": "claude-sonnet-5" },
    { "name": "ANTHROPIC_DEFAULT_OPUS_MODEL", "value": "claude-opus-5-5" },
    { "name": "ANTHROPIC_DEFAULT_SONNET_MODEL", "value": "claude-sonnet-5" },
    { "name": "ANTHROPIC_DEFAULT_HAIKU_MODEL", "value": "claude-haiku-4-5" }
  ]
}

각 변수의 기능

Warum ein festes Startmodell? Laut 모델 구성 (Stand 2026년 10월 3일) ist Opus 5.5 der Standard für API-Nutzer, und Aliase werden im Lauf der Zeit auf neue Versionen umgestellt. Kunavo bietet Opus 5.5 an; ein Start ganz ohne Modellvariablen läuft hier also auf Opus 5.5, das 토큰당 Claude Sonnet 5보다 두 배의 비용이 듭니다. Mit festen Modellnamen wissen Sie, welches Modell antwortet und zu welchem Tarif. Der Opus-Pin hält den Alias opus auf Claude Opus 5.5 (claude-opus-5-5), auch wenn Anthropic ihn später auf ein neueres Opus umstellt. Opus 5.5 kostet bei Kunavo pro Token 보다 적은 Claude Opus 5 ($2,80 / $14,00 gegenüber $3,50 / $17,50 pro 1 Mio. Input-/Output-Tokens) und setzt Claude Code ab Version 2.1.280 voraus; eine ältere Installation bringt claude update auf den aktuellen Stand. Der Sonnet-Pin ist Pflicht: Der Alias sonnet zeigt für API-Nutzer auf Sonnet 5.5, das Kunavo nicht anbietet, und ohne ANTHROPIC_DEFAULT_SONNET_MODEL enden /model sonnet, die Ausführungsphase von opusplan und Subagents mit model: sonnet mit 404. Claude Haiku 4.5 hält die Hintergrundaufgaben günstig, und mit /model wechseln Sie in der Sitzung jederzeit.

저장 위치와 관련해 두 가지를 알아두어야 합니다. 키는 프로젝트의 절대 .claude/settings.json에 넣으면 안 됩니다. Gateway 안내에 따르면 이 파일은 커밋되며 저장소를 복제하는 모든 사람에게 전달되기 때문입니다. 또한 셸의 export와 env 블록이 동일한 변수를 설정하면 설정 파일이 우선합니다. 따라서 셸에서 변수를 변경했는데 아무 일도 일어나지 않는다면 기존 값이 아직 settings.json에 남아 있을 가능성이 큽니다.

Die Modelle im Vergleich, Kunavo-Preise aus dem Katalog, Anthropics Listenpreise nach claude.com/de/pricing (Stand 2026년 10월 3일), jeweils pro 1 Mio. Tokens:

모든 Claude 모델과 요금은 Claude API 가격 가이드와 가격 페이지에서 확인할 수 있습니다.

첫 실행: /status로 확인

Wechseln Sie in Ihren Projektordner und starten Sie claude. Mit gesetztem ANTHROPIC_AUTH_TOKEN geht es direkt in die Sitzung, 로그인 화면 없이. Erscheint er trotzdem, hat Claude Code keinen Key gefunden. Der häufigste Grund laut Gateway 안내: Der Key steht nur in der .claude/settings.json oder .claude/settings.local.json des Projekts. Solche env-Blöcke wertet Claude Code in einer interaktiven Sitzung erst nach dem Einrichtungsassistenten und der Frage aus, ob Sie dem Ordner vertrauen. Legen Sie den Key deshalb in die Shell (export) oder in ~/.claude/settings.json.

세션에서 /status를 실행하면 Status 탭에 Claude Code가 주소와 인증 정보를 어디에서 가져오는지 표시됩니다. 다음 두 줄이 중요합니다.

Gateway 안내의 요청을 사용해 Claude Code 없이도 연결을 테스트할 수 있습니다(여기서는 모델을 claude-sonnet-5로 설정). 정확히 하나의 출력 토큰을 요청하므로 비용도 아주 적습니다. 명령은 셸 변수를 읽습니다. 값이 settings.json에만 있다면 테스트를 위해 추가로 export해야 합니다.

curl -sS -w '\n%{http_code}\n' -X POST "$ANTHROPIC_BASE_URL/v1/messages" \
  -H "Authorization: Bearer $ANTHROPIC_AUTH_TOKEN" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model": "claude-sonnet-5", "max_tokens": 1, "messages": [{"role": "user", "content": "."}]}'

Invoke-RestMethod -Method Post -Uri "$env:ANTHROPIC_BASE_URL/v1/messages" `
  -Headers @{ "Authorization" = "Bearer $env:ANTHROPIC_AUTH_TOKEN"; "anthropic-version" = "2023-06-01" } `
  -ContentType "application/json" `
  -Body '{"model": "claude-sonnet-5", "max_tokens": 1, "messages": [{"role": "user", "content": "."}]}'

{"id":"msg_로 시작하는 JSON이 반환되거나 PowerShell에서 id 속성이 msg_로 시작하는 객체가 반환되면 주소와 키가 올바른 것입니다. 401는 키가 거부되었다는 뜻입니다.

API 키 사용 시 달라지는 점

대부분은 그대로입니다. 코드 편집, 도구, 서브에이전트, MCP 서버, 훅 및 프롬프트 캐싱은 평소처럼 작동합니다. 다음 네 가지 차이점을 알아두세요.

• Remote Control과 음성 받아쓰기를 사용할 수 없습니다. Gateway 안내에 따르면 두 기능 모두 claude.ai ID가 필요하며 ANTHROPIC_AUTH_TOKEN 또는 ANTHROPIC_API_KEY가 활성화된 동안 차단됩니다. 또한 ANTHROPIC_BASE_URL가 Anthropic 외부의 호스트를 가리키면 버전 2.1.196부터 Remote Control이 추가로 차단됩니다.
• /fast는 Fast 모드를 사용할 수 없다고 표시합니다. Bearer 토큰만 있으면 Claude Code는 Fast 모드를 비활성화된 것으로 처리하고 사용 가능 여부 확인 요청도 전송하지 않습니다.
• MCP 도구 검색은 비활성화됩니다. Laut MCP 문서 (Stand 2026년 10월 3일) schaltet Claude Code sie ab, sobald ANTHROPIC_BASE_URL auf einen Drittanbieter zeigt; mit ENABLE_TOOL_SEARCH lässt sie sich ausdrücklich einschalten.
• /context는 추정값을 표시합니다. Kunavo bietet /v1/messages/count_tokens nicht an. Ohne diesen Endpunkt zählt Claude Code laut Gateway 호환성 가이드 (Stand 2026년 10월 3일) anhand der Zeichen.

통합에 관한 자세한 내용은 Claude Code 통합 가이드에서 확인할 수 있습니다(영어).

PayPal 및 SEPA 없이 결제하기

Vorweg eine Abgrenzung: Kunavo verkauft keine Claude-Abos, sondern Guthaben für API-Zugang, von dem Claude Code jeden Token abbucht. Für Pro und Max bei Anthropic gilt: Im Web nur Kredit- oder Debitkarte, in den Apps rechnen App Store bzw. Google Play ab (결제 FAQ). PayPal oder Venmo nimmt Anthropic laut dem 거부된 카드에 관한 도움말 nicht an (beides Stand 2026년 10월 3일).

Kunavo lädt über den Stripe-Checkout auf. Die Preise stehen in US-Dollar; wer aus Deutschland oder Österreich zahlt, sieht den Betrag in Euro. In diesem Kurs steckt laut Adaptive Pricing에 관한 Stripe 문서 (Stand 2026년 10월 3일) eine Umrechnungsgebühr von 2–4 %, die der Käufer trägt. Wählen Sie im Checkout US-Dollar, entfällt sie; dann rechnet Ihre Bank zu ihrem eigenen Kurs um und kann eigene Gebühren verlangen. Der Checkout bietet an:

EPS ist laut Stripe ein österreichisches Verfahren, das alle österreichischen Banken unterstützen. Sie werden auf die Seite Ihrer Bank weitergeleitet und bestätigen dort; es funktioniert nur bei Zahlung in Euro. Wer aus der Schweiz zahlt, nimmt Karte, Apple Pay, Google Pay oder Link.

girocard: Eine Karte, die nur girocard ist (früher EC-Karte), wird im Kunavo-Checkout nicht angenommen, weil Stripe girocard nicht unter seinen 지원되는 카드 브랜드 führt (Stand 2026년 10월 3일). Trägt Ihre Karte zusätzlich das Visa- oder Mastercard-Logo, läuft die Zahlung über dieses Netz, auch in Apple Pay und Google Pay.

제공되지 않음: PayPal, SEPA 자동이체, 수동 은행 송금(선불), giropay 및 Sofort. Klarna는 미국 구매자에게만 결제 화면에 표시됩니다. 미국 외 지역에서 통화를 미국 달러로 변경해도 Klarna는 표시되지 않습니다.

1. 계정 만들기; Kunavo는 가입 시 카드를 요구하지 않습니다.
2. Billing에서 $10부터 시작하는 충전 단계를 선택합니다. 더 큰 단계에는 보너스 잔액이 제공됩니다: $100 ergeben $110, $1.000 ergeben $1.200, $5.000 ergeben $6.250.
3. Stripe 결제 화면에서 결제 방법을 선택합니다. 확인 전에 유로 금액을 볼 수 있으며, EPS를 선택한 경우 온라인 뱅킹에서 확인합니다.
4. API 키에서 키를 만들고 ANTHROPIC_AUTH_TOKEN로 입력합니다.

잔액은 선불입니다. 월 이용료가 없고 만료되지 않으며 실패한 요청에는 요금이 부과되지 않습니다. 자동 충전은 저장된 카드 또는 Link를 사용해야만 가능하고, Apple Pay, Google Pay 및 EPS로는 수동으로 충전합니다. Kunavo는 부가가치세가 명시된 세금계산서를 발행하지 않습니다. 충전 내역은 Billing에서 확인할 수 있습니다. 결제 방법과 거부된 카드에 대한 자세한 내용은 신용카드 없이 Claude 결제하기를 참조하세요.

세션 비용: 계산 예시

API 키를 사용하면 토큰 단위로 비용이 발생하며 Claude Code는 각 단계마다 지금까지의 전체 컨텍스트를 함께 전송합니다. 그래도 이 컨텍스트 전체에 매번 비용이 부과되는 것은 아닙니다. 변경되지 않은 시작 부분은 모델이 캐시에서 읽으며, 이 경우 더 낮은 캐시 읽기 요금이 적용됩니다. 다음 표는 가정한 패턴을 계산한 것으로, 측정값도 상한값도 아닙니다. 가정:

• 요청당 40.000 Input 토큰. 그중 36.000(90%)는 캐시에서 읽고 4.000는 캐시에 새로 기록됩니다.
• 요청당 1.000 Output 토큰
• 작업 세션당 이러한 요청 50회, 백그라운드 호출은 제외
• 캐시 읽기 비용은 Claude Sonnet 5에서 Input 요금의 10 %이고, 캐시 쓰기 비용은 1,25배입니다. 표의 각 모델은 자체 요율을 적용해 계산했습니다.

실제 비용은 컨텍스트 길이, 캐시 적중 여부, 응답 길이, 그리고 두 작업 사이에 /clear로 새로 시작하는지에 따라 달라집니다. 직접 수치를 계산하려면 Claude 토큰 계산기(영어)를 사용하세요. Pro 및 Max와의 비교는 Claude Code 가격 가이드에서 계산합니다.

오류 메시지와 의미

이 방식의 한계

• 토큰 단위로 결제되며 정액제가 아닙니다. Claude Code를 매일 여러 시간 사용하는 경우 Pro 또는 Max가 더 저렴한 경우가 많습니다. 사용량이 변동한다면 발생한 비용만 지불하며, 한 달 동안 사용하지 않으면 비용이 발생하지 않습니다.
• claude.ai 계정이 없으면 Remote Control과 음성 받아쓰기를 사용할 수 없습니다. /fast는 꺼진 것으로 처리되며 MCP 도구 검색도 기본적으로 비활성화됩니다.
• 현재 Kunavo는 Sonnet 5.5를 제공하지 않습니다. 따라서 /model sonnet, opusplan 및 Sonnet 서브에이전트에는 위 예시의 Sonnet 고정 설정이 필요합니다.
• Apple Pay, Google Pay 및 EPS는 수동 충전에만 사용할 수 있으며 자동 충전은 카드 또는 Link로만 가능합니다. 유로 금액에는 Stripe의 환전 수수료가 포함됩니다.
• Kunavo는 부가가치세가 명시된 세금계산서를 발행하지 않습니다.
• Anthropic의 Claude Code 문서는 독일어로 제공되지만 Kunavo의 통합 가이드는 영어로만 제공됩니다.

자주 묻는 질문