Windows, macOS 및 Linux에 Claude Code 설치하기 — 구독 없는 API key 및 BLIK 결제

Claude Code는 하나의 공식 명령으로 설치됩니다(macOS 및 Linux, PowerShell, CMD용 버전은 아래 참조). Anthropic은 네이티브 설치 프로그램을 권장하며, npm은 Node.js 22 이상이 필요한 대안입니다. Pro/Max 구독과 로그인 없이 ANTHROPIC_BASE_URL=https://api.kunavo.com를 설정하고(/v1 제외), API 키가 포함된 ANTHROPIC_AUTH_TOKEN와 모델을 고정하는 네 개의 변수를 설정하면 충분합니다. 그러면 10 USD부터 BLIK으로 즈워티 충전한 잔액에서 사용한 토큰 비용만 지불합니다. 마지막으로 Claude Code에서 /status를 입력하여 키가 작동하는지 확인하세요.

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

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

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

Polecenia i zmienne sprawdziliśmy 2026년 10월 3일 w Claude Code 공식 설치 문서 i w 환경 변수 문서. Polskiej wersji tej dokumentacji nie ma. Ceny i metody płatności sprawdziliśmy 2026년 10월 3일. Polska jest na Anthropic 지원 국가 목록 (sprawdzone 2026년 10월 3일), zarówno dla Claude.ai, jak i dla API.

로그인 또는 API 키?

설치 후 Claude Code는 인증해야 합니다. 두 가지 방법이 있으며, 이 가이드에서는 두 번째 방법을 자세히 설명합니다:

시작하기 전에

방법 1: 네이티브 설치 프로그램(권장)

공식 문서에서 이 방법에는 “Native Install (Recommended)” 탭이 있습니다. 명령은 페이지 상단에서 확인할 수 있습니다. macOS, Linux 및 WSL에서는 install.sh가 포함된 행을 사용합니다. Windows PowerShell에서는 irm … | iex를, CMD 명령 프롬프트에서는 install.cmd가 포함된 행을 사용하세요. 네이티브 설치는 백그라운드에서 자동으로 업데이트됩니다. Claude Code는 Homebrew 또는 WinGet으로도 설치할 수 있지만 문서에 따르면 이러한 설치는 기본적으로 자동 업데이트되지 않으므로 패키지 관리자에서 수동으로 업데이트해야 합니다:

# Homebrew – kanał stable; domyślnie nie aktualizuje się sam
brew install --cask claude-code

# WinGet (Windows) – domyślnie nie aktualizuje się sam
winget install Anthropic.ClaudeCode

설치 후 새 터미널 창을 여세요. 이전에 열어 둔 창에서는 업데이트된 PATH 변수를 인식하지 못하기 때문입니다. 그런 다음 확인하세요:

claude --version   # wypisuje numer wersji, np. 2.1.280 (Claude Code)
claude doctor      # diagnostyka instalacji i ustawień, bez otwierania sesji

claude doctor는 세션을 열지 않습니다. 설치 상태와 설정 파일 진단만 출력합니다. 따라서 설치 문제와 구성 문제를 가장 빠르게 구분할 수 있습니다.

다운로드가 실패할 때

Jeśli terminal pokazuje syntax error near unexpected token '<' albo curl: (22) The requested URL returned error: 403, to według 공식 설치 문제 페이지 (sprawdzone 2026년 10월 3일) adres instalatora zwrócił stronę HTML lub kod błędu zamiast skryptu. Strona z napisem App unavailable in region oznacza według dokumentacji, że Claude Code nie jest dostępny w Twoim kraju. Polska jest jednak na liście obsługiwanych krajów, więc jeśli widzisz ten napis w Polsce, sprawdź, czy połączenie nie wychodzi przez VPN albo proxy. Samo 403 bez treści może też pochodzić z firmowego proxy lub zapory, która blokuje pobieranie. Dokumentacja radzi wtedy najpierw sprawdzić połączenie sieciowe, bo inne metody instalacji łączą się z tymi samymi serwerami. Spróbuj z innej sieci albo poproś administratora o odblokowanie tych adresów.

방법 2: npm(Node.js 22 이상)

npm nadal jest jedną z metod opisanych w oficjalnej dokumentacji. Pakiet wymaga Node.js 22 lub nowszego. Część polskich poradników wciąż podaje Node.js 18, co jest już nieaktualne. Na starszym Node.js npm wypisze ostrzeżenie EBADENGINE, ale nie przerwie instalacji, a claude będzie działać, bo pakiet pobiera natywny program, który nie korzysta z Node.js w czasie działania. Jeśli nie masz Node.js, zainstaluj wersję 22 lub nowszą ze nodejs.org 페이지.

node -v                                    # potrzebna wersja v22 lub nowsza
npm install -g @anthropic-ai/claude-code   # bez sudo

# aktualizacja: @latest, a nie npm update -g
npm install -g @anthropic-ai/claude-code@latest

• sudo npm install -g를 절대 사용하지 마세요. 문서에서는 이 방법이 권한 문제를 일으키며 보안 위험이 된다고 경고합니다.
• @latest를 통해 업데이트하세요. 업데이트에는 npm install -g @anthropic-ai/claude-code@latest를 사용하고 npm update -g는 사용하지 마세요.
• 선택적 종속성을 건너뛰지 마세요. 실제 프로그램은 선택적 종속성, 즉 플랫폼에 맞는 @anthropic-ai/claude-code-* 패키지로 설치됩니다. --omit=optional 플래그를 사용하거나 .npmrc에서 optional=false를 설정하면 macOS 또는 Linux 설치가 claude native binary not installed 메시지와 함께 종료됩니다.

Windows에서의 Claude Code: PowerShell, CMD, WSL 및 PATH

Windows에는 서로 다른 두 가지 설치 명령이 있으며 선택은 터미널에만 좌우됩니다. 행이 PS C:\Users\TwojaNazwa>로 시작하면 PowerShell에서 작업 중입니다. PS 없이 C:\Users\TwojaNazwa>만 보이면 명령 프롬프트(CMD)입니다. 문서에 따르면 터미널을 관리자 권한으로 실행할 필요가 없습니다. 일부 가이드에서는 그렇게 권장하지만요.

가장 흔한 오류는 잘못된 터미널에 명령을 붙여 넣는 것입니다. CMD용 행을 PowerShell에 붙여 넣으면 The token '&&' is not a valid statement separator가 표시됩니다. PowerShell용 행을 CMD에 붙여 넣으면 'irm' is not recognized as an internal or external command이 표시됩니다. 폴란드어 Windows에서는 같은 메시지가 “irm은 내부 또는 외부 명령, 실행 가능한 프로그램 또는 배치 파일로 인식되지 않습니다”로 표시됩니다. 반대로 macOS의 curl … | bash 행을 PowerShell에 붙여 넣으면 A parameter cannot be found that matches parameter name 'fsSL' 또는 'bash' is not recognized as the name of a cmdlet 오류가 발생합니다. 이러한 경우에는 사용 중인 터미널에 맞는 행을 사용하면 됩니다.

시작 메뉴에는 “Windows PowerShell”과 “Windows PowerShell (x86)” 두 항목이 있습니다. 후자는 32비트 프로세스로 실행되므로 64비트 컴퓨터에서도 Claude Code does not support 32-bit Windows 오류가 발생합니다. (x86) 표기가 없는 항목을 여세요.

Git for Windows jest opcjonalny, ale zalecany. Gdy jest zainstalowany, Claude Code wykonuje polecenia przez dołączony do niego Git Bash, a bez niego przez PowerShell. Jeśli Git jest zainstalowany, ale Claude Code nie znajduje Git Bash, ustaw w bloku env pliku ~/.claude/settings.json zmienną CLAUDE_CODE_GIT_BASH_PATH ze ścieżką do bash.exe. Przykładowa ścieżka z dokumentacji to C:\Program Files\Git\bin\bash.exe.

WSL을 선택하는 경우 macOS 및 Linux용 행을 WSL 터미널에서 실행하고, PowerShell이나 CMD가 아닌 그곳에서 claude도 시작하세요.

스크립트 실행 정책 오류(PowerShell에서 npm 사용)

npm으로 설치하거나 실행할 때 npm.ps1 cannot be loaded because running scripts is disabled on this system 메시지가 나타나면 PowerShell 실행 정책이 npm이 생성한 시작 스크립트 .ps1를 차단하고 있다는 의미입니다. 문서에 따르면 현재 사용자에게 로컬 스크립트 실행을 허용하는 명령(아래 명령)을 사용하거나, npm.cmd 및 claude.cmd를 사용하거나, PowerShell용 네이티브 설치 프로그램으로 전환할 수 있습니다.

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

설치 후 “claude” 명령이 인식되지 않음

command not found: claude 또는 'claude' is not recognized은 설치 디렉터리가 PATH에 없다는 의미입니다. 네이티브 설치 프로그램은 macOS와 Linux에서는 ~/.local/bin/claude에, Windows에서는 %USERPROFILE%\.local\bin\claude.exe에 프로그램을 배치합니다. 먼저 새 터미널을 여세요. Windows에서 여전히 작동하지 않으면 문서에 안내된 대로 PowerShell에서 경로를 확인하고 추가하세요:

# 1. Sprawdź, czy katalog instalacji jest już w PATH
$env:PATH -split ';' | Select-String '\.local\\bin'

# 2. Brak wyniku? Dopisz go do PATH użytkownika, zamknij i otwórz terminal
$currentPath = [Environment]::GetEnvironmentVariable('PATH', 'User')
[Environment]::SetEnvironmentVariable('PATH', "$currentPath;$env:USERPROFILE\.local\bin", 'User')

# 3. W nowym terminalu
claude --version

로그인 대신 API 키 사용(구독 없이)

ANTHROPIC_BASE_URL은 Claude Code에 내장된 변수입니다. 공식 문서에 따르면 이 변수는 API 엔드포인트를 재정의하여 프록시 또는 게이트웨이를 통해 요청을 전달합니다. 따라서 Claude Code를 Anthropic Messages API와 호환되는 서비스에 연결하는 것은 Anthropic이 의도한 구성입니다. 플러그인이나 수정된 프로그램은 필요하지 않습니다. macOS와 Linux에서는 셸 구성 파일(~/.zshrc 또는 ~/.bashrc)에 변수를 추가하세요:

export ANTHROPIC_BASE_URL=https://api.kunavo.com   # sama domena, bez /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

Windows에서는 먼저 하나의 PowerShell 창에서 구성을 확인할 수 있습니다:

# Działa tylko w tym oknie PowerShella – po zamknięciu znika
$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

영구적으로 설정하려면 사용자 설정 파일 ~/.claude/settings.json(Windows에서는 %USERPROFILE%\.claude\settings.json)의 env 블록에 변수를 입력하는 것이 가장 좋습니다. 문서에 따르면 이 파일은 모든 프로젝트에 적용됩니다. 파일에 다른 설정이 이미 있다면 env 블록만 추가하세요:

{
  "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"
  }
}

이 여섯 줄은 각각 쉽게 실수할 수 있습니다:

• ANTHROPIC_BASE_URL는 도메인 자체입니다. Claude Code는 /v1/messages를 자동으로 덧붙입니다. 끝에 /v1가 있으면 요청이 /v1/v1/messages로 전송되어 404를 반환합니다.
• ANTHROPIC_AUTH_TOKEN이며, ANTHROPIC_API_KEY가 아닙니다. ANTHROPIC_AUTH_TOKEN 값은 Authorization 헤더에 Bearer 접두사와 함께 전달되어 즉시 작동합니다. ANTHROPIC_API_KEY은 x-api-key 헤더로 전달되며, 대화형 모드에서는 한 번 승인해야 합니다. 이때 거부하면 키가 조용히 무시됩니다. /config → Use custom API key에서 다시 활성화할 수 있습니다.
• ANTHROPIC_MODEL는 기본 모델을 선택합니다. 여기서는 Claude Sonnet 5(claude-sonnet-5)입니다. 이름은 Kunavo 모델 목록에 있는 것과 정확히 같아야 합니다. 끝에 날짜가 붙은 이전 이름은 Kunavo에서 인식하지 못합니다.
• ANTHROPIC_DEFAULT_OPUS_MODEL와 ANTHROPIC_DEFAULT_SONNET_MODEL는 opus 및 sonnet 별칭을 고정합니다. Według 공식 모델 구성 문서 (sprawdzone 2026년 10월 3일) dla użytkowników API model domyślny i alias opus wskazują Opus 5.5, a alias sonnet wskazuje Sonnet 5.5. Aliasy z czasem się zmieniają, a wersję przypina się pełną nazwą modelu albo zmiennymi takimi jak te dwie. Zapytanie o model, którego nie ma w Kunavo, zwraca 404. Alias opus przypinamy do Claude Opus 5.5 (claude-opus-5-5), bo kolejny Opus wydany przez Anthropic nie musi być od razu dostępny w Kunavo. Opus 5.5 wymaga Claude Code w wersji 2.1.280 lub nowszej, starszą wersję zaktualizujesz poleceniem claude update. Sonnet 5.5 nie jest obecnie (stan na 2026년 10월 3일) dostępny w Kunavo, więc bez przypięcia aliasu sonnet do claude-sonnet-5 błąd 404 zwracają /model sonnet, faza wykonania w trybie opusplan i subagenci ustawieni na model: sonnet.
• ANTHROPIC_DEFAULT_HAIKU_MODEL은 백그라운드 작업도 처리합니다. 문서에 따르면 이 변수는 haiku 별칭과 백그라운드에서 실행되는 기능에 사용할 모델을 선택합니다. Kunavo에서 Claude Haiku 4.5의 비용은 입력 토큰 100만 개당 0,70 USD, 출력 토큰 100만 개당 3,50 USD입니다. 주 모델 Claude Sonnet 5의 비용은 1,40 USD / 7,00 USD (Anthropic 정가: 2,00 USD / 10,00 USD)이고, Claude Opus 5.5의 비용은 2,80 USD / 14,00 USD(입력 / 출력, 토큰 100만 개당)입니다.

Klucza 아니요 wpisuj do projektowego .claude/settings.json. Według 게이트웨이 연결 문서 ten plik trafia do repozytorium, a więc do każdego, kto je sklonuje. Pamiętaj też o kolejności pierwszeństwa. Gdy ta sama zmienna jest ustawiona i w powłoce, i w bloku env pliku ustawień, w większości sesji obowiązuje wartość z pliku ustawień. Osobna zasada dotyczy klucza model w pliku ustawień: zmienna ANTHROPIC_MODEL ma przed nim pierwszeństwo, a model działa tylko wtedy, gdy zmiennej nie ma. Jeśli zmiana w powłoce nie działa, najpierw sprawdź plik ustawień. W rozszerzeniu Claude Code dla VS Code zmienne ustawia się w claudeCode.environmentVariables, w ustawieniach użytkownika samego VS Code.

첫 실행 및 /status

게이트웨이 연결 문서(2026년 10월 3일 확인)에 따르면 ANTHROPIC_AUTH_TOKEN이 설정된 상태에서 claude 명령은 로그인 화면 없이 즉시 세션을 엽니다. 이 변수는 즉시 적용되며 ANTHROPIC_API_KEY처럼 승인할 필요가 없습니다. 대신 로그인 화면이 표시된다면 Claude Code가 키를 읽지 못한 것입니다.

키는 Claude Code가 최초 구성 전에 읽는 위치에 있어야 합니다. 즉 셸에서 export 명령으로 설정하거나 사용자 설정 파일 ~/.claude/settings.json의 env 블록에 설정해야 합니다. 대화형 모드에서는 프로젝트의 .claude/settings.json 또는 .claude/settings.local.json에 있는 env 블록이 최초 실행 마법사와 폴더 신뢰 여부를 묻는 단계를 거친 후에야 적용됩니다. 최초 실행 시 프로젝트 설정에만 키가 있으면 어쨌든 로그인 화면이 표시됩니다.

세션에서 /status를 입력하고 다음 두 줄을 확인하세요:

• Anthropic base URL는 게이트웨이 주소가 설정된 경우에만 나타납니다. https://api.kunavo.com을 표시해야 합니다. 이 줄이 없으면 ANTHROPIC_BASE_URL가 세션에 전달되지 않은 것입니다.
• Auth token에 ANTHROPIC_AUTH_TOKEN이라는 이름이 표시되면 저장된 claude.ai 로그인 정보가 아니라 API 키가 작동 중이라는 뜻입니다. claude.ai 계정과 함께 Login method가 표시되면 변수가 적용되지 않은 것입니다.

Claude Code를 실행하기 전에 공식 문서의 방법으로 주소와 키를 확인할 수도 있습니다. 이 방법은 출력 토큰 1개를 요청하여 잔액에서 소액을 차감합니다. 명령은 현재 셸의 변수를 읽으므로 키가 설정 파일에 있더라도 먼저 이 터미널에서 export 명령으로 변수를 설정하세요. {"id":"msg_로 시작하는 JSON 응답은 주소와 키가 작동한다는 뜻입니다. 401 코드는 키가 거부되었음을 뜻합니다.

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": "."}]}'

PowerShell에서는 같은 확인이 다음과 같이 표시됩니다. 모두 정상적으로 작동하면 응답에 id 필드가 msg_로 시작하는 값으로 표시됩니다:

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": "."}]}'

API 키 사용 시 달라지는 점

• Remote Control과 음성 받아쓰기를 사용할 수 없습니다. 문서에 따르면 이 기능들은 claude.ai ID가 필요하며 ANTHROPIC_AUTH_TOKEN이 활성화된 경우 작동하지 않습니다. 버전 2.1.196부터는 ANTHROPIC_BASE_URL가 api.anthropic.com 이외의 호스트를 가리킬 때 Remote Control도 비활성화됩니다.
• /fast는 빠른 모드를 비활성 상태로 표시합니다. 문서에 따르면 bearer 토큰만 있는 경우 Claude Code는 fast mode를 비활성 상태로 처리하고 사용 가능 여부를 확인하는 요청을 보내지 않습니다.
• MCP 도구 검색은 기본적으로 비활성화되어 있습니다. ANTHROPIC_BASE_URL가 Anthropic과 다른 호스트를 가리킬 때 이렇게 됩니다.
• /context의 수치는 추정치입니다. Kunavo nie udostępnia endpointu /v1/messages/count_tokens. Według 게이트웨이 호환성 문서 (sprawdzone 2026년 10월 3일) Claude Code liczy wtedy tokeny lokalnie na podstawie liczby znaków.

전체 통합 설명은 Claude Code 통합 문서(영어)에서, 이 가이드의 영어 버전은 Install Claude Code 문서에서 확인할 수 있습니다.

BLIK 결제: 잔액 충전 및 API 키

Subskrypcje Claude kupowane przez stronę Anthropic można opłacić wyłącznie kartą kredytową lub debetową (Claude 결제 FAQ, sprawdzone 2026년 10월 3일). BLIK-iem nie zapłacisz za Pro ani za Max. W Kunavo BLIK doładowuje przedpłacone saldo API, z którego Claude Code płaci za tokeny po ustawieniu klucza tak jak wyżej. Wszystkie kroki płatności opisuje poradnik BLIK으로 Claude 결제하기, a w skrócie wygląda to tak:

1. 이메일 또는 Google 계정으로 Kunavo 계정을 만드세요. 가입할 때 카드를 입력할 필요가 없습니다.
2. 결제(Billing) 탭에서 충전 금액을 선택하세요. 최소 금액은 10 USD이며 월 요금은 없습니다. 금액이 클수록 보너스를 받습니다: 100 USD → 110 USD na saldzie, 1000 USD → 1200 USD na saldzie, 5000 USD → 6250 USD na saldzie.
3. Na stronie płatności Stripe kwota jest pokazana w złotych. Wybierz BLIK, wygeneruj w aplikacji bankowej sześciocyfrowy kod, wpisz go i potwierdź płatność w aplikacji. Według Stripe 문서 (sprawdzone 2026년 10월 3일) kod BLIK jest ważny 2 minuty, a po rozpoczęciu płatności masz 60 sekund na jej zatwierdzenie.
4. API 키 탭에서 sk-kn-로 시작하는 키를 생성하세요. 키는 한 번만 표시되므로 즉시 저장하고 ANTHROPIC_AUTH_TOKEN에 입력하세요.

Na stronie płatności w złotych oprócz BLIK-a są też karty (Visa, Mastercard), Apple Pay i Google Pay na obsługiwanych urządzeniach oraz Link. Nie ma natomiast Przelewy24, PayU, PayPal ani zwykłego przelewu bankowego. Ceny są ustalone w dolarach, a Stripe przelicza je na złote. Według Stripe의 Adaptive Pricing 문서 (sprawdzone 2026년 10월 3일) kurs zawiera opłatę za przewalutowanie w wysokości 2–4%, którą ponosi kupujący. Płacąc kartą w dolarach, unikniesz tej opłaty, choć wtedy obowiązują kurs i opłaty Twojego banku, a BLIK działa tylko w złotych. Dokładną kwotę w złotych zobaczysz na stronie płatności przed potwierdzeniem.

BLIK은 수동 충전에서만 작동합니다. 자동 충전에는 저장된 카드 또는 Link가 필요합니다. 잔액은 만료되지 않으며 실패한 요청에는 요금이 부과되지 않습니다. Kunavo는 VAT 세금계산서를 발행하지 않으며 충전 내역은 결제(Billing) 탭에서 확인할 수 있습니다. 이는 Kunavo API 잔액 충전이지 Claude Pro 또는 Max 요금이 아니라는 점에 유의하세요.

비용은 얼마인가요(예시 계산)

Claude Code에서는 토큰에 대해 요금을 지불합니다. 각 요청에서 Claude Code는 대화의 전체 컨텍스트를 다시 보내지만, 컨텍스트의 반복되는 시작 부분은 캐시 읽기 요율로 청구될 수 있습니다. 아래는 토큰을 기준으로 한 예시 계산입니다. 실제 측정값이나 비용 상한이 아닙니다. 모든 가정은 다음과 같습니다:

• 각 요청에는 입력 토큰 40 000개가 있으며, 그중 36 000(90%)는 캐시 읽기로, 나머지 4000개는 캐시 쓰기로 청구됩니다;
• 각 요청은 출력 토큰 1000개를 반환합니다;
• 하나의 작업 세션에는 이러한 요청이 50개 있으며, 백그라운드에서 Claude Haiku 4.5 호출은 없습니다;
• Kunavo에서 캐시 읽기 비용은 입력 요율의 10%, 캐시 쓰기 비용은 입력 요율의 1,25배입니다. 이는 Claude Sonnet 5에 적용되는 비율이며, 목록의 각 모델은 자체 비율에 따라 계산됩니다.

실제 비용은 컨텍스트 길이, 캐시 적중 횟수, 응답 길이, 그리고 작업 사이에 /clear 명령으로 대화를 지우는지에 따라 달라집니다. 모든 모델의 요율은 가격표에서 확인할 수 있습니다. 자체 사용량은 Claude 토큰 비용 계산기(영어)로 추정할 수 있습니다. 구독과 API 중 어느 쪽이 더 경제적인지는 Claude Code 비용 가이드에서 설명합니다.

가장 일반적인 오류

제한 사항

• Kunavo는 VAT 세금계산서를 발행하지 않습니다.
• BLIK은 수동 충전에서만 작동합니다. 자동 충전에는 저장된 카드 또는 Link가 필요합니다.
• 이는 토큰 단위로 청구되는 API이지 Claude Pro 또는 Max 구독이 아닙니다. API 키를 사용하면 Remote Control과 음성 받아쓰기가 작동하지 않고, /fast 모드는 비활성화되며 MCP 도구 검색은 기본적으로 비활성화됩니다.
• Kunavo는 현재(2026년 10월 3일 기준) Sonnet 5.5를 제공하지 않으므로 위 구성은 sonnet 별칭을 claude-sonnet-5에 고정합니다. 모델을 고정하지 않으면 기본 별칭이 404를 반환할 수 있습니다. Claude Opus 5.5는 opus 별칭에 고정되어 있으며 Claude Code 버전 2.1.280 이상이 필요합니다.
• 공식 Claude Code 문서와 Kunavo 통합 문서는 영어로만 제공됩니다.

자주 묻는 질문