Claude Code 설치: Windows, macOS 및 Linux에서 단계별 설치, 구독 없는 API key 및 카드 결제

간단히 말하면: Claude Code는 터미널에 맞는 한 줄 명령으로 설치합니다. macOS, Linux 및 WSL에서는 install.sh, Windows PowerShell에서는 irm … | iex, 명령 프롬프트(CMD)에서는 install.cmd 줄을 실행합니다. 세 명령은 바로 아래에 있습니다. 이 방법에는 Node.js가 필요하지 않지만 npm으로 설치하려면 Node.js 22 이상이 필요합니다. 설치 후에는 두 가지 선택지가 있습니다. Claude 계정으로 로그인하거나(Pro, Max, Team, Enterprise 또는 Console; 무료 요금제에는 Claude Code가 포함되지 않음), 구독 없이 API 키를 사용하는 것입니다. 키 방식에서는 ANTHROPIC_BASE_URL=https://api.kunavo.com(끝에 /v1를 추가하지 않음), ANTHROPIC_AUTH_TOKEN 및 모델을 고정하는 네 개의 변수를 정의합니다. 세션에서 /status로 키가 활성화되었는지 확인할 수 있습니다. 사용한 토큰에 대해서만 요금이 부과됩니다. 잔액은 Visa 또는 Mastercard 카드, Apple Pay, Google Pay 또는 Link로 최소 10 USD를 충전하며, 할부와 Papara는 지원되지 않습니다.

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

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

:: Windows – Komut İstemi (CMD)
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

Bu satırları ve aşağıdaki değişken adlarını Claude Code'un 설치 ve 게이트웨이 연결 belgelerinden 2026년 10월 3일 tarihinde aldık. Anthropic bu belgeleri Türkçe yayımlamıyor; hata mesajlarını bu yüzden İngilizce asıllarıyla veriyoruz. Kunavo fiyatlarını ve ödeme yöntemlerini en son 2026년 10월 3일 tarihinde kontrol ettik. VPN ya da yurt dışı proxy'si aramanıza gerek yok: Anthropic의 지원 국가 페이지 Türkiye'yi hem Claude.ai hem API için sayıyor (kontrol: 2026년 10월 3일).

어떤 줄을 어떤 터미널에서 사용하나요?

설치 과정에서 문제가 생기는 대부분의 경우는 명령이 아니라 터미널을 잘못 선택했기 때문입니다. 아래 표에서 환경에 맞는 줄을 확인하세요. Windows를 사용한다면 다음 절에서 터미널을 식별하는 방법을 설명합니다.

시스템 요구 사항

공식 설치 문서의 요구 사항(2026년 10월 3일 기준):

• 운영 체제: macOS 13.0 이상, Windows 10 버전 1809 이상 또는 Windows Server 2019 이상, Linux에서는 Ubuntu 20.04, Debian 10 및 Alpine Linux 3.19 이상.
• 하드웨어: 최소 4GB RAM 및 x64 또는 ARM64 프로세서. 32비트 Windows는 지원되지 않습니다.
• 셸: Bash, Zsh, PowerShell 또는 CMD.
• Node.js: 네이티브 설치에는 필요하지 않으며, npm 방식에서만 22 이상이 필요합니다.
• 계정: 로그인하려면 Pro, Max, Team, Enterprise 또는 Console 계정이 필요합니다. API 키를 사용하면 구독이나 로그인이 필요하지 않습니다.

인터넷에 있는 일부 터키어 설명은 이 목록의 이전 버전을 복사하고 있습니다. npm에는 Node.js 18, Linux에는 Ubuntu 18.04 또는 CentOS 7이라고 여전히 적힌 자료가 있습니다. 현재 문서는 최소 버전으로 Node.js 22와 Ubuntu 20.04를 제시합니다. “미국에서 출발하는 고정 프록시 없이는 모든 단계에서 오류가 발생한다”는 경고도 터키에는 적용되지 않습니다. 오히려 개방형 VPN 설정은 지역 오류를 일으킬 수 있습니다(macOS 및 Linux 절의 다운로드 오류를 참조하세요).

Claude Code Windows 설치

Windows에서는 관리자 권한, WSL 또는 Git이 필요하지 않습니다. 공식 문서는 터미널을 관리자 권한으로 열도록 요구하지 않으므로 일부 터키어 동영상에 나오는 “PowerShell을 관리자 권한으로 실행하세요” 단계를 건너뛸 수 있습니다. 알아야 할 것은 현재 어떤 터미널을 사용 중인지뿐입니다.

• 프롬프트가 PS C:\Users\KullaniciAdi>와 같이 PS로 시작하면 PowerShell입니다. irm … | iex 줄을 사용하세요.
• 앞에 PS가 없고 C:\Users\KullaniciAdi>만 표시되면 명령 프롬프트입니다. install.cmd 줄을 사용하세요.
• 시작 메뉴의 “Windows PowerShell (x86)” 항목을 열지 마세요. 32비트 프로세스이므로 64비트 컴퓨터에서도 Claude Code does not support 32-bit Windows 오류가 발생합니다. 접미사가 없는 “Windows PowerShell”을 선택하세요.

잘못된 창에 줄을 붙여 넣는 것이 Windows 오류의 주요 원인 중 하나이며, 메시지는 이를 명확히 알려 주지 않습니다. PowerShell에 붙여 넣은 CMD 줄은 The token '&&' is not a valid statement separator로 끝납니다. CMD에 붙여 넣은 PowerShell 줄은 터키어 Windows에서 “'irm'이 내부 또는 외부 명령, 실행 가능한 프로그램 또는 배치 파일로 인식되지 않습니다.”라고 표시됩니다(영어 시스템에서는 'irm' is not recognized as an internal or external command). macOS의 curl … | bash 줄을 PowerShell에서 실행하면 A parameter cannot be found that matches parameter name 'fsSL' 또는 'bash' is not recognized as the name of a cmdlet가 표시됩니다. 터키어 시스템에서는 이러한 문구가 터키어로 표시될 수 있습니다. 세 경우 모두 해결 방법은 같습니다. 현재 터미널에 맞는 줄을 사용하세요.

Git for Windows와 WSL이 필요한가요?

İkisi de isteğe bağlı. Git for Windows kuruluysa Claude Code kabuk komutlarını onunla gelen Git Bash'te çalıştırır, değilse PowerShell aracına geçer; belge Git'i öneriyor ama şart koşmuyor. Git kurulu olduğu hâlde Git Bash bulunamıyorsa ~/.claude/settings.json dosyasının env bloğunda CLAUDE_CODE_GIT_BASH_PATH değişkenine bash.exe dosyasının tam yolunu verin (belgedeki örnek: C:\Program Files\Git\bin\bash.exe).

WSL을 선택하는 이유는 두 가지입니다. Linux 도구가 필요하거나 명령을 샌드박스에서 실행하려는 경우입니다. 네이티브 Windows 설치에는 샌드박스가 없습니다.

WSL을 계속 사용할 것이라면 설치와 사용 모두 WSL 터미널에서 진행하세요. macOS/Linux 줄이 그곳에서 작동하며 claude도 그곳에서 실행됩니다.

“claude” 명령을 찾을 수 없음

설치를 마친 후에도 'claude' is not recognized(macOS 및 Linux에서는 command not found: claude)가 표시된다면, 설치 전에 열어 둔 창에서 작업하고 있을 가능성이 큽니다. 설치 프로그램은 PATH 변수를 업데이트하지만 기존 터미널에서는 이를 볼 수 없습니다. 먼저 터미널을 닫고 다시 여세요. Windows에서는 프로그램이 %USERPROFILE%\.local\bin\claude.exe, macOS 및 Linux에서는 ~/.local/bin/claude에 있습니다. Windows에서 새 창을 열어도 해결되지 않으면 문서의 명령을 사용해 해당 폴더를 사용자 PATH 변수에 추가하세요.

# 1. Kurulum klasörü PATH içinde mi?
$env:PATH -split ';' | Select-String '\.local\\bin'

# 2. Sonuç yoksa kullanıcı PATH'ine ekleyin, terminali kapatıp yeniden açın
$currentPath = [Environment]::GetEnvironmentVariable('PATH', 'User')
[Environment]::SetEnvironmentVariable('PATH', "$currentPath;$env:USERPROFILE\.local\bin", 'User')

# 3. Yeni terminalde
claude --version

npm.ps1을 로드할 수 없음

이 메시지는 npm 방식을 사용할 때만 표시됩니다. npm이 PowerShell용 .ps1 실행 파일을 작성하지만 시스템의 스크립트 실행 정책이 이를 차단하기 때문입니다. 문서에서는 세 가지 해결 방법을 제시합니다. npm.cmd 및 claude.cmd 이름으로 명령을 실행하거나, PowerShell에서 네이티브 설치로 전환하거나, 자신의 사용자에 한해 로컬 스크립트를 허용하는 방법입니다.

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

macOS 및 Linux 설치

위의 install.sh 줄은 공식 문서의 “Native Install (Recommended)” 탭에 있으며 WSL에서도 그대로 작동합니다. 이 방법으로 설치한 Claude Code는 새 버전을 백그라운드에서 자동으로 다운로드합니다. 패키지 관리자를 선호한다면 Homebrew와 WinGet도 공식 옵션입니다. 다만 문서에 따르면 이러한 설치는 기본적으로 자동 업데이트되지 않으므로 패키지 관리자를 통해 직접 새 버전을 설치해야 합니다.

# Homebrew – stable kanalı; varsayılan olarak kendini güncellemez
brew install --cask claude-code

# WinGet (Windows) – varsayılan olarak kendini güncellemez
winget install Anthropic.ClaudeCode

스크립트 대신 HTML 또는 403이 반환되는 경우

syntax error near unexpected token '<' mesajı, bash'e betik yerine bir HTML sayfasının gittiğini gösterir; curl: (22) The requested URL returned error: 403 ise sunucunun indirmeyi reddettiğini. 설치 문제 문서 (kontrol: 2026년 10월 3일) ikisini de yükleyici adresinin betik döndürmemesine bağlıyor. Sayfada App unavailable in region yazıyorsa istek, belgeye göre Claude Code'un sunulmadığı bir ülkeden gelmiş görünüyor. Türkiye listede olduğuna göre bu mesajı Türkiye'den alıyorsanız trafiğiniz büyük ihtimalle bir VPN ya da proxy üzerinden başka bir ülkeye çıkıyordur; kapatıp yeniden deneyin. İçeriksiz bir 403 genellikle şirket proxy'sinden ya da güvenlik duvarından gelir: başka bir ağdan deneyin veya BT ekibinizden bu adrese izin vermesini isteyin.

npm 설치: Node.js 22 필수

npm yolu kaldırılmadı, resmi belgede hâlâ anlatılıyor; ama paketin istediği sürüm artık Node.js 22 ve üstü. node -v daha eski bir sürüm gösteriyorsa npm kurulumu durdurmaz, yalnızca bir EBADENGINE uyarısı basar. Yine de en temizi Node.js'i nodejs.org üzerinden 22 veya üstüne yükseltmek.

node -v                                    # v22 veya üstü olmalı
npm install -g @anthropic-ai/claude-code   # sudo kullanmadan

# güncelleme: npm update -g değil, @latest
npm install -g @anthropic-ai/claude-code@latest

이 방식에서 세 가지 습관이 문제를 일으킵니다.

• sudo로 설치하기. 문서는 sudo npm install -g 사용 시 권한 문제와 보안 위험이 발생할 수 있다고 경고합니다.
• npm update -g로 업데이트하기. 올바른 명령은 npm install -g @anthropic-ai/claude-code@latest입니다.
• 선택적 종속성 비활성화. 실제 실행 파일은 플랫폼별 @anthropic-ai/claude-code-* 패키지를 선택적 종속성으로 포함합니다. --omit=optional 플래그 또는 .npmrc의 optional=false 설정은 이 패키지를 건너뜁니다. 설치는 오류 없이 완료되지만 macOS와 Linux에서 claude를 시작할 때 claude native binary not installed가 표시됩니다.

설치가 제대로 되었나요?

어떤 방법을 선택했든 새 터미널을 열고 다음 두 명령을 실행하세요.

claude --version   # sürüm numarasını yazar, ör. 2.1.211 (Claude Code)
claude doctor      # oturum açmadan kurulum ve ayar teşhisi

claude --version에 버전 번호가 표시되면 프로그램이 설치된 것입니다. claude doctor은(는) 로그인하지 않아도 설치 상태와 설정 파일의 문제를 나열합니다. 다음 단계에서 문제가 발생하면 이를 통해 문제가 설치에 있는지 구성에 있는지 구분할 수 있습니다.

구독 없이: Claude Code에 API 키 설정하기

claude를 처음 시작하면 인증을 요청합니다. Claude 요금제가 있다면 로그인하여 계속 진행할 수 있습니다. 요금제가 없거나 고정 월 이용료 대신 사용량에 따라 지불하려면 API 키로 Claude Code를 실행합니다. 두 방식의 차이는 다음과 같습니다.

키 방식은 Anthropic이 예상하는 구성입니다. ANTHROPIC_BASE_URL는 Claude Code의 기본 제공 변수이며, 공식 게이트웨이 문서에서도 이 변수를 사용해 프록시 또는 게이트웨이 뒤에서 Claude Code를 실행하는 방법을 설명합니다. 플러그인, 패치 또는 수정된 클라이언트를 설치하지 않습니다. macOS와 Linux에서는 여섯 줄을 셸 파일(~/.zshrc 또는 ~/.bashrc)에 추가하세요.

export ANTHROPIC_BASE_URL=https://api.kunavo.com   # yalnızca alan adı, /v1 yok
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 세션에서 테스트하세요. 창을 닫으면 변수도 사라집니다.

# Yalnızca bu PowerShell penceresinde geçerli – pencereyi kapatınca kaybolur
$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

모든 터미널에 적용하려면 동일한 값을 사용자 설정 파일의 env 블록에 입력하세요. 문서에 따르면 이 파일은 모든 프로젝트에 적용되며 Windows 경로는 %USERPROFILE%\.claude\settings.json입니다. 일부 AI 요약에 나오는 %APPDATA%\Claude\settings.json는 공식 문서의 경로가 아닙니다. 파일이 이미 있다면 내용을 삭제하지 말고 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_AUTH_TOKEN인가요, ANTHROPIC_API_KEY인가요? Kunavo 키는 두 헤더 모두에서 허용됩니다: Authorization: Bearer 및 x-api-key. 차이는 Claude Code의 동작에 있습니다. ANTHROPIC_AUTH_TOKEN는 Bearer 헤더로 전송되며 질문 없이 작동합니다. ANTHROPIC_API_KEY는 x-api-key 헤더로 전송되고 대화형 모드에서 처음 한 번 승인을 요청합니다. 이 질문에 “아니요”라고 답하면 키가 경고 없이 무시됩니다. 다시 활성화하려면 /config → Use custom API key 경로를 선택해야 합니다. 이 가이드에서 ANTHROPIC_AUTH_TOKEN을 사용하는 이유도 이 때문입니다.

모델을 왜 고정하나요? 모델 구성 문서 göre (kontrol: 2026년 10월 3일) API ile çalışan Claude Code, hiçbir şey ayarlanmamışsa varsayılan model ve opus takma adı için Opus 5.5'i, sonnet takma adı için Sonnet 5.5'i ister; Anthropic yeni model çıkardıkça bu takma adlar da kayar. Kunavo 2026년 10월 3일 itibarıyla Sonnet 5.5'i sunmuyor, dolayısıyla sabitlenmemiş bir sonnet isteği 404 ile döner. Claude Opus 5.5 Kunavo'da çalışıyor, ama tarifesi ($2,80 / $14,00) Claude Sonnet 5 tarifesinden ($1,40 / $7,00) yüksek; sabitlemezseniz farkında olmadan daha pahalı modelle çalışırsınız. Yukarıdaki blokta ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-5 satırı bu yüzden var: /model sonnet, opusplan'ın yürütme aşaması ve model: sonnet olarak ayarlanmış alt ajanlar Sonnet 5.5 yerine Claude Sonnet 5 ile çalışır. opus takma adını ise Claude Opus 5.5 modeline (claude-opus-5-5) sabitliyoruz; bu model Claude Code v2.1.280 veya üstünü ister, eski bir sürümdeyseniz claude update çalıştırın.

Kunavo 요금(입력 / 출력, 토큰 100만 개당): Claude Sonnet 5 $1,40 / $7,00 (Anthropic 요금: $2,00 / $10,00); Claude Opus 5.5 $2,80 / $14,00; 백그라운드 작업을 담당하는 Claude Haiku 4.5 $0,70 / $3,50.

키를 어디에 입력하지 말아야 하며, 어떤 값이 우선하나요?

Projenin kendi .claude/settings.json dosyası anahtar için yanlış yer: 게이트웨이 문서 bu dosyanın depoya commit edildiğini hatırlatıyor, yani anahtar depoyu klonlayan herkese gider. Aynı değişken hem kabukta hem ayar dosyasının env bloğunda tanımlıysa çoğu durumda ayar dosyasındaki geçerli olur; kabukta değiştirdiğiniz bir değer etki etmiyorsa önce oraya bakın. Ayar dosyasındaki model anahtarı bu kuralın dışında: ANTHROPIC_MODEL değişkeni ondan önce gelir, model yalnızca değişken yoksa kullanılır. VS Code eklentisinde değişkenler, VS Code kullanıcı ayarlarındaki claudeCode.environmentVariables alanına girer.

첫 실행 및 /status 확인

변수가 올바른 위치에 있으면 claude 명령이 로그인 화면을 전혀 표시하지 않고 세션을 시작합니다. 게이트웨이 문서(확인: 2026년 10월 3일)도 ANTHROPIC_AUTH_TOKEN가 설정된 경우 동작을 이렇게 설명합니다. 로그인 화면이 나타난다면 Claude Code가 키를 인식하지 못한 것입니다. 흔한 원인은 키가 프로젝트 설정에만 있는 경우입니다. 대화형 모드에서는 프로젝트의 .claude/settings.json 또는 .claude/settings.local.json 파일에 있는 env 블록이 첫 실행 마법사와 폴더 신뢰 확인을 통과한 후에 읽힙니다. 키는 마법사보다 먼저 읽히는 위치에 있어야 합니다. 셸의 export, 사용자 수준의 ~/.claude/settings.json 또는 관리되는 설정(managed settings)이 해당 위치입니다.

로그인한 후 /status를 입력하세요. 두 줄이면 충분한 정보를 얻을 수 있습니다.

• Anthropic base URL: 사용자 지정 주소가 정의된 경우에만 표시되며 https://api.kunavo.com이어야 합니다. 행 자체가 없다면 ANTHROPIC_BASE_URL가 세션에 도달하지 않은 것입니다.
• Auth token: 옆에 ANTHROPIC_AUTH_TOKEN 이름이 표시되면 요청이 API 키로 전송되고 있는 것입니다. 대신 claude.ai 계정을 나타내는 Login method 행이 표시되면 Claude Code가 여전히 저장된 로그인을 사용하고 있는 것입니다. 세션을 종료하고 새 터미널을 연 다음 변수를 어디에 입력했는지 확인하세요.

Claude Code를 열지 않고 테스트하기

주소와 키는 Claude Code와 별도로 테스트할 수도 있습니다. 공식 문서의 방법은 출력 토큰 1개를 요청하는 것이며, 잔액에서 아주 적은 금액이 차감됩니다. 명령은 현재 셸에서 변수를 읽으므로 키가 설정 파일에만 있다면 먼저 이 터미널에서 export을 실행하세요. 응답이 {"id":"msg_으로 시작하면 주소와 키가 유효하고, 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에 해당하는 명령은 아래와 같습니다. 성공하면 응답에 msg_으로 시작하는 id 필드가 있습니다.

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 계정이 필요하며, ANTHROPIC_API_KEY, ANTHROPIC_AUTH_TOKEN 또는 apiKeyHelper가 활성화된 동안에는 작동하지 않습니다. v2.1.196부터는 ANTHROPIC_BASE_URL가 Anthropic 이외의 서버를 가리키는 경우에도 Remote Control이 비활성화됩니다.
• /fast가 비활성화된 것으로 표시됩니다. 문서에 따르면 bearer token 하나만 설정된 경우 Claude Code는 빠른 모드(fast mode)의 상태를 묻지 않고 비활성화된 것으로 간주합니다.
• MCP 도구 검색은 기본적으로 비활성화되어 있습니다. MCP 문서 (kontrol: 2026년 10월 3일) özel bir ANTHROPIC_BASE_URL ayarını, tool search kullanılmayan yapılandırmalar arasında sayıyor.
• /context 수치는 근사값입니다. Kunavo /v1/messages/count_tokens uç noktasını sunmuyor; bu durumda Claude Code, gateway 호환성 문서 göre (kontrol: 2026년 10월 3일) bağlam kullanımını karakter sayısından tahmin eder.

통합의 기술적 세부 사항은 영어 Claude Code 통합 문서에서 확인할 수 있으며, 이 가이드의 영어판은 Install Claude Code입니다.

터키에서 결제: 카드, Apple Pay, Google Pay, Link

Burada ödediğiniz şey bir abonelik değil, Claude Code'un token başına harcadığı ön ödemeli API bakiyesi. Anthropic'in sitesinden alınan Pro ve Max ise yalnızca kredi veya banka kartıyla ödenebiliyor (Claude 유료 요금제 FAQ, kontrol: 2026년 10월 3일). Kunavo'ya yaptığınız yükleme bu planların yerine geçmez ve onları ödemez. Adımlar:

1. Kunavo에 가입하세요. 이메일 주소나 Google 계정이면 충분하며, 가입 시 카드 정보를 요구하지 않습니다.
2. Billing 페이지에서 금액을 선택하세요. 최소 금액은 10 USD이며, 구독이나 월 요금은 없습니다. 높은 금액을 충전하면 보너스가 추가됩니다: 100 USD yükleyene 110 USD bakiye, 1.000 USD yükleyene 1.200 USD bakiye, 5.000 USD yükleyene 6.250 USD bakiye.
3. Stripe 결제 페이지가 열립니다. 카드(Visa, Mastercard), Apple Pay, Google Pay 또는 Link 중 하나를 선택하세요. Apple Pay와 Google Pay는 이를 지원하는 기기와 브라우저에서만 표시됩니다.
4. 그런 다음 API Keys 페이지에서 sk-kn-으로 시작하는 키를 생성하세요. 키는 한 번만 표시되므로 복사한 뒤 즉시 ANTHROPIC_AUTH_TOKEN 값에 입력하세요.

금액은 TL로 표시되나요, 달러로 표시되나요?

Kunavo fiyatları dolar cinsinden; ödeme sayfasında hangi para biriminin gösterileceğine Stripe karar verir ve tutar TL olarak da çıkabilir. Stripe의 Adaptive Pricing 문서 (kontrol: 2026년 10월 3일) Türkiye'yi desteklenen pazarlar arasında sayıyor ve bu çevrimde kura %2–4 arası, alıcının ödediği bir ücret eklendiğini yazıyor. Dolarla ödemeyi seçerseniz bu ücret olmaz; o zaman kartınızın bankası kendi döviz kurunu ve varsa yurt dışı işlem ücretini uygular. Para birimi hangisi olursa olsun, kesin tutarı onaylamadan önce ödeme sayfasında görürsünüz.

할부, Papara, 은행 송금 및 Troy

• 할부는 없으며, 결제는 일시불입니다. Türk kartlarıyla yurt dışı sitelerden yapılan harcamalar sonradan da taksite bölünemiyor (enuygunfinans.com, kontrol: 2026년 10월 3일).
• Papara, 은행 송금/EFT 및 PayPal은 지원되지 않습니다. 결제 페이지에 이러한 옵션이 표시되지 않습니다.
• Troy: Stripe'ın 지원되는 카드 브랜드 sayfasında Troy geçmiyor (kontrol: 2026년 10월 3일). Visa ya da Mastercard logolu bir kartla ödeyin.
• 청구서는 발행되지 않습니다. Kunavo는 e-Arşiv를 포함한 어떠한 청구서도 발행하지 않으며, 충전 내역은 Billing 페이지에 보관됩니다.

카드가 거부되면 먼저 은행의 모바일 앱을 확인하세요. 카드가 온라인 결제와 해외 거래에 허용되어 있어야 합니다. 자동 충전은 등록된 카드나 Link로만 설정할 수 있습니다. 잔액에는 만료일이 없으며, 실패한 요청에는 요금이 부과되지 않습니다. 모든 모델의 요금은 Claude API 가격 가이드에서 확인할 수 있습니다.

작업 세션 하나에 비용이 얼마나 드나요?

키를 사용하는 경우 비용은 전적으로 토큰 수에 따라 달라집니다. Claude Code는 모든 요청에서 대화의 컨텍스트를 처음부터 전송하지만, 컨텍스트에서 변경되지 않는 앞부분을 캐시에서 읽으면 훨씬 낮은 요금이 적용됩니다. 아래 표는 측정 결과가 아니라 명시적인 가정을 바탕으로 계산한 값이며, 상한선으로 해석해서는 안 됩니다. 가정:

• 요청당 40.000 입력 토큰. 이 중 36.000(%90)는 캐시에서 읽고, 나머지 4.000는 캐시에 기록됩니다.
• 요청당 1.000 출력 토큰;
• 세션에서 50개의 요청. 백그라운드의 Claude Haiku 4.5 호출은 계산하지 않았습니다.
• Claude Sonnet 5의 경우 캐시 읽기 요금은 입력 요금의 %10이고, 캐시 쓰기는 1,25배입니다. 표의 각 모델은 자체 요금으로 계산했습니다.

Gerçek tutarı bağlamın uzunluğu, önbellek isabeti, yanıtların uzunluğu ve konu değiştirirken sohbeti temizleyip temizlemediğiniz belirler. 공식 비용 문서 (kontrol: 2026년 10월 3일) iki ayrıntı ekliyor: Claude Code siz bir şey yazmasanız da arka planda az miktarda token harcar, genellikle oturum başına 0,04 dolardan az; API anahtarında önbellek ömrü varsayılan olarak beş dakika, dolayısıyla daha uzun bir aradan sonraki ilk mesaj önbelleği ıskalar ve bağlamın tamamı yeniden işlenir. Konu değiştirirken /clear, uzun oturumlarda /compact bu maliyeti düşürür.

모든 요금은 가격 페이지에 있습니다. Claude 토큰 비용 계산기(영어)로 자신의 사용량을 추정할 수 있습니다. 구독과 API 중 어느 쪽이 더 적합한지는 Claude Code 가격 가이드에서 다룹니다.

오류 메시지 및 해결 방법

알아야 할 제한 사항

• Kunavo는 청구서를 발행하지 않으며 e-Arşiv도 지원하지 않습니다.
• 결제는 일시불입니다. 할부, Papara 및 은행 송금/EFT는 지원되지 않습니다. 자동 충전에는 등록된 카드나 Link가 필요합니다.
• 이는 Claude Pro나 Max 구독이 아니라 토큰당 요금을 지불하는 API입니다. 키를 사용하는 경우 Remote Control과 음성 받아쓰기가 작동하지 않고, /fast가 비활성화된 것으로 표시되며, MCP 도구 검색은 기본적으로 비활성화됩니다.
• Kunavo는 2026년 10월 3일 기준으로 Sonnet 5.5를 제공하지 않으므로, 모델을 고정하지 않으면 sonnet 별칭이 404를 반환합니다.
• Claude Code 공식 문서와 Kunavo 통합 문서는 영어로만 제공됩니다(확인: 2026년 10월 3일).

자주 묻는 질문