Claude Code Windows ve Mac'e Kolayca Nasıl Yüklenir?

Claude Code'u Windows veya Mac'e hızla yükleyin, ortamınızı yapılandırın ve gelişmiş AI iş akışları için Kimi API ile eşleştirin. Karmaşık görevleri otomatikleştirin, çok adımlı süreçleri çalıştırın ve daha akıllı AI entegrasyonuyla kodlama deneyiminizi geliştirin.

10 dakikalık okumaGüncellendi: 2026-09-28

Claude Code'u Kimi API'ye bağlama

AI kodlama araçları, daha hızlı çalışmak ve görevleri daha verimli yürütmek isteyen geliştiriciler için popüler bir seçenek hâline geliyor. Pek çok kullanıcı, kodlama iş akışlarını sadeleştirmek, tekrarlayan işleri otomatikleştirmek ve çok adımlı süreçleri tek bir ortamdan yönetmek için Claude Code'u yüklemeyi tercih ediyor. Windows veya Mac'te doğru bir kurulum, sorunsuz performans ve gelişmiş AI hizmetleriyle daha iyi entegrasyon sağlar. Claude Code'un Windows ve Mac'e nasıl yükleneceğini öğrenmek için okumaya devam edin.

Claude Code Windows'a nasıl yüklenir?

Windows 11, modern AI geliştirme araçlarını çalıştırmak için sorunsuz bir ortam sunar. Birkaç basit kurulum adımı, Claude Code'un düzgün çalışmasını ve kullanmayı planladığınız hizmetlere bağlanmasını sağlar. Yükleme işlemini tamamlamak ve özelliklerini sorunsuzca kullanmaya başlamak için aşağıdaki talimatları izleyin.

1. Adım: Claude Code'u PowerShell kullanarak yükleyin

Win + S tuşlarına basıp "PowerShell" araması yaparak PowerShell'i açın. Aşağıdaki yükleme komutunu kopyalayıp PowerShell'e yapıştırın, ardından çalıştırmak için "Enter" tuşuna basın:

irm https://claude.ai/install.ps1 | iex

PowerShell, Claude Code'u otomatik olarak indirip yükler. Devam etmeden önce yükleme işleminin tamamlanmasını bekleyin. CMD veya WinGet'i tercih ediyorsanız Claude Code, resmi belgelerinde alternatif yükleme yöntemleri de sunar.

Claude Code'u PowerShell kullanarak yükleme

2. Adım: Git'i yükleyin ve Git Bash'i başlatın

Git for Windows'u indirin ve yükleyin. Claude Code'un gerekli komut satırı araçlarına erişebilmesi ve düzgün çalışabilmesi için varsayılan yükleme ayarlarını koruyun.

Git'i indirdikten sonra yükleyiciyi açın ve kurulumu varsayılan ayarlarla tamamlayın. Yükleme yolunu değiştirmeyin, istenirse varsayılan düzenleyici olarak "Visual Studio Code"u seçin ve PATH yapılandırma seçeneklerinde "Git from the command line and 3rd-party software" seçeneğinin işaretli olduğundan emin olun.

Yükleme tamamlandıktan sonra Git'in düzgün çalıştığını doğrulamak için Başlat menüsünden "Git Bash"i açın. Git Bash, Claude Code'un Windows'ta komut çalıştırması için gereken terminal ortamını sağlar.

3. Adım: Claude Code yüklemesini doğrulayın

PowerShell'e veya Komut İstemi'ne geri dönün ve şunu çalıştırın:

claude --version

Sürüm numarası görünüyorsa Claude Code başarıyla yüklenmiştir. Görünmüyorsa PATH yapılandırma adımlarına devam edin.

4. Adım: Yükleme tamamlandı

Her şey tamamlandıktan sonra Claude Code’da oturum açın ve kurulum sürecini tamamlayın. Oturum açtıktan sonra araç, Windows 11’de doğrudan terminalden komut çalıştırmak ve AI destekli iş akışlarını yönetmek için kullanıma hazırdır.

Claude Code Mac/macOS’e nasıl yüklenir?

macOS, yerleşik terminal desteğiyle geliştirici araçlarını kurmak için sade ve kolay bir yol sunar; bu da kurulumu geliştiriciler için sorunsuz ve tutarlı hâle getirir. Claude Code kurulumu, her şeyi düzenli ve kolay yönetilebilir tutan, terminal tabanlı net bir süreci izlemeyi gerektirir. Claude Code’u Mac’e şu şekilde yükleyebilirsiniz.

1. Adım: Claude Code’u Terminal üzerinden yükleyin (curl komutu)

Mac’inizde Spotlight Arama’yı kullanarak "Terminal"i açın (Cmd + Space → "Terminal" yazın). Aşağıdaki yükleme komutunu Terminal’e kopyalayıp yapıştırın, ardından "Enter" tuşuna basın:

curl -fsSL https://claude.ai/install.sh | bash

Terminal, Claude Code’u otomatik olarak indirip yükleyecektir. Sonraki adıma geçmeden önce yükleme işleminin tamamlanmasını bekleyin.

Claude Code’u Terminal üzerinden yükleyin (curl komutu)

2. Adım: Claude Code kurulumunu doğrulayın

Yükleme işleminin tamamen bitmesini bekleyin. İşlem tamamlandığında, Claude Code’un başarıyla yüklendiğini gösteren bir onay mesajı görüntülenir. Terminal ek kurulum isterse, Claude Code’a düzgün erişim için zshrc yapılandırma dosyanıza eklemek üzere önerilen komutu çalıştırın.

3. Adım: Ortam yapılandırmasını yükleyin

Yüklemeden sonra verilen komutu çalıştırın veya kabuk yapılandırma dosyanızı yeniden yükleyin. Bu adım ortam değişkenlerini günceller; böylece Claude Code, yol sorunları olmadan terminalinizde genel olarak çalışır. Her yeni terminal penceresi açtığınızda sorunsuz erişim sağlar.

4. Adım: Claude Code’u başlatın

Terminal’e şunu yazın:

claude

Claude Code CLI’yi başlatmak için Enter tuşuna basın. Son yapılandırmayı tamamlamak üzere tercih ettiğiniz temayı ve oturum açma yöntemini seçebileceğiniz kurulum ekranı görüntülenir.

Diğer LLM API’leri Claude Code’a nasıl entegre edilir?

Claude Code’u harici AI modelleriyle kullanmak, geliştirme sürecine esneklik kazandırır. Üçüncü taraf LLM API’lerini bağlamak, geliştiricilerin farklı modelleri tek bir ortamda çalıştırmasına ve görevleri daha verimli yönetmesine olanak tanır. Örneğin, uzun bağlamı güçlü biçimde anlayan ve yapılandırılmış çıktı sunan API’ler kodlama iş akışlarını daha da geliştirebilir. Aşağıdaki adımlarda, harici bir LLM API’sinin Claude Code’a nasıl bağlanacağını göstermek için Kimi örnek olarak kullanılmıştır.

1. Adım: Kimi Code API Anahtarını alın

Not: Bu kılavuzda kullanılan api.kimi.ai/coding/ uç noktası, Kimi Code üyelik avantajının bir parçasıdır. Anahtarınızı oluşturmadan önce Kimi Code avantajları etkinleştirilmiş aktif bir Kimi üyeliğiniz olduğundan emin olun — ücretsiz hesapların anahtarları başlatma sırasında reddedilir.

Kimi Code Console sayfasına gidin, Create API Key seçeneğine tıklayın, bir ad girip onaylayın ve ardından anahtarı hemen kopyalayın — anahtarın tamamı yalnızca bir kez gösterilir. Kullanabileceğiniz modeller ve bağlam pencereleri üyelik planınıza bağlıdır (örneğin, eski Andante planları 1M bağlamla kimi-for-coding kullanır; Plus/Moderato planları k3-256k kullanabilir; Pro/Allegretto ve üstü planlar ise 1M bağlamlı k3ü veya yüksek hızlı varyantını kullanabilir).

Claude Code'u Kimi API'ye bağlama

2. Adım: Oturum açmayı atlayın (isteğe bağlı kurulum betiği)

Yüklemeden sonra Claude Code’u henüz başlatmayın. Varsayılan başlangıç/oturum açma akışını atlamak ve geçmiş yapılandırmaları temizlemek için terminalinizde aşağıdaki betiği çalıştırın. Bu betik üçüncü taraf model desteğini ve hızlı modu etkinleştirir; ayrıca ~/.claude/settings.json dosyasından eski uç nokta, kimlik bilgisi ve model girdilerini kaldırır (buradaki kalıntılar, terminalinizde dışa aktarılan ortam değişkenlerini geçersiz kılar):

node --eval " // enable third party model support and fast mode const claudeJsonFilePath = path.join(os.homedir(), '.claude.json'); if (fs.existsSync(claudeJsonFilePath)) { const content = JSON.parse(fs.readFileSync(claudeJsonFilePath, 'utf-8')); fs.writeFileSync(claudeJsonFilePath, JSON.stringify(Object.assign({}, content, { penguinModeOrgEnabled: true, hasCompletedOnboarding: true }), null, 2), 'utf-8'); } else { fs.writeFileSync(claudeJsonFilePath, JSON.stringify({ penguinModeOrgEnabled: true, hasCompletedOnboarding: true }, null, 2), 'utf-8'); } // delete old endpoint, credential and model id const claudeSettingsJsonFilePath = path.join(os.homedir(), '.claude', 'settings.json'); if (fs.existsSync(claudeSettingsJsonFilePath)) { const content = JSON.parse(fs.readFileSync(claudeSettingsJsonFilePath, 'utf-8')); if (typeof content === 'object' && typeof content.env === 'object') { for (const element of [ 'ANTHROPIC_BASE_URL', 'ANTHROPIC_API_KEY', 'ANTHROPIC_AUTH_TOKEN', 'ANTHROPIC_MODEL', 'ANTHROPIC_SMALL_FAST_MODEL', 'CLAUDE_CODE_SUBAGENT_MODEL', 'ANTHROPIC_DEFAULT_FABLE_MODEL', 'ANTHROPIC_DEFAULT_FABLE_MODEL_NAME', 'ANTHROPIC_DEFAULT_OPUS_MODEL', 'ANTHROPIC_DEFAULT_OPUS_MODEL_NAME', 'ANTHROPIC_DEFAULT_SONNET_MODEL', 'ANTHROPIC_DEFAULT_SONNET_MODEL_NAME', 'ANTHROPIC_DEFAULT_HAIKU_MODEL', 'ANTHROPIC_DEFAULT_HAIKU_MODEL_NAME', 'ENABLE_TOOL_SEARCH', 'CLAUDE_CODE_AUTO_COMPACT_WINDOW', 'CLAUDE_CODE_EFFORT_LEVEL', ]) { delete content.env[element]; } fs.writeFileSync(claudeSettingsJsonFilePath, JSON.stringify(content, null, 2), 'utf-8'); } }"

Bu betik Node.js gerektirir (node --version ile kontrol edin; komut bulunamazsa önce nodejs.org’dan LTS sürümünü yükleyin). Başarılı olduğunda çıktı vermez — bu beklenen bir durumdur. Ayrıca ~/.zshrc ve ~/.bashrc gibi kabuk yapılandırma dosyalarında eski ANTHROPIC_* dışa aktarımlarını kontrol edip silin (Windows kullanıcıları: kullanıcı ortam değişkenlerini kontrol edin); aksi takdirde yeni yapılandırmaya müdahale ederler.

3. Adım: API erişimini yapılandırın ve Claude Code’u başlatın

İki yapılandırma yöntemi vardır — birini seçin, ikisini karıştırmayın. Yöntem 1, ~/.claude/settings.json dosyasına yazar ve kalıcı olarak etkili olur; Yöntem 2 ise değişkenleri yalnızca geçerli terminalde dışa aktarır ve bu oturum boyunca etkilidir. Aşağıdaki örnekte k3-256k (256K bağlam) kullanılmıştır; planınız 1M bağlamlı k3ü içeriyorsa tüm model değerlerini k3[1m] ile değiştirin ve her iki bağlam değerini 1048576 olarak ayarlayın.

Yöntem 1: settings.json dosyasına yazın (önerilen, kalıcı)

Aşağıdakileri ~/.claude/settings.json dosyasındaki env alanına yazın (Windows’ta: %USERPROFILE%\.claude\settings.json; dosya yoksa oluşturun), ardından etkili olmaları için Claude Code’u yeniden başlatın:

{ "env": { "ANTHROPIC_BASE_URL": "https://api.kimi.ai/coding/", "ANTHROPIC_API_KEY": "Your API Key", "ANTHROPIC_MODEL": "k3-256k", "ANTHROPIC_DEFAULT_FABLE_MODEL": "k3-256k", "ANTHROPIC_DEFAULT_OPUS_MODEL": "k3-256k", "ANTHROPIC_DEFAULT_SONNET_MODEL": "k3-256k", "ANTHROPIC_DEFAULT_HAIKU_MODEL": "k3-256k", "CLAUDE_CODE_SUBAGENT_MODEL": "k3-256k", "CLAUDE_CODE_EFFORT_LEVEL": "high", "CLAUDE_CODE_AUTO_COMPACT_WINDOW": "262144", "CLAUDE_CODE_MAX_CONTEXT_TOKENS": "262144" } }

Your API Key ifadesini 1. Adımda kopyaladığınız anahtarla değiştirin. Dosya anahtarı düz metin olarak saklar — git’e göndermeyin. settings.json içindeki env bloğunun, terminalinizde dışa aktarılan aynı adlı değişkenleri geçersiz kıldığını unutmayın.

Yöntem 2: Terminal ortam değişkenleri (yalnızca geçerli oturum)

macOS / Linux

export ANTHROPIC_BASE_URL=https://api.kimi.ai/coding/ export ANTHROPIC_API_KEY="Your API Key" export ANTHROPIC_MODEL="k3-256k" export ANTHROPIC_DEFAULT_FABLE_MODEL=$ANTHROPIC_MODEL export ANTHROPIC_DEFAULT_OPUS_MODEL=$ANTHROPIC_MODEL export ANTHROPIC_DEFAULT_SONNET_MODEL=$ANTHROPIC_MODEL export ANTHROPIC_DEFAULT_HAIKU_MODEL=$ANTHROPIC_MODEL export CLAUDE_CODE_SUBAGENT_MODEL=$ANTHROPIC_MODEL export CLAUDE_CODE_EFFORT_LEVEL=high export CLAUDE_CODE_AUTO_COMPACT_WINDOW=262144 export CLAUDE_CODE_MAX_CONTEXT_TOKENS=262144 claude

Windows

Aynı ortam değişkenlerini PowerShell’de veya sistem ayarlarında belirleyin, ardından şunu çalıştırın:

$env:ANTHROPIC_BASE_URL="https://api.kimi.ai/coding/" $env:ANTHROPIC_API_KEY="Your API Key" $env:ANTHROPIC_MODEL="k3-256k" $env:ANTHROPIC_DEFAULT_FABLE_MODEL=$env:ANTHROPIC_MODEL $env:ANTHROPIC_DEFAULT_OPUS_MODEL=$env:ANTHROPIC_MODEL $env:ANTHROPIC_DEFAULT_SONNET_MODEL=$env:ANTHROPIC_MODEL $env:ANTHROPIC_DEFAULT_HAIKU_MODEL=$env:ANTHROPIC_MODEL $env:CLAUDE_CODE_SUBAGENT_MODEL=$env:ANTHROPIC_MODEL $env:CLAUDE_CODE_EFFORT_LEVEL="high" $env:CLAUDE_CODE_AUTO_COMPACT_WINDOW="262144" $env:CLAUDE_CODE_MAX_CONTEXT_TOKENS="262144" claude

Your API Key ifadesini 1. Adımda kopyaladığınız anahtarla değiştirin. Model değişkenlerinin yalnızca bir kısmını yapılandırmak, ilgili senaryoların (ana konuşma, arka plan özetleme, alt ajanlar) sessizce başarısız olmasına neden olur; bu nedenle tam seti koruyun.

Bu API anahtarının kullanılıp kullanılmayacağı sorulursa devam etmek için onaylayın. Ardından yetkilendirmeyi tamamlamak için istemleri izleyerek güvenilir proje klasörünüzü seçin.

Claude Code’u yeni yapılandırmayla çalıştırın

4. Adım: Entegrasyon durumunu doğrulayın

Başlattıktan sonra şunu çalıştırın:

/status

Base URL şu şekilde görünüyorsa:

https://api.kimi.ai/coding/

Entegrasyon başarılıdır. Arayüz hâlâ Claude modellerini gösterse bile tüm istekler Kimi Code API üzerinden yönlendirilir.

Kimi API kullanmanın avantajları

Geliştirme sürecinde gelişmiş AI araçlarını kullanmak, işleri hızlandırmanın ve genel kod kalitesini artırmanın pratik bir yolu hâline geldi. Kimi API, gerçek projelerde anlama, otomasyon ve ekip tabanlı iş akışları için güçlü destek sunar. Geliştiricilerin sistemleri daha verimli oluşturmasına ve yönetmesine şu şekilde yardımcı olur.

Geliştirme görevleri için çok modlu bağlam anlama

Kimi API; metin, tasarım maketleri, mimari diyagramlar, akış şemaları ve hatta videolar gibi farklı girdi türlerini anlar. Bu bilgileri, geliştiricilerin doğrudan kullanabileceği net teknik planlara dönüştürür. Böylece fikirler, daha az manuel planlamayla çalışan koda dönüştürülebilir.

Bağlamın yeniden kullanımıyla daha uygun maliyetli

Kimi API, bağlamın yeniden kullanımını destekler; böylece geliştiriciler aynı bilgileri tekrar tekrar göndermek yerine mevcut konuşmalar ve proje bağlamı üzerinden çalışmayı sürdürebilir. Bu, gereksiz token kullanımını ve API maliyetlerini azaltmaya, uzun vadeli geliştirme iş akışlarını daha verimli hâle getirmeye yardımcı olur.

Tekrarlayan mühendislik iş akışlarını otomatikleştirir

Rutin ve tekrarlayan kodlama görevleri, betikler veya AI destekli iş akışlarıyla otomatikleştirilebilir. Bu görevler, her seferinde manuel çaba gerektirmeden basit komutlarla çalıştırılabilir. Böylece zaman kazanılır ve günlük geliştirme süreçlerindeki insan hatası olasılığı azalır.

Skills ve araçlarla özelleştirilebilir geliştirme iş akışları

Kimi API, farklı geliştirme ihtiyaçları için özel Skills ve araç entegrasyonlarını destekler. Ekipler kendi dahili araçlarını, betiklerini ve sistemlerini doğrudan iş akışına bağlayabilir. Bu da geliştirme sürecini daha esnek ve projeye özgü kılar.

Daha yüksek kalite ve verimlilik için çoklu ajan iş birliği

Farklı AI ajanları kodlama, test, mimari ve dokümantasyon gibi farklı rolleri üstlenir. Bu ajanlar, görevleri daha hızlı tamamlamak için sırayla veya paralel çalışabilir. Bu sayede hem geliştirme hızı hem de genel çıktı kalitesi artar.

Claude Code kurulumu için sorun giderme

Claude Code'u Windows veya Mac'e kurarken kullanıcılar, ortam yapılandırması, Node.js sürümü ya da ağ koşulları nedeniyle bazen küçük teknik sorunlarla karşılaşabilir. Bu sorunlar CLI tabanlı araçlarda yaygındır ve genellikle çözülebilir. Aşağıda en sık görülen sorunlar ve bunları pratik olarak nasıl anlayabileceğiniz yer alır.

"command not found: claude"

Bu hata genellikle Claude Code'un sistem PATH'inize eklenmediği anlamına gelir. Terminal, yüklü ikili dosyayı bulamaz. Terminali yeniden başlatmak veya PATH ayarlarını düzeltmek, çoğu durumda sorunu hızlı ve güvenilir biçimde çözer.

Kimlik doğrulama başarısız oluyor veya tarayıcı açılmıyor

Bu durum, genellikle kısıtlı sistemlerde veya uzak ortamlarda oturum açma işlemi tarayıcıyı otomatik olarak başlatamadığında ortaya çıkar. Böyle durumlarda kimlik doğrulamanın API anahtarı kullanılarak manuel olarak yapılması gerekebilir. Yapılandırma tamamlandığında oturum açma işlemi başka sorun olmadan normal şekilde çalışır.

Kurulum sırasında "Network Error" veya zaman aşımı

Bu sorun genellikle yavaş internet, güvenlik duvarı kısıtlamaları veya engellenmiş npm erişiminden kaynaklanır. Yükleyici, kurulum sırasında gerekli sunuculara bağlanamayabilir. Ağ ayarlarını veya proxy yapılandırmasını değiştirmek ya da bağlantıyı değiştirmek genellikle sorunu etkili biçimde çözer.

Claude Code yavaş çalışıyor

Performans sorunları genellikle aracın kendisinden değil, ağ gecikmesinden kaynaklanır. Claude Code bulut API isteklerine dayandığı için kararsız internet bağlantısı veya VPN kullanımı onu yavaşlatabilir. Kararlı bir bağlantı genellikle hızı önemli ölçüde ve tutarlı biçimde artırır.

Sonuç

Claude Code'un Windows veya Mac'e nasıl kurulacağını öğrenmek, AI destekli geliştirme iş akışına daha sorunsuz başlamanıza yardımcı olur. Kurulum tamamlandığında kodlama görevlerini daha verimli yönetebilir ve günlük geliştirme işlerini daha entegre bir ortamda kolaylaştırabilirsiniz. Daha gelişmiş veya esnek kullanım senaryoları için bu yetenekleri genişletmek ve gerçek projelerdeki geliştirme iş akışlarını iyileştirmek üzere Kimi API'yi deneyebilirsiniz.

Claude Code'u Kimi API'ye bağlama

SSS

Claude Code, terminalinizi veya PowerShell'i açıp claude komutunu yazarak başlatılabilir. CLI arayüzünü açmak için Enter tuşuna basın. Kurulum doğruysa kurulum ekranı görünür ve oturum açma veya proje seçimi adımlarında size rehberlik eder. Ardından komutları doğrudan terminalde kullanmaya başlayabilirsiniz.

Ücretli abonelik her zaman gerekli değildir, ancak bazı özellikler planınıza veya erişim düzeyinize bağlı olabilir. Yapılandırmaya bağlı olarak temel kullanım ve kurulum genellikle standart erişimle çalışabilir. Gelişmiş özellikler veya daha yüksek sınırlar abonelik gerektirebilir. Kesin bilgi için resmi Claude plan ayrıntılarını kontrol etmek en iyisidir.

Kimi API, Claude Code içinde gelişmiş bağlam yönetimi, otomasyon ve çok adımlı iş akışları desteği sağlar. Uzun girdilerin, yapılandırılmış görevlerin ve karmaşık geliştirme talimatlarının daha verimli işlenmesine yardımcı olur. Bu, kodlama sırasında hızı artırır ve manuel çabayı azaltır. Genel olarak iş akışını daha esnek ve üretken hâle getirir.