Claude Code'u yükleme: Windows, macOS ve Linux komutu — abonelik olmadan nasıl kullanılır

Claude Code'u kurmak için tek bir komut yeterlidir: macOS, Linux veya WSL'de curl -fsSL https://claude.ai/install.sh | bash komutunu; Windows'ta PowerShell'de irm https://claude.ai/install.ps1 | iex komutunu çalıştırın (Komut İstemi, yani CMD'de aşağıdaki install.cmd satırını kullanın). Ardından yeni bir terminal açın, claude --version ile doğrulayın ve başlamak için claude çalıştırın. İlk bağlantıda iki yol vardır: Pro, Max, Team, Enterprise veya Console hesabıyla giriş yapmak (Claude.ai'nin ücretsiz planı Claude Code'u içermez) ya da ANTHROPIC_BASE_URL ve ANTHROPIC_AUTH_TOKEN olmak üzere iki ortam değişkenini tanımlayıp kullanım başına ücretlendirilen bir API anahtarı kullanmak — hiçbir abonelik gerekmez.

Komutlar 11 Eylül 2026 tarihinde, Anthropic'in resmi kurulum belgeleri temel alınarak doğrulanmıştır.

Kurulumdan önce

macOS ve Linux'a kurulum

Terminal'i açıp şunu yapıştırın:

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

Önerilen yöntem budur: arka planda kendini otomatik güncelleyen bağımsız bir ikili dosya kurar. Kısayol ~/.local/bin/claude konumundadır; önceden açık olan bir terminal yeni PATH değerini görmez, bu nedenle test etmeden önce başka bir pencere açın. WSL'de komut aynıdır.

Windows'a kurulum

Windows'ta iki farklı satır vardır; tek fark, içinde bulunduğunuz terminaldir. İstem PS C:\Users\SeuNome> ile başlıyorsa PowerShell'dir; PS olmadan yalnızca C:\Users\SeuNome> varsa Komut İstemi'dir (CMD). Yönetici olarak çalıştırmanız gerekmez.

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

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

Satırı yanlış terminale yapıştırmak en yaygın hatadır. CMD satırını PowerShell'e yapıştırmak The token '&&' is not a valid statement separator verir; PowerShell satırını CMD'ye yapıştırmak ise 'irm' is not recognized as an internal or external command verir (Portekizce Windows'ta “iç veya dış komut olarak tanınmıyor”). macOS'taki curl … | bash satırını PowerShell'e yapıştırmak da A parameter cannot be found that matches parameter name 'fsSL' verir. Her üç durumda da doğru satırı kullanmanız yeterlidir.

Git for Windows kurulumu isteğe bağlıdır, ancak önerilir: Claude Code komutları çalıştırmak için onunla gelen Git Bash'i kullanır; yoksa PowerShell'i kullanır. Git kurulu olduğu hâlde Git Bash bulunamıyorsa, ayarların env bloğunda CLAUDE_CODE_GIT_BASH_PATH değerini bash.exe konumunu gösterecek şekilde tanımlayın.

WSL'de macOS/Linux satırını WSL terminalinin içinde çalıştırın ve claude komutunu yine orada açın — PowerShell veya CMD üzerinden değil.

Paket yöneticisiyle

Çalışır, ancak önemli bir fark vardır: hiçbiri varsayılan olarak kendiliğinden güncellenmez. Güncellemeyi elle yaparsınız (brew upgrade claude-code, winget upgrade Anthropic.ClaudeCode). Debian/Ubuntu, Fedora/RHEL ve Alpine için imzalı apt, dnf ve apk depoları da vardır.

# Homebrew (macOS, Linux) — canal stable
brew install --cask claude-code

# WinGet (Windows)
winget install Anthropic.ClaudeCode

# npm — exige Node.js 22 ou mais novo; nunca com sudo
npm install -g @anthropic-ai/claude-code

npm üzerinden, 2.1.198 sürümünden itibaren paket Node.js 22 veya daha yenisini gerektirir; eski bir Node'da npm yalnızca bir EBADENGINE uyarısı gösterir ve kurulum tamamlanır. Paket, çalışmak için Node.js kullanmayan aynı derlenmiş ikiliyi kurar. Asla sudo npm install -g kullanmayın: izin sorunlarına neden olur ve güvenlik riski oluşturur.

Kurulumu doğrulama

claude --version   # imprime a versão, por exemplo 2.1.211 (Claude Code)
claude doctor      # diagnóstico da instalação e das configurações, sem abrir sessão

claude doctor komutunu bir yere not edin: oturum açmadan kurulumun durumunu, yapılandırma dosyalarındaki hataları ve önerilen düzeltmeyi gösterir — sorunun kurulumdan mı yoksa yapılandırmadan mı kaynaklandığını öğrenmenin en hızlı yoludur.

command not found: claude görünürse (veya Windows'ta claude komutunun tanınmadığı belirtilirse), kurulum klasörü PATH'te değildir. macOS ve Linux'ta yeni bir terminal açın; çözülmezse ~/.local/bin klasörünü ~/.zshrc veya ~/.bashrc dosyasında PATH'e ekleyin. Windows'ta klasör yolu %USERPROFILE%\.local\bin olarak belirlenmiştir; kontrol edin ve PowerShell üzerinden ekleyin:

# 1. Veja se a pasta de instalação já está no PATH
$env:PATH -split ';' | Select-String '\.local\\bin'

# 2. Sem saída? Adicione ao PATH do usuário e abra um terminal novo
$currentPath = [Environment]::GetEnvironmentVariable('PATH', 'User')
[Environment]::SetEnvironmentVariable('PATH', "$currentPath;$env:USERPROFILE\.local\bin", 'User')

# 3. No terminal novo: se houver duas instalações, aparecem dois caminhos
where.exe claude

İlk bağlantı: abonelik veya API anahtarı

Yol A — abonelikle giriş

Proje klasöründe claude komutunu çalıştırın ve Pro, Max, Team, Enterprise veya Console hesabıyla tarayıcıdaki giriş adımlarını izleyin. Genellikle kafa karıştıran bir ayrıntı: ANTHROPIC_API_KEY değişkeni zaten tanımlıysa Claude Code bu anahtarı kullanıp kullanmayacağınızı bir kez sorar. Reddederseniz, sormadan sessizce yok saymaya başlar — değişken okunmuyormuş gibi görünür. Yeniden etkinleştirmek için /config → Use custom API key yoluna gidin.

Yol B — abonelik olmadan, kullanım başına ödemeli anahtarla

Claude Code, ANTHROPIC_BASE_URL değişkenini doğrudan okur; bu nedenle onu herhangi bir Anthropic Messages API uç noktasına yönlendirmek desteklenen bir yapılandırmadır — eklenti, proxy veya değiştirilmiş ikili gerekmez. İzlenecek yol: hesap oluşturun, bakiyeyi yükleyin (minimum $10), bir sk-kn- anahtarı oluşturmak için anahtar panelini kullanın (anahtar yalnızca bir kez görünür) ve değişkenleri tanımlayın. macOS ve Linux'ta:

export ANTHROPIC_BASE_URL=https://api.kunavo.com   # só o domínio, sem /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'ta PowerShell penceresinde test etmek için:

# Vale só para esta janela do PowerShell
$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

Kalıcı hâle getirmek için en iyi yer, kullanıcı ayarları dosyasındaki env bloğudur: ~/.claude/settings.json (Windows'ta %USERPROFILE%\.claude\settings.json). Buradaki değişkenler her terminal, editör uzantısı ve arka plan işlemi için geçerlidir. Dosyada başka ayarlar varsa yalnızca env bloğunu ekleyin:

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

Bu satırların her birinde dikkat edilmesi gereken bir nokta vardır:

• ANTHROPIC_BASE_URL yalnızca alan adını alır. Claude Code /v1/messages yolunu ekler; sonunda /v1 olduğunda istek /v1/v1/messages yoluna gider ve 404 döner.
• ANTHROPIC_AUTH_TOKEN değişkenini kullanın; ANTHROPIC_API_KEY değişkenini kullanmayın. Bunlar farklı HTTP üstbilgilerine gider: ilki Authorization: Bearer üstbilgisini gönderir ve hemen geçerli olur; ikincisi x-api-key üstbilgisini gönderir ve yukarıda açıklanan tek seferlik onaydan da geçer.
• ANTHROPIC_MODEL'e modelin tam adını yazın. Kunavo yalnızca birebir aynı adı tanır ve sonekinde tarih bulunan eski adları çevirmeden bırakır.
• ANTHROPIC_DEFAULT_OPUS_MODEL ve ANTHROPIC_DEFAULT_SONNET_MODEL değerlerini de sabitleyin. Claude Code'un varsayılan modeli ve opus takma adı en yeni Opus'a yönelir; Kunavo bunu henüz sunmuyorsa ilk istek 404 döner. sonnet takma adı zaten Kunavo'nun sunmadığı Sonnet 5.5'i ister: sabitlenmezse /model sonnet, opusplan'ın yürütme aşaması ve model: sonnet kullanan alt aracılar 404 alır. opus takma adı, Claude Code v2.1.280 veya daha yeni bir sürüm gerektiren Opus 5.5'e (claude-opus-5-5) sabitlenmiştir — eski bir kurulumda claude update komutunu çalıştırın.
• ANTHROPIC_DEFAULT_HAIKU_MODEL ayarını sabitleyin. haiku takma adı Kunavo'nun sunmadığı bir kimlik ister (v2.1.293'ten itibaren Haiku 5.5); sabitlenmezse /model haiku ve model: haiku kullanan alt ajanlar 404 hatası alır. Aynı satır, Claude Code'un kendi başına yaptığı arka plan çağrılarını (özetler, başlıklar) da ana modelden alır.

Anahtarı asla projenin .claude/settings.json dosyasına koymayın — bu dosya git'e ve depoyu klonlayan herkese gider. VS Code uzantısında değişkenler, uzantı başlamadan önce kimlik bilgisini kontrol ettiği için claudeCode.environmentVariables ayarında, doğrudan VS Code'un kullanıcı ayarlarında tutulur.

Katalogdan alınan 1M token başına ücretler:

Oturum içinde model değiştirmek için tam adla /model komutunu kullanın (örneğin /model claude-opus-5-5) veya Claude Code'u claude --model claude-opus-5-5 ile açın. Bir aylık kullanımın maliyeti ve aboneliğin ne zaman daha avantajlı olduğu Claude Code fiyatlandırma rehberinde açıklanır.

Hangi yolun etkin olduğunu öğrenme

Claude Code içinde /status'ı çalıştırın. Auth token satırı anahtarın etkin olduğunu; claude.ai hesabıyla birlikte görünen Login method satırı ise değişkenin okunmadığını belirtir. İkisi birlikte kullanılmaz: değişken tanımlıyken abonelik devre dışı kalır; değişkeni kaldırdığınızda yeniden kurulum yapmadan aboneliğe dönülür.

Bir gateway arkasında üç şey değişir: Remote Control ve sesli dikte çalışmaz (claude.ai kimliği gerekir); /fast hızlı modun kullanılamadığını söyleyebilir, çünkü bu kontrol doğrudan Anthropic'e gider, ancak normal istekler değişmez; ayrıca /context sayıları yerel tahminlere dönüşür. Kod, araçlar, alt aracılar, MCP, hook'lar ve prompt caching aynı şekilde çalışır. Ayrıntılar entegrasyon belgelerinde (İngilizce) yer alır.

Brezilya'dan ödeme yapma — ödeme adımında Pix

claude.ai aboneliği, yurt dışı alışverişlerine açık uluslararası bir kart gerektiren, dolar cinsinden yinelenen bir ücrettir. API anahtarı yolunda yükleme Stripe ödeme ekranından geçer ve Pix, Brezilya'dan ödeme yapanlar için bir ödeme yöntemi olarak görünür: fiyat USD cinsindendir ve Stripe onaylamadan önce tutarı real cinsinden dönüştürülmüş olarak gösterir. Uluslararası kart (Visa, Mastercard, American Express), Apple Pay, Google Pay ve Link de ödeme ekranında görünür. Cüzdan ön ödemelidir — minimum yükleme $10, bakiye sona ermez, başarısız istekler ücretlendirilmez — ve her anahtarın aylık harcama limiti olabilir. Ekran ekran adım adım kılavuz Pix ile API için ödeme yapma sayfasındadır.

Yaygın hatalar

Kurulumdan sonra

İlk kullanımda proje içinde /init komutunu çalıştırın: Claude Code depoyu okur ve bulduğu test komutlarıyla kuralları içeren bir CLAUDE.md oluşturur. Bu dosyayı gözden geçirin ve kısa tutun — her oturumda yüklenir. İlişkisiz görevler arasında /clear yeni bir konuşma başlatır; uzun süren bir görevde /compact geçmişi özetleyip devam eder.

Seçim konusunda dürüst olmak gerekirse: Claude Code'u günde birçok saat kullananlar için aboneliğin aylık ücreti genellikle daha ucuzdur; kullanımın dalgalandığı veya 5 saatlik pencereye bağlı kalmak istemediğiniz durumlarda kullandıkça öde modeli avantajlıdır — kullanılmayan bir ayın maliyeti sıfırdır. Kunavo üzerinden paylaşılan kapasiteyi kullanırsınız; ayrılmış kota ve sözleşmeye bağlı SLA yoktur. Bu garantilere ihtiyaç duyanlar doğrudan Anthropic'ten hizmet almalıdır.

Sık sorulan sorular