Windows, macOS ve Linux'ta Claude Code nasıl kurulur — 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; Windows’ta PowerShell’de irm https://claude.ai/install.ps1 | iex çalıştırın (Komut İstemi’nde CMD için aşağıda göreceğiniz install.cmd satırını kullanın). Ardından yeni bir terminal açın, claude --version ile doğrulayın, proje klasörünüze girin ve claude komutunu çalıştırın; ilk yararlı komut olarak /init kullanılır. Bağlanmak için iki yolunuz vardır: Pro, Max, Team, Enterprise veya Console hesabıyla oturum açmak (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şkeni tanımlayıp abonelik olmadan kullanım başına ücretlendirilen bir API anahtarı kullanmak.

Komutlar 11 Eylül 2026 tarihinde doğrulandı; kaynak Anthropic’in resmi kurulum belgeleridir.

Gereksinimler

macOS ve Linux’a kurulum

Terminal’i açın ve şunu yapıştırın:

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

Önerilen yöntem budur: arka planda otomatik güncellenen bağımsız bir ikili dosya kurar. Çalıştırılabilir dosya ~/.local/bin/claude konumuna yerleşir ve zaten açık olan bir terminal yeni PATH’i görmez; bu nedenle denemeden önce başka bir pencere açın. WSL’de komut aynıdır.

Claude Code’u Windows’a kurma

Windows’ta iki farklı satır vardır; değişen tek şey terminaldir. İstem PS C:\Users\TuNombre> ile başlıyorsa PowerShell’desiniz; PS olmadan yalnızca C:\Users\TuNombre> varsa Komut İstemi’ndesiniz (CMD). Yönetici olarak çalıştırmanız gerekmez.

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

:: Windows Símbolo del sistema (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ı PowerShell’de The token '&&' is not a valid statement separator hatası verir; PowerShell satırı CMD’de 'irm' is not recognized as an internal or external command hatası verir (İspanyolca Windows’ta «iç veya dış komut olarak tanınmıyor»); macOS’a ait curl … | bash satırının PowerShell’e yapıştırılması ise A parameter cannot be found that matches parameter name 'fsSL' hatasını verir. Üç durumda da uygun satırı kullanmak yeterlidir.

Git for Windows kurulumu isteğe bağlıdır ancak önerilir: Claude Code komutları çalıştırmak için Git Bash’ini kullanır; bu yoksa PowerShell’i kullanır. Git kurulu olduğu halde Git Bash bulunamıyorsa yapılandırmanın env bloğunda CLAUDE_CODE_GIT_BASH_PATH değişkenini bash.exe yoluyla tanımlayın.

WSL ile macOS/Linux satırını WSL terminalinin içinde çalıştırın ve claude komutunu orada açın; PowerShell veya CMD’den açmayın.

Paket yöneticisiyle

Bu da çalışır, ancak önemli bir fark vardır: hiçbiri varsayılan olarak otomatik güncellenmez (brew upgrade claude-code veya winget upgrade Anthropic.ClaudeCode komutunu çalıştırmanız gerekir). Debian/Ubuntu, Fedora/RHEL ve Alpine için imzalı apt, dnf ve apk depoları da mevcuttur.

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

# WinGet (Windows)
winget install Anthropic.ClaudeCode

# npm — requiere Node.js 22 o posterior; nunca con sudo
npm install -g @anthropic-ai/claude-code

npm ile 2.1.198 sürümünden itibaren paket Node.js 22 veya daha yenisini gerektirir; eski bir Node kullanıldığında npm yalnızca EBADENGINE uyarısı gösterir ve kurulum tamamlanır. Çalıştırmak için Node.js kullanmayan aynı derlenmiş ikili dosyayı kurar. Asla sudo npm install -g kullanmayın: izin sorunlarına yol açar ve güvenlik riskidir.

Kurulumu doğrulama

claude --version   # imprime la versión, por ejemplo 2.1.211 (Claude Code)
claude doctor      # diagnóstico de la instalación y la configuración, sin abrir sesión

claude doctor komutunu kullanın: oturum açmadan kurulum durumunu, yapılandırma dosyalarındaki hataları ve önerilen çözümü gösterir. Sorunun kurulumdan mı yoksa yapılandırmadan mı kaynaklandığını anlamanın en hızlı yolu budur.

command not found: claude görüyorsanız (veya Windows’ta claude tanınmıyorsa), kurulum klasörü PATH’te değildir. macOS ve Linux’ta yeni bir terminal açın; sorun devam ederse ~/.local/bin yolunu ~/.zshrc veya ~/.bashrc içindeki PATH’e ekleyin. Windows’ta klasör %USERPROFILE%\.local\bin konumundadır; PowerShell’den kontrol edip ekleyin:

# 1. Comprueba si la carpeta de instalación ya está en el PATH
$env:PATH -split ';' | Select-String '\.local\\bin'

# 2. ¿Sin salida? Añádela al PATH de usuario y abre una terminal nueva
$currentPath = [Environment]::GetEnvironmentVariable('PATH', 'User')
[Environment]::SetEnvironmentVariable('PATH', "$currentPath;$env:USERPROFILE\.local\bin", 'User')

# 3. En la terminal nueva: si hay dos instalaciones, verás dos rutas
where.exe claude

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

Seçenek A — aboneliğinizle oturum açma

Proje klasöründe claude komutunu çalıştırın ve Pro, Max, Team, Enterprise veya Console hesabıyla tarayıcıdaki oturum açma adımlarını izleyin. Kafa karıştıran bir ayrıntı: ANTHROPIC_API_KEY değişkeni zaten tanımlıysa Claude Code bu anahtarı kullanmak isteyip istemediğinizi yalnızca bir kez sorar. Hayır derseniz bundan sonra değişkeni yok sayar ve tekrar sormaz; bu da değişken okunmuyormuş gibi görünmesine neden olur. Yeniden etkinleştirmek için: /config → Use custom API key.

Seçenek B — abonelik olmadan, kullanım başına ücretlendirilen anahtarla

Claude Code ANTHROPIC_BASE_URL değişkenini doğrudan destekler; dolayısıyla onu Anthropic Messages API’sindeki herhangi bir endpoint’e yönlendirmek desteklenen bir yapılandırmadır: eklenti, proxy veya değiştirilmiş ikili dosya gerekmez. Adımlar: hesap oluşturun, bakiye yükleyin (minimum $10), anahtar panelinde bir sk-kn- anahtarı oluşturun (yalnızca bir kez gösterilir) ve bu env bloğunu kullanıcı yapılandırmanıza, ~/.claude/settings.json (Windows’ta %USERPROFILE%\.claude\settings.json), ekleyin. Böylece tüm terminaller, editör uzantısı ve arka plan işlemleri bunu görür:

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

Önce tek bir PowerShell penceresinde denemek için:

# Solo para esta ventana de PowerShell (en macOS/Linux: export VARIABLE=valor)
$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

• ANTHROPIC_BASE_URL yalnızca alan adını içerir. Claude Code /v1/messages ekler; sonunda /v1 bulunursa istek /v1/v1/messages adresine gider ve 404 döndürür.
• ANTHROPIC_AUTH_TOKEN kullanın, ANTHROPIC_API_KEY kullanmayın. Bunlar farklı HTTP başlıklarında yer alır: ilki Authorization: Bearer gönderir ve hemen çalışır; ikincisi x-api-key gönderir ve ayrıca yukarıdaki tek seferlik onaydan geçer.
• ANTHROPIC_MODEL içine modelin tam adını yazın. Kunavo yalnızca birebir aynı adı tanır ve tarih içeren eski adları çevirmez.
• ANTHROPIC_DEFAULT_OPUS_MODEL değerini de sabitleyin. Claude Code'un varsayılan modeli ve opus takma adı en güncel Opus'a işaret eder; Kunavo henüz bunu sunmuyorsa ilk istek 404 döndürür. Burada opus takma adı, Claude Code v2.1.280 veya sonraki sürümünü gerektiren Claude Opus 5.5 (claude-opus-5-5) değerine sabitlenir; daha eski bir sürümle claude update komutunu çalıştırın.
• ANTHROPIC_DEFAULT_SONNET_MODEL değerini de ayarlayın. sonnet takma adı Kunavo'nun sunmadığı Sonnet 5.5'i ister: bu değişken olmadan /model sonnet, opusplan yürütme aşaması ve sonnet ile yapılandırılan alt aracılar 404 döndürür. Bunu claude-sonnet-5 olarak ayarlamak sorunu önler.
• ANTHROPIC_DEFAULT_HAIKU_MODEL ayarını da yapın. haiku takma adı Kunavo'nun sunmadığı bir kimlik ister (v2.1.293'ten itibaren Haiku 5.5): bu değişken olmadan /model haiku ve haiku ile yapılandırılmış alt ajanlar 404 hatası verir. Ayarı claude-haiku-4-5 olarak sabitlemek bunu önler ve ayrıca Claude Code'un kendi başına yaptığı arka plan çağrılarını (özetler, başlıklar) ana modelden alır.

Anahtarı asla projenin .claude/settings.json dosyasına koymayın: bu dosya depoya gönderilir. VS Code uzantısında değişkenleri, uzantı kimlik bilgilerini başlatmadan önce kontrol ettiği için, VS Code’un kullanıcı yapılandırmasındaki claudeCode.environmentVariables içine koyun.

Katalogdan alınan 1M token başına tarifeler:

Hangi seçeneğin etkin olduğunu öğrenme

Claude Code içinde /status komutunu çalıştırın. Auth token satırı anahtarın kullanımda olduğu anlamına gelir; claude.ai hesabıyla birlikte görünen Login method satırı değişkenin okunmadığını gösterir. Bunlar toplanmaz: değişken mevcut olduğu sürece abonelik beklemeye alınır; değişkeni kaldırdığınızda Claude Code yeniden kurulum yapmadan aboneliğe döner.

Bir gateway’in arkasında üç şey değişir: Remote Control ve sesli dikte kullanılamaz (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; /context rakamları ise yerel tahminlere dönüşür. Kod, araçlar, alt ajanlar, MCP, hook’lar ve prompt caching aynı şekilde çalışır. Tüm ayrıntılar entegrasyon belgelerinde ve Claude Code API anahtarı kılavuzunda (her ikisi de İngilizce) yer alır.

Claude Code nasıl kullanılır: ilk adımlar

# 1. Arranca siempre dentro de la carpeta del proyecto
cd ~/proyectos/mi-app
claude

# 2. Primer comando: lee el repositorio y genera CLAUDE.md
> /init

# 3. Pide las tareas en español y con la ruta del archivo
> cambia la validación de src/api/user.ts a zod y arregla los tests

# 4. Para tareas que tocan muchos archivos: Shift+Tab activa el modo plan

Claude Code bir dosyayı düzenlemeden veya bir komut çalıştırmadan önce sizden izin ister; yanlış yöne gidiyorsa durdurmak için Esc tuşuna, önceki bir noktaya dönmek için /rewind tuşuna basın. CLAUDE.md tarafından oluşturulan /init, bir taslaktır: her oturumda tekrarlayacağınız şeyleri (test komutları, kurallar, dokunulmaması gereken klasörler) burada tutun. Her oturumda yüklenir ve her istekte gönderilir; Anthropic 200 satırı aşmamanızı önerir.

• Model değiştirme: /model yazıp ardından tam adı girin; örneğin /model claude-opus-5 veya claude --model claude-opus-5 ile başlayın. Bunu görevler arasında yapın: her modelin kendi önbelleği vardır ve görev ortasında değiştirmek, tüm konuşmanın önbellek olmadan yeniden okunmasını gerektirir.
• İlişkisiz görevler arasında /clear kullanın. Yeni bir konuşma başlatmak ücretsizdir; önceki konuşmaya /resume ile dönülebilir.
• Bir görev uzadığında /compact kullanın: geçmişi özetleyip devam edin. API anahtarıyla önbellek varsayılan olarak beş dakika sürer; bu nedenle uzun bir aradan sonra değil, önce sıkıştırın.
• Bir oturumun maliyeti: /usage token'ları gösterir, ancak hesapladığı tutar Anthropic'in liste fiyatına göre yerel bir tahmindir; Kunavo'da gerçek ücret kullanım sayfanızda görünür.

Ödeme ve seçim konusunda dürüstlük

Bakiye Stripe üzerinden ön ödemelidir: kart (Visa, Mastercard, American Express, JCB, UnionPay), Apple Pay, Google Pay veya Link; SEPA otomatik ödeme mevcut değildir. Minimum yükleme $10'dır, bakiyenin süresi dolmaz, başarısız istekler ücretlendirilmez ve her anahtar aylık harcama sınırını destekler. Tüm ücretler fiyatlandırma sayfasında yer alır.

Claude Code'u her gün uzun saatler kullanıyorsanız sabit abonelik ücreti genellikle daha ucuz olur; kullanım düzensiz olduğunda veya 5 saatlik pencereye bağlı kalmak istemediğinizde kullandıkça öde modeli avantajlıdır ve etkinlik olmayan bir ayın maliyeti sıfırdır. İngilizce tam karşılaştırma Claude Code pricing sayfasındadır. Kunavo üzerinden özel kota veya sözleşmeli SLA olmadan paylaşılan kapasiteyi kullanırsınız; bu garantilere ihtiyacınız varsa doğrudan Anthropic'ten hizmet alın.

Sık sorulan sorular