Anthropic bu ay Claude Code’un masaüstü için önizlemesini yayımladı — Anthropic’in ajan odaklı kodlama iş akışlarını terminalin dışına çıkarıp grafiksel bir ortama taşıyan, yerel bir masaüstü uygulaması. Uygulama, paralel olarak birden fazla, yalıtılmış kodlama oturumunu çalıştırma desteğini yerleşik olarak sunuyor. Masaüstü önizlemesi, Claude Code’un web ve mobil sürümlerinin yanında konumlanacak şekilde tasarlandı ve iki pratik geliştirici sorununa odaklanıyor: aynı depo üzerinde birden fazla yapay zekâ ajanını birbirini engellemeden çalıştırmak ve tek bir GUI’den yerel veya bulut oturumlarını başlatmayı kolaylaştırmak.
Masaüstünde Claude Code nedir?
Masaüstünde Claude Code, geliştiricilerin GUI kullanarak Claude Code oturumlarını yerelde veya Anthropic’in güvenli bulut altyapısında çalıştırmasına olanak tanıyan yerel (önizleme) masaüstü uygulamasıdır; yalnızca CLI ile sınırlı değildir. Claude Code’un temel ajan odaklı kodlama yeteneklerini masaüstü kolaylıklarıyla birleştirir: oturum yönetimi, yerel ortam entegrasyonu ve web oturumlarının tek tıkla başlatılması. Uygulama, Claude Code’un CLI ve web seçeneklerinin bir eşlikçisi olarak konumlandırılmıştır; tutarlı ve kararlı bir deneyimi korumak için kararlı bir Claude Code çalışma zamanı paketler ve sürümleri sizin için yönetir.
Bu neden önemli? Tarihsel olarak, yapay zekâ kodlama araçları ya tamamen terminalde (CLI iş akışlarına alışkın geliştiriciler) ya da tamamen bulutta (tarayıcı arayüzleri) çalışırdı. Masaüstü uygulaması, düşük gecikmeli yerel çalıştırmayı mümkün kılarak ve izole bulut hesaplama veya kurumsal kontroller gerektiğinde Anthropic barındırmalı (web) oturumlara sorunsuz geçiş yapmanıza izin vererek bu boşluğu kapatır. Masaüstü önizlemesi özellikle çoklu oturum paralelizmini desteklemesiyle dikkat çekicidir — aynı depoda birden fazla bağımsız Claude Code ajanını eşzamanlı olarak çalıştırabilirsiniz; her biri kendi Git worktree’sinde (izole dal çalışma alanı) çalışır, böylece ajanlar birbirleriyle çakışmaz. Bu, birçok ekibin hemen faydalı bulacağı manşet özelliktir.
Masaüstü sürümü, web ve CLI sürümleriyle nasıl ilişkilidir?
Claude Code bir komut satırı aracı olarak başladı ve daha sonra web ve mobil arayüzlere genişledi; masaüstü önizlemesi bu temeller üzerine inşa edilmiştir. Masaüstü uygulaması, webde bulunan birçok yeteneği yansıtır (oturum başlatma, depo bağlantıları, ilerleme görünümü) ancak yerel iş akışı ergonomisine odaklanır — masaüstü UX, yerel kurulum ve worktree’ler üzerinden yerel Git depolarıyla daha sıkı entegrasyon — böylece oturumlar birbirlerinin dosya durumuna müdahale etmeden eşzamanlı olarak çalışabilir.
Ayrıca bkz. Claude Code Web: Nedir ve nasıl kullanılır
Masaüstünde Claude Code’un 7 harika özelliği
1) Çoklu oturum paralelizmi
Masaüstü için Claude Code, aynı anda birden fazla bağımsız Claude oturumunun çalıştırılmasını destekler. Yani bir oturum bir hata düzeltmesine, başka bir oturum test yazımına ve üçüncüsü dokümantasyon üretimine odaklanabilir — hepsi tek bir oturumda sıraya girmek yerine eşzamanlı olarak yürütülür. Bu paralel yapı iş akışlarını hızlandırır ve farklı görevleri aynı anda devretmenize olanak tanır.
Örneğin:
my-app adlı bir projeniz olduğunu ve şunları istediğinizi varsayalım:
- Bir pencerede Claude’un ana sayfayı değiştirmesi;
- Başka bir pencerede Claude’un veritabanı mantığını optimize etmesi.
Claude Desktop sizin için otomatik olarak şunları oluşturur:
~/.claude-worktrees/my-app/homepage/
~/.claude-worktrees/my-app/database/
Çakışma olmadan iki bağımsız kopya. Bu, geliştirmede iki dalı eşzamanlı olarak çalıştırmaya benzer; Claude her birini sizin için yönetir.
2. .worktreeinclude: Claude’u yok sayılan dosyalardan haberdar edin
Bazen projenizde .env veya .local gibi dosyalar vardır; bunlar genellikle .gitignore tarafından yok sayılır ve Claude çalışma dizinine kopyalanmaz. .gitignore içinde listelenen dosyalar yeni worktree’lere otomatik olarak kopyalanmaz. Claude yeni bir mekanizma sağlar: Proje kök dizininde bir .worktreeinclude dosyası oluşturabilirsiniz; bu dosya hangi dosyaların kopyalanması gerektiğini bildirir — yok sayılan dosyaların yeni oluşturulan worktree’lere kopyalanması gerekenleri belirten .gitignore tarzı bir liste (örneğin yerel .env dosyaları veya geliştiriciye özgü ayarlar). Yalnızca .worktreeinclude ve .gitignore içinde bulunan dosyalar kopyalanır; böylece takip edilen dosyaların yanlışlıkla çoğaltılmasından kaçınılır. Bu, oturum başına gizli veya ortam dosyalarını Git’e eklemeden korumak için kritiktir.
Örneğin:
.env
.env.local
.env.production
**/.claude/settings.local.json
Bu şu anlama gelir: Claude çalışma dizinini oluşturduğunda bu dosyalar da kopyalanacaktır.
Not:
- Yalnızca hem .gitignore hem de .worktreeinclude içinde bulunan dosyalar kopyalanır;
- Önemli, takip edilen dosyaları yanlışlıkla kopyalamaktan kaçının.
3) Web/bulut oturumlarını başlatma ve senkronize etme
Masaüstü uygulaması, web/bulut oturumları için bir başlatıcı olarak davranabilir — yani masaüstü UI’den bulut tabanlı Claude Code oturumlarını başlatabilir ve bunları yerelde izleyebilir veya yönlendirebilirsiniz. Yerel kontrollerin rahatlığını, bulutta barındırmanın ölçekleme veya izin modeliyle birleştirmek istiyorsanız bu hibrit mod kullanışlıdır.
Not:
- Bulutta çalışırken Claude’un görevleri Anthropic güvenlik sunucusunda yürütülür.
- Yerel ve bulut ortamları arasındaki geçiş kesintisizdir.
- Bir oturum oluşturmak için yalnızca "remote environment" seçeneğini belirleyin.
4) Web/bulut oturumlarını başlatma ve senkronize etme
Masaüstü uygulaması, web/bulut oturumları için bir başlatıcı olarak davranabilir — yani masaüstü UI’den bulut tabanlı Claude Code oturumlarını başlatabilir ve bunları yerelde izleyebilir veya yönlendirebilirsiniz. Bu hibrit mod, yerel kontrollerin rahatlığını bulutta barındırmanın ölçekleme veya izin modeliyle birleştirmek istediğinizde kullanışlıdır (hızlı görevler için yerel, riskli veya kaynak yoğun görevler için bulut).
5) Paketlenmiş Sürüm ve Kurumsal Yapılandırma
Masaüstü, ilk açılışta indirilen ve otomatik olarak yönetilen kararlı bir Claude Code çalışma zamanı içerir. Kurumsal yöneticiler gerekirse yerel Claude Code kullanımını devre dışı bırakabilir (isClaudeCodeForDesktopEnabled kurumsal politikası). Masaüstü yükleyicileri yaygın kurumsal dağıtım formatlarını (Windows için MSIX, macOS için PKG) destekler ve yöneticiler güncellemeleri ve uzantı erişimini kontrol edebilir. Bu kontroller, büyük ekipler için benimsemeyi kolaylaştırmak üzere tasarlanmıştır.
Not:
- Uygulama ilk açılışta otomatik olarak indirilecektir;
- Masaüstü uygulaması sürüm güncellemelerini otomatik olarak yönetir;
- Sistemi temiz tutmak için eski sürümleri otomatik olarak temizler;
- Bilgisayarınızda CLI sürümü yüklü olsa bile, yine kendi sürümünü kullanır (daha fazla stabilite için).
- Masaüstü sürümü stabilite ve uyumluluğa öncelik verir; CLI (komut satırı sürümü) daha hızlı güncellenebilir, ancak yeni özellikler masaüstü sürümüne hemen yansımayabilir.
6) Özel Ortam Değişkenleri
Claude Desktop, .env dosyalarındaki gibi değişkenler ayarlamanıza olanak tanır.
Bu değişkenler yalnızca Claude oturumu içinde geçerlidir ve proje yapılandırması için idealdir.
Örneğin:
API_KEY=abcd123
DEBUG=true
CERT="-----BEGIN CERT-----
MIIE...
-----END CERT-----"
7) Yerel araçlar ve ortamlarla entegrasyon
Yerel oturumlar çalıştırılırken masaüstü uygulaması kabuğunuzdaki $PATH değerini çıkarır; böylece oturum süreçleri, terminalde kullandığınız node, npm, yarn, Python veya diğer CLI araçlarını aynı şekilde kullanabilir. Ayrıca .env formatında özel ortam değişkenleri eklemek için bir UI sağlar; değerler güvenlik için maskelenir. Bu, ajan odaklı bir oturum içinde test veya derleme çalıştırmayı daha sorunsuz hale getirir; çünkü ajan, terminalinizle aynı araç zincirini çağırabilir.
Claude Code’u Masaüstüne nasıl kurarım?
Bu bölüm, minimum sürtünmeyle kurulum sürecini açıklar. Aşağıdaki talimatlar masaüstü önizlemesi için geçerlidir ve sizi kanonik yükleyicilere yönlendirir.
Önkoşullar ve hesap kurulumu
- Anthropic hesabı ve çalışma alanı: Claude Code, Anthropic Console ile entegredir. Claude Console’da bir OAuth akışını tamamlamanız ve Anthropic’in çalışma alanı modeline göre gerekli aktif faturalandırma veya araştırma önizleme erişimine sahip olmanız gerekir. Claude Code, kullanım takibi için konsolda dahili bir çalışma alanı kullanır; bu çalışma alanı için API anahtarları oluşturamazsınız — Claude Code kullanımı için yönetilir.
- Git ve depo hazırlığı: Git’in kurulu olduğundan ve üzerinde çalışmak istediğiniz projenin bir Git deposu olduğundan emin olun (ya da Git’i başlatın). Masaüstü uygulaması, worktree gibi özellikler için geçerli depolar bekler; Git başlatılmadan bir klasör açarsanız worktree oluşturulmaz.
- İS’e özgü hususlar: macOS ve Linux kurulumları genellikle yerel ikilerdir; Windows kullanıcılarına birçok iş akışında tam komut uyumluluğu için WSL kullanmaları önerilir. PATH veya dağıtım sorunlarıyla karşılaşırsanız bazı topluluk kılavuzları gelişmiş Windows/WSL kurulumlarını kapsar.
Adım adım kurulum (kısa)
- Claude İndirme sayfasını açın ve platformunuz için doğru yükleyiciyi seçin.
- Yükleyiciyi çalıştırın (macOS’ta PKG, Windows’ta MSIX veya EXE). Kurumsal filolar için merkezi dağıtım adına sağlanan MSIX/PKG paketlerini kullanın.
- Claude Desktop uygulamasını başlatın ve Anthropic/Claude hesabınızla oturum açın. Görüşmeleriniz ve tercihlerinizi masaüstü, web ve mobil arasında senkronize edilir.
- İlk açılışta uygulama paketlenmiş bir Claude Code çalışma zamanını indirecektir. Bu indirmeye izin verin; gereklidir ve kararlı, yönetilen bir sürümün kullanılmasını sağlar.
Kurulum sonrası kontroller
• Ayarlar > Ortamlar’ı açın ve masaüstü uygulamasının kabuğunuzdaki $PATH değerini çıkardığını doğrulayın.
• Makineniz ve politika izin veriyorsa yerel oturumları etkinleştirmek isteyip istemediğinizi veya çalışma akışınızın bunun yerine web oturumları oluşturup oluşturmayacağını seçin.
İsteğe bağlı kurulum yöntemleri
- Yerel yükleyici (önerilir): En basit ve en entegre deneyim için yerel İS yükleyicisini kullanın.
- Homebrew (macOS): Uygulamaları Homebrew ile yöneten macOS kullanıcıları için uygundur.
- NPM veya betik tabanlı yükleyiciler: Daha otomatik veya betiklenmiş kurulumlar (CI veya sağlama) için veya basit bir yükleyici betiğinin tercih edildiği Linux dağıtımlarında kullanışlıdır.
Kurulum: macOS, Linux, WSL (önerilen akış)
- Claude Code indirme sayfasından masaüstü önizleme yükleyicisini indirin (ürün içi belgeler yükleyici bağlantısını sağlar).
- Yükleyiciyi çalıştırın ve Claude masaüstü uygulamasını açın.
- Uygulama içi Claude Console akışı üzerinden OAuth ile oturum açmayı tamamlayın.
- Masaüstü ayarlarında varsayılan worktree konumunu ve yerel/uzak yürütme tercihlerini yapılandırın.
- Başlamak için bir proje klasörü açın veya UI üzerinden bir depo klonlayın.
Bir terminal açın ve kaynağa güveniyorsanız, Anthropic tarafından sağlanan kurulum betiğini çalıştırın (tipik önerilen kolaylık seçeneği). Örnek (parafraz):
# macOS / Linux / WSL (example convenience installer)
curl -fsSL https://claude.ai/install.sh | bash
Alternatif olarak, macOS’ta Homebrew tercih ediyorsanız:
brew install --cask claude-code
Kurulum: Windows
WSL:
- WSL’yi (Ubuntu yaygındır) kurun ve temiz bir WSL ortamı oluşturun. Masaüstü uygulamasının WSL entegrasyonunun dağıtıma erişebilmesini sağlamak için PATH ve birlikte çalışma sorunlarını çözün.
- WSL’ye Git ve Claude’un yerel çalıştırmalar için ihtiyaç duyabileceği dil çalışma zamanlarını (node, python vb.) kurun.
- Masaüstü uygulamasını Windows’ta kurun veya çalıştırın, uygulamayı WSL proje dizininize yönlendirin (ya da destekleniyorsa masaüstü uygulamasını WSL içinde başlatın) ve aynı OAuth akışını izleyin.
PowerShell örneği (parafraz):
# PowerShell (example convenience installer)
irm https://claude.ai/install.ps1 | iex
CMD örneği (parafraz):
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
Claude Code’u Masaüstünde günlük pratikte nasıl kullanırım?
Önerilen oturum oluşturma kalıpları nelerdir?
Kısa bağımsız görevler vs uzun soluklu yeniden düzenlemeler
- Kısa, kapsamlı görevler (hata düzeltmesi, tek dosya değişikliği, küçük yeniden düzenleme) için, görev başına bir oturum oluşturun ve Claude’un odaklı bir commit üretmesini sağlayın. Hızla gözden geçirip birleştirin.
- Uzun soluklu çabalar (büyük yeniden düzenlemeler, özellik geliştirme) için, sık sık kontrol noktası koyan ve masaüstü UI’nin ilerleme kontrollerini kullanarak çalışmayı yönlendiren veya duraklatan bir oturum oluşturmayı düşünün. Oturumları, yanlışlıkla birleştirmeleri önlemek için özellik dallarında tutun.
Depoda bir CLAUDE.md veya standart bir istem şablonu koruyun; oturumların nasıl yönlendirilmesi gerektiğini (bağlam, çalıştırılacak testler, stil kuralları) standartlaştırın. Bu uygulama değişkenliği azaltır ve Claude’un oturumlar arasında tutarlı sonuçlar üretmesine yardımcı olur. Birçok ekip, tahmin edilebilir ajan davranışını sağlamak için standart istemleri veya kılavuzları depo meta verilerinde saklar.
Bir oturum başlatma ve adlandırma
- Masaüstü uygulamasını açın ve bir depo seçin veya klonlayın.
- “New Session” (veya eşdeğeri) seçeneğine tıklayın ve oturuma açıklayıcı bir ad verin (ör.
bugfix/cs-142veyaadd-tests-login). Adlandırma, eşzamanlı oturumları UI’de ayırt etmenize yardımcı olur. - Yerel veya uzak yürütme modunu seçin, hedef dalı seçin (veya ajan yeni bir worktree’de bir dal oluştursun) ve oturumu başlatın. Uygulama, oturum için adanmış bir Git worktree’yi otomatik olarak oluşturur.
Ajana yön verme: istemler ve görevler
- Net, kapsamlı istemler kullanın. Örnek: “
AuthServiceiçin başarısız birim testini bul ve mevcut genel API’yi koruyacak bir düzeltme oluştur; testleri çalıştır ve sonuçları raporla.” - Artımlı görevler için Claude’dan önce bir plan üretmesini isteyin (kısa bir kontrol listesi), ardından belirli kod değişikliklerini adım adım talep edin. Artımlı ilerleme halüsinasyon riskini azaltır ve diff’lerin incelenmesini kolaylaştırır. Anthropic bu yaklaşımı en iyi uygulamalarda önerir.
İlerlemeyi izleme ve etkileşim
Ajan çalışırken masaüstü UI eylem günlüklerini ve diff’leri gösterir. Bir oturumu duraklatabilir, talimatları değiştirebilir veya devam eden bir işi iptal edebilirsiniz. Ajan düzenlemeler önerdiğinde UI dosya diff’lerini ve değişenlere ilişkin bir açıklamayı ortaya koyar. Önerilen diff’leri commit öncesi onaylayın, düzenleyin veya reddedin.
Commit, dal ve PR akışları
Değişiklikleri onayladıktan sonra masaüstü uygulaması, oturumun worktree dalına commit atabilir. Buradan origin’e push edebilir ve UI aracılığıyla bir pull request açabilirsiniz (GitHub erişimini yetkilendirdiyseniz). Her oturumun dalı, siz birleştirene kadar izole kalır; bu da insan incelemesini basitleştirir.
Git izolasyonu ve çoklu oturum paralelizmi gerçekte nasıl çalışır?
Git worktree’ler: izolasyon mekanizması
Anthropic’in masaüstü sürümü, dal başına ayrı çalışma dizinleriyle ilişkili depo çalışma dizini kopyaları oluşturmak için Git worktree’lerini kullanır. Worktree’ler tam klonlardan daha hafiftir — uygun yerlerde aynı .git meta verisini paylaşırlar ancak eşzamanlı düzenlemelerin çakışmasını veya oturumlar arası sızıntıları önlemek için bağımsız çalışma dizinleri sağlarlar. Masaüstü, bu otomatik olarak oluşturulan worktree’leri yapılandırılabilir bir dizine yerleştirir (varsayılan ~/.claude-worktrees). Bu tasarım, ajan odaklı işlemler için güvenli eşzamanlılığı mümkün kılar.
Neden worktree’ler, klonlara karşı
Worktree’ler, oluşturması daha hızlıdır ve aynı temel Git geçmişiyle ilişkilendirilmesi daha kolaydır; yine de oturumlar arası kirlenmeyi önlemek için gereken dosya sistemi ayrımını sağlar. Çoğu iş akışı için bu, birden fazla tam klona göre tercih edilir; ancak farklı bağımlılıklarla tamamen izole çalışma zamanlarına ihtiyacınız varsa ayrı bir klon veya konteyner yine de uygun olabilir.
Koordinasyon ve çakışma yönetimi
Her oturum izole bir dal/worktree üzerinde çalıştığı için çakışmalar minimize edilir. İki oturum aynı mantıksal kodu bağımsız olarak değiştirir ve daha sonra her ikisi de aynı hedef dala birleştirilirse, normal Git birleştirme çakışması yönetimi geçerli olur — ki bu doğru bir insan incelemesi ve çözüm noktasıdır. Anthropic’in modeli, commit’leri incelenebilir PR’lar olarak bilerek ortaya koyar; insanları birleştirme döngüsünde tutar.
Yaygın sorun giderme adımları ve sınırlamalar
Bir oturum başlatılamazsa veya takılırsa
- Depo erişim belirteçlerinin geçerli olduğundan ve hız sınırına takılmadığından emin olun.
- Worktree’ler dizini için yerel disk alanını ve izinleri kontrol edin (ör.
~/.claude-worktrees). - Hata mesajları için masaüstü uygulamasının günlüklerini inceleyin; uygulama genellikle bir tanılama görünümü veya günlük dosyası sunar.
Oturumlar birbirini kirletiyorsa
- Masaüstü uygulamasının ayrı worktree’ler oluşturduğunu doğrulayın (uygulama tercihlerinize ayarlanan worktree konumunu veya
~/.claude-worktreesdizinini inceleyin). - Paylaşılan durum görürseniz, en son masaüstü önizlemesini kullandığınızdan emin olun veya Anthropic’in belgelerine başvurun — bu sürüm özellikle oturum izolasyonunu ele alır.
Yok sayılan dosyalar oturumlarda mevcut değilse
Gerekli yok sayılan dosyaların (ör. .env) her worktree’ye güvenli şekilde kopyalanması için .worktreeinclude yapılandırmanıza (veya masaüstü UI’deki eşdeğerine) dosya adlarını ekleyin. Uygun gizli yönetimi olmadan sırları worktree’lerde depolamaktan veya ortaya çıkarmaktan kaçının.
Sonuç
Claude Code’un masaüstü önizlemesi, ajan odaklı kodlama araçlarının geliştirici iş akışlarına nasıl uyduğunda anlamlı bir evrimi temsil ediyor: aynı kod tabanında birden fazla ajanın çalışması gerektiğinde geliştiricilerin karşılaştığı birkaç pratik koordinasyon sorununu çözerken, yapay zekâ ajanlarının hızını ve anlatım gücünü korur. Tek geliştirici verimliliği için benimseyin veya bir ekipte birden fazla ajan görevini koordine etmek için kullanın; Git worktree’lerini, .worktreeinclude dosyasını ve yerel vs web oturumları ayrımını anlamak, masaüstü önizlemesiyle geçen ilk haftanızı çok daha verimli hale getirecektir.
Claude Code CLI’yı kullanmaya hazır mısınız? Ayrıntılı talimatlar için API kılavuzunu inceleyin.
Geliştiriciler Claude Opus 4.5 API vb. erişimini CometAPI üzerinden sağlayabilir; en son model sürümü her zaman resmi web sitesiyle güncellenir. Başlamak için, modelin yeteneklerini Playground içinde keşfedin ve ayrıntılı talimatlar için API kılavuzuna başvurun. Erişimden önce, lütfen CometAPI’ye giriş yaptığınızdan ve API anahtarını edindiğinizden emin olun. CometAPI resmi fiyattan çok daha düşük bir fiyat sunarak entegrasyonunuza yardımcı olur.
Ready to Go?→ Claude Opus 4.5 ücretsiz deneme !
Daha fazla ipucu, rehber ve yapay zekâ haberleri için bizi VK, X ve Discord üzerinden takip edin!