Claude Code, desteklenen her platformda tek bir komutla yüklenir ve ilk çalıştırmanın tamamı şöyledir: yükleyin, claude yazın, giriş yapın. Bu rehberde her işletim sistemi için tam komut, çalışmadığında kontrol edilecekler ve çalıştıktan sonra farklı bir uç noktaya yönlendirme anlatılır.
Komutlar 10 Ekim 2026 tarihinde doğrulandı Anthropic'in Claude Code kurulum belgelerine göre.
Başlamadan önce
| Gereksinim | Desteklenenler |
|---|---|
| İşletim sistemi | macOS 13.0+, Windows 10 1809+ / Server 2019+, Ubuntu 20.04+, Debian 10+, Alpine Linux 3.19+ |
| Donanım | 4 GB+ RAM, x64 veya ARM64 |
| Kabuk | Bash, Zsh, PowerShell veya CMD |
| Ağ | İnternet bağlantısı gerekir |
| Hesap | Pro, Max, Team, Enterprise veya Console — ücretsiz Claude.ai planı Claude Code'u içermez |
Yükleme — bağımsız yükleyici
Bu, her platformda önerilen yöntemdir. Kendi kendine yeten bir ikili dosya yükler ve arka planda kendini güncel tutar.
# macOS, Linux, WSL
curl -fsSL https://claude.ai/install.sh | bash# Windows PowerShell
irm https://claude.ai/install.ps1 | iex:: Windows CMD
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmdHangi Windows kabuğunda olduğunuzdan emin değilseniz istem bunu gösterir: PowerShell PS C:\, CMD ise PS olmadan C:\ gösterir. Yanlış olanı çalıştırmak, Windows'taki en yaygın tek yükleme hatasıdır — her iki durumdaki tam hatayı görmek için aşağıdaki sorun giderme tablosuna bakın.
Paket yöneticileri
Kurulumu mevcut paket yöneticinizin yönetmesini tercih ediyorsanız bunları kullanın. Bunun dezavantajı güncellemelerle ilgilidir: bağımsız yükleyicinin aksine bunların hiçbiri varsayılan olarak otomatik güncellenmez.
# Homebrew (macOS, Linux) — stable channel
brew install --cask claude-code
# WinGet (Windows)
winget install Anthropic.ClaudeCode
# npm — requires Node.js 22+; never with sudo
npm install -g @anthropic-ai/claude-codeHomebrew iki cask yayımlar: claude-code kararlı kanalı izler (genellikle yaklaşık bir hafta geriden gelir ve büyük gerilemeler içeren sürümleri atlar), claude-code@latest ise her sürümü hemen yayımlar. Debian / Ubuntu, Fedora / RHEL ve Alpine için imzalı apt, dnf ve apk depoları mevcuttur; her biri aynı kararlı ve latest kanallarını sunar.
npm'de asla sudo npm install -g kullanmayın — bu, izin sorunlarına yol açar ve güvenlik riski oluşturur. npm paketi, bağımsız yükleyiciyle tamamen aynı derlenmiş ikiliyi kurar; dolayısıyla her iki durumda da çalışma zamanında Node bağımlılığı yoktur.
Kurulumu doğrulama
claude --version # prints e.g. "2.1.211 (Claude Code)"
claude doctor # read-only install + settings diagnostics
claude # start a session in the current projectclaude doctor hatırlamanız gereken komuttur: oturum başlatmadan kurulum durumunu, ayarlar dosyası doğrulama hatalarını ve önerilen düzeltmeleri yazdırır; bu da bozuk bir kurulumu bozuk yapılandırmadan ayırmanın en hızlı yoludur.
İlk çalıştırma ve giriş
Çalışmak istediğiniz projede bir terminal açın ve claude çalıştırın. Etkileşimli bir oturum açar ve tarayıcıda giriş yapma sürecinde size yol gösterir. Claude Code bir Pro, Max, Team, Enterprise veya Console hesabı gerektirir.
Sizi hazırlıksız yakalamadan önce bilmeniz gereken bir davranış: ortamınızda zaten ANTHROPIC_API_KEY ayarlıysa Claude Code tarayıcı açmak yerine bu anahtarı onaylamanızı bir kez ister. Bu istemi reddederseniz anahtar bundan sonra sessizce yok sayılır ve başka istem gösterilmez — bu da değişken okunmuyormuş gibi görünür. /config → Özel API anahtarını kullan bölümünden yeniden etkinleştirin.
Windows: WSL'siz veya WSL
| Seçenek | Gereksinim | Korumalı çalıştırma | Şu durumda seçin |
|---|---|---|---|
| WSL'siz Windows | Hiçbir şey; Git for Windows isteğe bağlı | Desteklenmiyor | Projeleriniz ve araçlarınız Windows'a özgü |
| WSL 2 | WSL 2 etkin | Destekleniyor | Linux araç zincirleri veya korumalı komut çalıştırma istiyorsunuz |
| WSL 1 | WSL 1 etkin | Desteklenmiyor | WSL 2 sizin için kullanılamıyor |
WSL'siz Windows'ta Git for Windows kurulumu isteğe bağlıdır ancak önerilir: Bash aracının temel aldığı Git Bash'i sağlar. Bu olmadan Claude Code kabuk komutlarını PowerShell aracı üzerinden çalıştırır. WSL altında claude kurulumunu ve çalıştırmasını PowerShell'den değil, WSL terminalinin içinde yapın.
Sorun giderme
| Belirti | Neden ve düzeltme |
|---|---|
The token '&&' is not a valid statement separator | CMD komutunu PowerShell'de çalıştırdınız. Bunun yerine irm … | iex satırını kullanın. |
'irm' is not recognized… | Tersi — PowerShell komutunu CMD'de çalıştırdınız. curl … install.cmd satırını kullanın. |
syntax error near unexpected token '<', bir 403 veya başka bir curl hatası | İndirme betiği döndürmedi — bunun nedeni genellikle sizinle yükleyici arasındaki bir proxy veya ağ filtresidir. Yeniden deneyin ya da bunun yerine paket yöneticisiyle kurulum yapın. |
Temiz kurulumdan sonra claude: command not found | Kabuğunuzun kurulum dizinini algılaması için yeni bir terminal açın, ardından claude doctor çalıştırın. İkinci, eski bir kurulum veya eski bir kabuk takma adı da sık görülen diğer nedendir. |
| npm kurulumu sırasında izin hataları | sudo kullandınız veya npm genel dizimi yazılabilir değil. sudo ile yeniden çalıştırmak yerine dizinin sahipliğini düzeltin; yazılamayan bir genel dizin otomatik güncellemeyi de engeller. |
npm install -g sonrasında derlenmiş ikili eksik | Paket yöneticiniz isteğe bağlı bağımlılıkları atlayacak şekilde yapılandırılmış. Platform ikilisi bunlardan biri olarak gelir; bunlara izin verin ve yeniden kurun. |
| Alpine veya başka bir musl dağıtımında kurulum başarısız oluyor | Alpine, bash ve curl olmadan gelir. bash curl libgcc libstdc++ ripgrep kurun, ardından ayarlar dosyanızın env bloğunda USE_BUILTIN_RIPGREP değerini "0" olarak ayarlayın. |
| Arama ve dosya keşfi başarısız oluyor | ripgrep normalde pakete dahildir. Platformunuzda çalışamıyorsa sistem ripgrep paketini kurun ve USE_BUILTIN_RIPGREP=0 değerini ayarlayın. |
| WSL'siz Windows'ta Bash aracı eksik | Git for Windows'ı kurun. Claude Code hâlâ Git Bash'i bulamıyorsa ~/.claude/settings.json içindeki env bloğunda CLAUDE_CODE_GIT_BASH_PATH değerini ayarlayın. |
Bir anahtar yapılandırıldıktan sonra 401 | Anahtar, sunucunun okumadığı üst bilgide. ANTHROPIC_AUTH_TOKEN ile ANTHROPIC_API_KEY arasında geçiş yapın. Ayrıntılar için API anahtarı kılavuzuna bakın. |
Claude Code'u Kunavo'ya yönlendirme
Çalışmaya başladıktan sonra Claude Code, Anthropic Messages API'sini sunan herhangi bir uç noktayla çalışır — ANTHROPIC_BASE_URL değerini doğrudan okur; dolayısıyla bu bir geçici çözüm değil, desteklenen bir yapılandırmadır. Eklenti, proxy veya yamalı ikili gerekmez:
export ANTHROPIC_BASE_URL=https://api.kunavo.com
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-5Bu blok hakkında, her biri yanlış yapılandırıldığında size bir saate mal olabilecek beş şey:
ANTHROPIC_BASE_URLyalnızca origin'dir. Claude Code/v1/messagesyolunu kendisi ekler — yolu dahil etmek 404 döndürür.ANTHROPIC_AUTH_TOKENkullanın,ANTHROPIC_API_KEYkullanmayın. Bunlar farklı HTTP üst bilgilerinde yer alır. Bearer token hemen etkin olurkenANTHROPIC_API_KEYyukarıda açıklanan tek seferlik onayı gerektirir. Kunavo,/v1/modelsdahil olmak üzere anahtarı her iki üst bilgiden de okur; dolayısıyla Kunavo'da bu onay adımı onları birbirinden ayırır.ANTHROPIC_MODELdeğerini açıkça ayarlayın. Kunavo model slug'larını tam olarak eşleştirir ve tarihle sonlandırılmış adlara takma ad vermez; bu nedenleclaude-sonnet-4-5-20250929404 döndürürkenclaude-sonnet-5çalışır.ANTHROPIC_DEFAULT_OPUS_MODELveANTHROPIC_DEFAULT_SONNET_MODELdeğerlerini de sabitleyin. Claude Code'un yerleşik varsayılanı veopustakma adı, her ikisi de en yeni Opus modeline çözümlenir; Kunavo bu modeli henüz sunmuyorsa ilk istek 404 döndürür. Bu blok,opusdeğerini Opus 5.5'e (claude-opus-5-5) sabitler; bunun için Claude Code v2.1.280 veya üzeri gerekir — daha eski bir kurulumdaclaude updateçalıştırın.sonnettakma adı Sonnet 5.5 ister; Kunavo bu modeli sunmadığından sonnet sabitlemesi/model sonnetolmadanopusplanyürütme aşaması vemodel: sonnetolarak ayarlanan tüm alt aracılar 404 döndürür.ANTHROPIC_DEFAULT_HAIKU_MODELayarını da sabitleyin.haikutakma adı Kunavo'nun sunmadığı bir model kimliği ister (v2.1.293'ten itibaren Haiku 5.5, daha öncesinde tarih içeren bir Haiku 4.5 kimliği); bu nedenle bu satır olmazsa/model haikuvemodel: haikuolarak ayarlanmış alt ajanlar (yerleşikclaude-code-guidedâhil) 404 hatası verir. Ayrıca Claude Code'un kendi başına özet ve başlıklar için yaptığı arka plan çağrılarını ana modelden başka bir modele taşır: 1 milyon token başınaclaude-haiku-4-5ücreti $0,70 / $3,50 iken karşılaştırılan ücretler $1,40 / $7,00 şeklindedir.
Editörlerin ve arka planda çalışan ajanların da bunları görmesini istiyorsanız, kabukta export ile tanımlamak yerine ~/.claude/settings.json içindeki env bloğuna yerleştirin — ve asla bir projenin sürüm kontrolüne kaydedilmiş .claude/settings.json dosyasına koymayın. Kaydolduktan sonra kontrol panelinde sk-kn- anahtarını oluşturun; minimum bakiye yükleme tutarı $10'dır, aylık ücret yoktur ve bakiyenin süresi dolmaz. Her modelin token başına maliyetinin Anthropic'in resmî API fiyatlandırmasıyla karşılaştırılması, bu $10 ile ne kadar kullanım elde edebileceğinizi belirler.
Bir ağ geçidinin arkasında ne değişir
Kodlama, araçlar, alt aracılar, MCP, hook'lar ve istem önbelleğe alma etkilenmez. Üç şey değişir; bir şeyin bozulduğunu varsaymadan önce bunları bilmeye değer:
- Remote Control ve sesli dikte kullanılamaz. Her ikisi de ağ geçidi kimlik bilgisinin yerine geçtiği bir claude.ai kimliği gerektirir.
/fasthızlı modu devre dışı olarak bildirebilir. Kullanılabilirlik denetimi temel URL'nizi izlemek yerine doğrudan Anthropic'i çağırır. Normal istekler etkilenmez./contextsayıları yerel tahminlere dönüşür. Token sayımı, Anthropic'in kendi ağ geçidi belirtiminin isteğe bağlı işaretlediği tek uç noktadır; bulunmadığında Claude Code yerel olarak tahmin eder — Kunavo bugün/v1/messages/count_tokenssunmuyor. Otomatik sıkıştırma ve oturumun kendisi etkilenmez.
Tam liste ve yönlendirici kullanma/kullanmama kararı Claude Code yönlendirici kılavuzunda yer alır.
Sık sorulan sorular
Claude Code'u nasıl yüklerim?
macOS, Linux veya WSL'de `curl -fsSL https://claude.ai/install.sh | bash` komutunu çalıştırın. Windows'ta PowerShell içinde `irm https://claude.ai/install.ps1 | iex` komutunu veya CMD'de `curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd` komutunu çalıştırın. Bağımsız yükleyici önerilen yöntemdir ve arka planda kendini güncel tutar. Homebrew (`brew install --cask claude-code`), WinGet (`winget install Anthropic.ClaudeCode`), npm ve imzalı apt/dnf/apk depoları da desteklenir, ancak bunların hiçbiri varsayılan olarak otomatik güncellenmez.
Claude Code'u yüklemek için Node.js'e ihtiyacım var mı?
Bağımsız yükleyici, Homebrew, WinGet veya Linux paket depoları için gerekmez — bunların tümü çalışma zamanında Node kullanmayan derlenmiş bir ikili dosya yükler. Yalnızca npm yükleme yolu Node içerir ve v2.1.198 itibarıyla bu paket Node.js 22 veya sonraki bir sürümünü gerektirir. O durumda bile npm, platform başına isteğe bağlı bir bağımlılık aracılığıyla aynı derlenmiş ikili dosyayı çeker.
Claude Code için sistem gereksinimleri nelerdir?
macOS 13.0+, Windows 10 1809+ veya Windows Server 2019+, Ubuntu 20.04+, Debian 10+ ya da Alpine Linux 3.19+; x64 veya ARM64 işlemcide 4 GB veya daha fazla RAM; internet bağlantısı; kabuk olarak Bash, Zsh, PowerShell veya CMD. Ayrıca Anthropic'in desteklediği bir ülkede bulunmanız gerekir.
Claude Code'a ilk kez nasıl giriş yaparım?
Bir proje dizininde `claude` komutunu çalıştırın ve tarayıcıdaki istemleri izleyin. Claude Code, Pro, Max, Team, Enterprise veya Console hesabı gerektirir — ücretsiz Claude.ai planı Claude Code erişimini içermez. ANTHROPIC_API_KEY ortam değişkeni ayarlanmışsa Claude Code, tarayıcı açmak yerine bu anahtarı onaylamanızı bir kez ister.
Claude Code'u WSL olmadan Windows'a yükleyebilir miyim?
Evet. PowerShell veya CMD yükleyicisini çalıştırın ve herhangi bir terminalden `claude` komutunu başlatın; Yönetici haklarına ihtiyacınız yoktur. Git for Windows isteğe bağlıdır ancak önerilir, çünkü Bash aracını destekleyen Git Bash'i sağlar — bu olmadan Claude Code kabuk komutlarını PowerShell aracı üzerinden çalıştırır. Linux araç zincirleri veya WSL'siz Windows'un desteklemediği korumalı komut yürütmeyi istiyorsanız WSL 2'yi seçin.
Yükleme sonrasında `claude` neden command not found diyor?
Yükleme dizini, kullandığınız kabuğun PATH'inde değildir. Önce yeni bir terminal açın — yükleyici macOS ve Linux'ta ~/.local/bin'i ekler ve mevcut bir oturum bunu algılamaz. Yüklemeyi ve ayar dosyalarınızı salt okunur olarak tanılamak için `claude doctor` komutunu çalıştırın. İkinci, daha eski bir yükleme veya kalmış bir kabuk takma adı diğer yaygın nedendir.
Claude Code'u farklı bir API uç noktasına nasıl yönlendiririm?
ANTHROPIC_BASE_URL değerini Anthropic Messages API'yi sunan herhangi bir uç noktanın origin'ine ayarlayın — Claude Code bunu doğrudan okur ve /v1/messages yolunu kendisi ekler; bu nedenle eklenti veya proxy gerekmez. Kimlik bilgisi için ANTHROPIC_AUTH_TOKEN ile birlikte açık bir ANTHROPIC_MODEL kullanın ve ANTHROPIC_DEFAULT_OPUS_MODEL, ANTHROPIC_DEFAULT_SONNET_MODEL ve ANTHROPIC_DEFAULT_HAIKU_MODEL değerlerini uç noktanın sunduğu modellere sabitleyin; aksi halde opus ve sonnet takma adları Anthropic'in en yeni modellerini izler. Kunavo'da bu yöntem, aynı Claude modellerini Anthropic'in liste fiyatının %30 altında, kullandıkça öde modeliyle çalıştırır.
Sonraki adımlar
- Claude Code API anahtarı — nereden alınır, nereye konur ve 401 hatalarının çoğuna yol açan üst bilgi uyuşmazlığı.
- Claude Code fiyatlandırması — abonelik ve API, model başına ücretler ve bir ayın maliyeti.
- Claude Code ücretsiz mi? — nelerin ücretsiz olduğu, nelerin olmadığı ve sınırın nerede bulunduğu.
- İzin istemleri olmadan çalıştırma —
--dangerously-skip-permissionsgerçekte neyi kaldırır ve her biri yaklaşık bir dakikada tamamlanan üç sınırlama. - Claude Code ve Codex CLI karşılaştırması — hâlâ bir terminal aracısı seçiyorsanız.