Claude Code Desktop Rehberi: Terminal Olmadan Paralel Oturumlar, Diff İnceleme ve Zamanlanmış Görevler

Claude Code'u çoğu kişi terminalde tanıdı. Oysa aynı motor Claude masaüstü uygulamasının Code sekmesinde de çalışıyor: yan yana oturumlar, satır satır yorum yazabildiğiniz bir diff görünümü, geliştirme sunucunuzu otomatik açan bir tarayıcı paneli, Git worktree'leriyle izole edilen paralel işler, bilgisayarınızda koşan zamanlanmış görevler ve computer use. Bu yazıda, Anthropic'in resmi Claude Code dokümantasyonuna dayanarak Desktop'ın Code sekmesini uçtan uca anlatıyorum. Terminal tarafını daha önce Claude Code kurulum rehberinde yazmıştım; burada Desktop'a özgü olanlara odaklanıyorum ve CLI ile farkları ayrı bir bölümde topluyorum.

Claude Code Desktop Nedir?

Claude masaüstü uygulaması üç sekmeden oluşur. Chat, dosya erişimi olmayan, claude.ai'ye benzer genel sohbet alanıdır. Cowork, siz başka işlerle uğraşırken görevleri arka planda bağımsız yürüten bir ajan ve Dispatch'in yaşadığı yerdir. Code ise yerel dosyalarınıza doğrudan erişen etkileşimli kodlama asistanıdır; izin moduna göre her değişikliği önerildiği anda onaylarsınız ya da Claude yaptıktan sonra gözden geçirirsiniz. Bu yazının konusu Code sekmesi.

Önemli bir ayrıntı: uygulama Claude Code'u kendi içinde barındırır; Code sekmesi için Node.js ya da CLI kurmanız gerekmez. Terminalde claude yazmak istiyorsanız CLI'yı ayrıca kurarsınız; iki araç aynı projede aynı anda çalışabilir, her biri kendi oturum listesini tutar. Code sekmesi ücretli bir plan gerektirir: Pro, Max, Team veya Enterprise.

Hangi Platformlarda Çalışır ve Nasıl Kurulur?

Desktop üç platformda sunuluyor:

  • macOS: Intel ve Apple Silicon için tek bir universal derleme.
  • Windows: x64 kurulum dosyası; ARM64 işlemciler için ayrı bir kurucu var.
  • Linux (beta): Ubuntu 22.04+ ve Debian 12+ üzerinde, x86_64 veya arm64 mimarisinde, apt ile. Fedora ve Arch gibi Debian tabanlı olmayan dağıtımlarda CLI kullanmanız önerilir.

macOS ve Windows'ta kurucuyu indirip çalıştırır, uygulamayı açıp Anthropic hesabınızla giriş yaparsınız. Linux'ta Anthropic'in apt deposunu eklemeniz gerekir; böylece güncellemeler sistemin normal paket güncellemeleriyle gelir:

# İmza anahtarını indir ve doğrula
sudo curl -fsSLo /usr/share/keyrings/claude-desktop-archive-keyring.asc https://downloads.claude.ai/claude-desktop/key.asc
gpg --show-keys /usr/share/keyrings/claude-desktop-archive-keyring.asc
# Beklenen parmak izi: 31DDDE24DDFAB679F42D7BD2BAA929FF1A7ECACE

# Depoyu kaydet ve paketi kur
echo "deb [arch=amd64,arm64 signed-by=/usr/share/keyrings/claude-desktop-archive-keyring.asc] https://downloads.claude.ai/claude-desktop/apt/stable stable main" | sudo tee /etc/apt/sources.list.d/claude-desktop.list
sudo apt update && sudo apt install claude-desktop

# Güncelleme ve kaldırma
sudo apt update && sudo apt upgrade
sudo apt remove claude-desktop

Linux betasında henüz olmayanlar: computer use, sesli dikte ve Debian tabanlı olmayan dağıtım desteği. Windows kullanıcıları için bir de WSL seçeneği var: Code sekmesi oturumu bir WSL 2 dağıtımının içinde çalıştırabilir; Claude Code süreci, araçlar ve git dağıtımın içinde, Linux yollarıyla çalışır. WSL 1 desteklenmez ve dağıtımda git kurulu olmalıdır. Depo dağıtımın dosya sisteminde duruyorsa bu yol tercih edilmeli; Windows tarafından erişmek yavaştır ve dosya izlemeyi bozar.

Giriş konusunda not: Desktop, claude.ai aboneliğiyle ya da organizasyonunuzun SSO'suyla giriş yapar. Console API anahtarını doğrudan kabul etmez; API anahtarıyla kimlik doğrulama için CLI gerekir.

İlk Oturum: Ortam, Klasör, Model ve İzin Modu

Code sekmesinde ilk mesajı göndermeden önce prompt alanında dört şey seçersiniz:

  1. Ortam (Environment): Local (kendi makineniz, doğrudan dosya erişimi), Cloud (Anthropic'in yönettiği altyapı; uygulamayı kapatsanız da devam eder), SSH (kendi sunucunuz, bulut VM'i veya dev container; Desktop ilk bağlantıda Claude Code'u uzak makineye otomatik kurar) veya Windows'ta WSL.
  2. Proje klasörü: Claude'un çalışacağı klasör ya da depo. Yeni başlıyorsanız iyi bildiğiniz küçük bir projeyle deneyin.
  3. Model: Gönder düğmesinin yanındaki açılır menüden; oturum sırasında değiştirilebilir.
  4. İzin modu: Claude'un ne kadar özerk davranacağı; bu da her an değiştirilebilir.

Sonra ne istediğinizi yazıp Enter'a basarsınız; dokümanın önerdiği ilk deneme "Find a TODO comment and fix it". Değişiklikler yapıldığında +12 -1 gibi bir gösterge belirir; ona tıklayıp diff görünümünü açarsınız.

Desktop'ta İzin Modları Nasıl Çalışır?

Mod seçici, CLI'daki permissions.defaultMode anahtarlarıyla birebir eşleşen beş modu sunar:

Desktop adı Ayar anahtarı Davranış
ManualdefaultDosya düzenlemeden ve komut çalıştırmadan önce sorar; diff'i kabul etmeden önce görürsünüz.
Accept editsacceptEditsDosya düzenlemelerini ve yaygın dosya sistemi komutlarını otomatik kabul eder; diğer terminal komutları için sorar.
PlanplanDosyaları okur, keşif komutları çalıştırır, sonra kaynak koda dokunmadan bir plan önerir.
AutoautoArka planda çalışan güvenlik sınıflandırıcısı riskli eylemleri engeller; soru sayısı düşer.
Bypass permissionsbypassPermissionsİzin istemi olmadan çalışır (belirli eylemler ve güvenlik sınıflandırıcıları hariç). Pro/Max'te Ayarlar anahtarı, Team/Enterprise'da organizasyon politikası gerekir.

Auto mode, Anthropic API'deki tüm kullanıcılara açık; Claude Opus 4.6+, Sonnet 4.6+ veya Fable modellerinden biri gerekir ve yöneticiler disableAutoMode yönetilen ayarıyla kapatabilir. Seçtiğiniz mod klasör başına hatırlanır; tek istisna Plan modudur, o yalnızca geçerli oturuma uygulanır. Dokümanın önerdiği akış: karmaşık işlere Plan modunda başlayıp yaklaşımı onaylattıktan sonra Accept edits ya da Manual'a geçmek. İzin kurallarının söz dizimini ve modların ayrıntısını izin kuralları rehberinde anlattım; buradaki kurallar Desktop'ta da aynen geçerli.

Kodla Çalışma: Prompt Kutusu, Bağlam ve Yönlendirme

Prompt kutusunda Enter mesajı gönderir; + düğmesi dosya ekleri, skill'ler, bağlayıcılar ve plugin'lere açılır. Durdurma düğmesi işi anında keser; ama bir düzeltme yazıp Enter'a basarsanız mesaj, çalışan eylemi kesmeden iletilir.

Bağlam eklemenin yolları:

  • @ ile dosya: @ yazıp dosya adını seçersiniz. Bu otomatik tamamlama yalnızca yerel ve SSH oturumlarında vardır; bulut ve WSL oturumlarında yoktur.
  • Ek dosyalar: Ek düğmesiyle ya da sürükle-bırak ile görsel, PDF ve diğer dosyalar. Ekran görüntüsü, tasarım taslağı veya referans doküman için idealdir.
  • Sağ tık menüsü: Sohbetteki, diff'teki veya dosya panelindeki herhangi bir yola sağ tıklayınca Attach as context, Open in (VS Code, Cursor, Zed gibi kurulu editörler), Show in Finder / Explorer ve Copy path seçenekleri çıkar.

Diff Görünümü ve Satır Yorumları

Claude değişiklik yaptıktan sonra diff görünümünde dosya dosya inceleme yaparsınız. Bir satıra tıklayınca yorum kutusu açılır; yorumları Cmd+Enter (macOS) veya Ctrl+Enter (Windows) ile gönderirsiniz ve Claude bunları okuyup düzeltir. Review code düğmesi ise Claude'dan commit öncesi kendi değişikliklerini değerlendirmesini ister. Bu inceleme bilerek dar tutulmuştur: derleme hataları, kesin mantık hataları, güvenlik açıkları ve bariz bug'lara bakar; stil, biçimlendirme, önceden var olan sorunlar ve linter'ın zaten yakalayacağı şeylerle ilgilenmez. Daha kapsamlı inceleme araçları için otomatik kod incelemesi rehberine bakabilirsiniz.

Uygulamanızı Önizleme: Browser Paneli ve launch.json

Desktop'ın en ayırt edici özelliği Browser paneli. Claude geliştirme sunucunuzu kendisi başlatır, uygulamayı panelde açar, ekran görüntüsü alır, DOM'u inceler, öğelere tıklar ve formları doldurur. Auto-verify açıkken her düzenlemeden sonra değişikliği kendisi doğrular. Sunucu açılır menüsünden sunucuları başlatıp durdurur, çerez ve local storage'ın kalıcı olması için Persist sessions anahtarını açar, yapılandırmayı düzenleyebilirsiniz.

Sunucu yapılandırması, oturumu başlattığınız klasörün kökündeki .claude/launch.json dosyasında durur. Claude bunu projeden otomatik türetir; ama bir üst klasörü seçtiyseniz alt klasörlerdeki sunucular otomatik algılanmaz, ya oturumu alt klasörde başlatır ya da yapılandırmayı elle eklersiniz. Dosya yorumlu JSON'u destekler:

{
  "version": "0.0.1",
  "autoVerify": false,
  "configurations": [
    {
      "name": "frontend",
      "runtimeExecutable": "npm",
      "runtimeArgs": ["run", "dev"],
      "cwd": "apps/web",
      "port": 3000,
      "autoPort": true
    },
    {
      "name": "api",
      "runtimeExecutable": "npm",
      "runtimeArgs": ["run", "start"],
      "cwd": "server",
      "port": 8080,
      "env": { "NODE_ENV": "development" },
      "autoPort": false
    }
  ]
}
Alan Anlamı
nameSunucunun benzersiz adı.
runtimeExecutable / runtimeArgsPaket yöneticisi üzerinden başlatma: npm + ["run", "dev"] → npm run dev.
program / argsDoğrudan node ile çalışan bağımsız script: "program": "server.js" → node server.js.
portSunucunun dinlediği port; varsayılan 3000.
cwdProje köküne göre çalışma dizini; ${workspaceFolder} kökü açıkça belirtir.
envEk ortam değişkenleri. Dosya depoya girdiği için buraya sır yazmayın; sırlar için yerel ortam düzenleyicisini kullanın.
autoPorttrue: port doluysa boş bir port bulur ve PORT değişkeniyle sunucuya iletir. false: hata verir (OAuth callback, CORS allowlist gibi sabit port gereken durumlar). Boş: Claude sorar ve cevabı kaydeder.
urlÖnizlemenin http://localhost:<port> yerine açacağı adres: yerel HTTPS, *.localhost alt alan adları, yönlendirmeyle giriş yapan uygulamalar. Komut vermeden yalnızca url yazarsanız zaten çalışan bir sunucuya bağlanır.

url için kurallar: localhost adresleri yalnızca origin'den oluşmalı, yol ya da sorgu içermemeli ve port girişin portuyla eşleşmeli; harici adresler yol içerebilir ama ilk seferde Desktop izin ister. Şema http veya https olmalı, kullanıcı adı ve şifre içermemelidir. Auto-verify'ı global kapatmak için dosyaya "autoVerify": false eklersiniz; proje başına kapatmak için sunucu menüsündeki anahtar yeterlidir.

Harici siteler ve güvenlik kontrolleri

Browser paneli sekmeli bir tarayıcıdır; dokümantasyon, issue tracker ve benzeri siteleri de açar. Cmd+Shift+B / Ctrl+Shift+B ile ya da Views menüsünden açılır. Sohbetteki bir bağlantıya tıklayınca Open in app ve Default browser seçenekleri çıkar; Cmd/Ctrl ile tıklamak doğrudan sistem tarayıcısında açar. Güvenlik tarafında iki katman var: güvenlik sınıflandırıcıları, izin modu ne olursa olsun Claude'un harici sayfalardaki yazma eylemlerini gözden geçirir; alan adı allowlist kontrolü ise Auto ve Bypass dışındaki modlarda yeni bir siteye gitmeden önce devreye girer. Claude bir harici sitede ilk kez eylem yapmak istediğinde Allow once, Always allow veya Deny kartı gelir; onay site başına (alt alan adları dahil) istenir, yerel geliştirme sunucuları ve proje dosyaları için istenmez.

Browser paneli ile Chrome eklentisi arasındaki fark şu: panel, kişisel tarayıcınızdan ayrı temiz bir profil kullanır; uygulama geliştirip test etmek için budur. Chrome eklentisi tarayıcınızın oturum bilgilerini paylaşır; Claude'un sizin adınıza giriş yapılmış hesaplarda çalışması gerektiğinde onu kullanırsınız. Chrome tarafını Chrome entegrasyonu rehberinde anlattım.

Pull Request Takibi: Auto-fix ve Auto-merge

Bir PR açıldığında oturumda bir CI durum çubuğu görünür. Auto-fix açıkken Claude başarısız CI kontrollerini kendisi düzeltmeye çalışır; Auto-merge açıkken tüm kontroller geçince PR'ı squash merge ile birleştirir (GitHub depo ayarlarında squash merge açık olmalı). CI bittiğinde bildirim gelir. Auto-archive after PR merge or close ayarı, PR kapanınca oturumu arşivler. Bunlar GitHub CLI'nin (gh) kurulu ve giriş yapılmış olmasını ister.

Çalışma Alanını Düzenleme: Paneller, Terminal, Dosya Düzenleyici

Code sekmesi sohbet, diff, tarayıcı, terminal, dosya, plan, tasks ve subagent panellerinden oluşur; macOS'ta bir de iOS Simulator paneli var. Panelleri başlığından sürükleyip yerini değiştirir, kenarından tutup boyutlandırır, Cmd+\ / Ctrl+\ ile odaktaki paneli kapatırsınız. Views menüsünden yeni panel açılır. Claude Desktop v1.2581.0 ve sonrasında bir paneli (örneğin diff'i veya terminali) kendi penceresine çıkarabilirsiniz; Claude ana pencerede çalışmaya devam eder. Bu, çok ekranlı kurulumlar için düşünülmüş.

  • Entegre terminal: Ctrl+` ile açılır, oturumun çalışma dizininde başlar ve Claude ile aynı ortamı paylaşır. Panel başlığındaki + ile ikinci sekme açılır. Yalnızca yerel oturumlarda vardır.
  • Dosya düzenleyici: Sohbetteki bir dosya yoluna tıklayınca açılır; küçük düzenlemeler yapıp Save dersiniz. Dosya siz açtıktan sonra diskte değiştiyse uyarı verir; Discard düzenlemeleri geri alır. HTML, PDF, görsel ve video yolları dosya paneli yerine Browser panelinde açılır. Yerel ve SSH oturumlarında kullanılabilir.
  • Görünüm modları: Normal (araç çağrıları özetlenmiş), Thinking (özetler + Claude'un düşünmesi) ve Verbose (her araç çağrısı, dosya okuması ve ara adım). Transcript view menüsünden seçilir ya da Ctrl+O ile döngüsel geçiş yapılır.
  • Kullanım halkası: Model seçicinin yanındaki halka, oturumun bağlam kullanımını ve plan kullanımını gösterir.

Klavye kısayolları

Cmd+/ (Windows'ta Ctrl+/) tüm kısayolları listeler. Windows'ta Cmd yerine Ctrl kullanılır; oturum geçişi, terminal ve görünüm modu kısayolları her platformda Ctrl ile çalışır. Terminaldeki etkileşimli mod kısayolları Desktop'ta geçerli değildir.

Kısayol Eylem
Cmd+N / Cmd+WYeni oturum / oturumu kapat
Ctrl+Tab / Ctrl+Shift+TabSonraki / önceki oturum
EscClaude'un yanıtını durdur
Cmd+Shift+DDiff panelini aç/kapat
Cmd+Shift+BBrowser panelini aç/kapat
Cmd+Shift+SBrowser'da bir öğe seç
Ctrl+`Terminal panelini aç/kapat
Cmd+\Odaktaki paneli kapat
Cmd+;Side chat aç
Ctrl+OGörünüm modları arasında geçiş
Cmd+Shift+M / I / Eİzin modu / model / effort menüsü
1–9Açık menüde öğe seç

Paralel Oturumlar ve Worktree İzolasyonu

Kenar çubuğundaki + New session ya da Cmd+N ile istediğiniz kadar oturum açar, Ctrl+Tab ile aralarında dolaşırsınız. Aynı depoda iki oturum aynı dosyalara dokunmasın diye dal adının yanındaki worktree seçeneğini işaretlersiniz: oturum, Git worktree ile izole bir kopyada çalışır ve değişiklikler commit edilene kadar diğer oturumları etkilemez. Worktree'ler varsayılan olarak <proje-kökü>/.claude/worktrees/ altında saklanır; konumu ve Claude'un açtığı dallar için bir ön ek Settings → Claude Code'dan ayarlanır. .env gibi gitignore'lanmış dosyaların worktree'ye kopyalanması için depo köküne bir .worktreeinclude dosyası eklersiniz. İzolasyon için Git kurulu olmalıdır.

Bir oturumu Cmd/Ctrl basılı tutarak tıklarsanız mevcut oturumun yanında ikinci bir panelde açılır. Bağlam dolduğunda /compact yazarak özetleme tetiklenir; bakmadığınız bir oturum işini bitirdiğinde masaüstü bildirimi gelir. Terminalde aynı işi --worktree bayrağı ve claude agents ekranı yapıyor; o tarafı Agent View rehberinde anlattım.

Side chat: oturumu raydan çıkarmadan soru sormak

Ana konuşmaya eklemeden bir şey sormak için Cmd+; / Ctrl+; ile ya da /btw yazarak side chat açarsınız. Side chat ana konuşmada o ana kadar geçenleri okuyabilir; kapattığınızda ana oturum kaldığı yerden sürer. Yerel, SSH ve WSL oturumlarında vardır, uygulama kapanınca saklanmaz.

Tasks paneli ve oturumlar arası çalışma

Tasks paneli geçerli oturumun arka plan işlerini gösterir: subagent'lar, arka plan kabuk komutları ve dynamic workflow'lar. Oturumlar arasında ise Claude'un kendisi köprü olur: Code sekmesindeki diğer oturumları listeler, ne yaptıklarını okur ve aralarında mesaj gönderir; "payments oturumuna şemanın değiştiğini söyle" gibi düz cümleler yeterli. Desktop yalnızca kendi çalıştırdığı yerel, SSH ve WSL oturumlarını görür; bulut, CLI ve VS Code oturumlarını görmez. Bir oturumu arşivlemeden önce her modda onay ister; gözetimsiz oturumlardan mesaj gönderemez; alıcı oturum crossSessionInbound ayarını refuse yapmışsa mesaj düşer. Ayrıntı cross-session messaging rehberinde.

Bulut Oturumları ve "Continue in"

Büyük refactor veya uzun test koşusu gibi işler için oturumu başlatırken Cloud seçersiniz. Bulut oturumları Anthropic'in yönettiği altyapıda koşar, uygulamayı kapatsanız da devam eder; ilerlemeyi claude.ai/code veya mobil uygulamadan izlersiniz. Deponun yanındaki + ile birden fazla depo eklenir. İzin modu olarak Accept edits, Plan ve Auto desteklenir; Manual, Accept edits olarak görünür; Bypass bulutta yoktur. Kullanım abonelik limitlerinden düşer, ayrı hesaplama ücreti yoktur. Özel ağ erişimi için Add cloud environment ile ortam tanımlanır. Bulut tarafını Claude Code on the Web rehberinde yazdım.

Oturum araç çubuğunun sağ altındaki Continue in menüsü iki yol sunar. Claude Code on the Web, yerel oturumu buluta gönderir: Desktop dalı push eder, bir özet üretir ve tam bağlamla yeni bir bulut oturumu açar; yerel oturumu arşivlemeyi ya da tutmayı seçersiniz. Çalışma ağacının temiz olması gerekir ve SSH oturumlarında bu seçenek yoktur. Your IDE ise projeyi desteklenen bir IDE'de geçerli çalışma dizininde açar.

Bağlayıcılar, Skill'ler ve Plugin'ler

Kenar çubuğundaki Customize, bağlayıcıları, skill'leri ve plugin'leri tek yerden yönetir; ayarlar ~/.claude yerine claude.ai hesabınız üzerinden eşitlenir ve aynı hesaplı terminal oturumları da bunları yükler.

  • Bağlayıcılar (connectors): Yerel ve SSH oturumlarında + → Connectors. Google Calendar, Slack, GitHub, Linear, Notion ve daha fazlası. Teknik olarak bunlar grafik kurulum akışı olan MCP sunucularıdır; listede olmayan servisler için MCP sunucusunu ayar dosyalarından elle eklersiniz. Bulut ve WSL oturumlarında + düğmesi yoktur; bulutta bağlayıcılar routine oluşturulurken tanımlanır. MCP'nin temellerini MCP rehberinde anlattım.
  • Skill'ler: Prompt kutusuna / yazarak ya da + → Slash commands ile yerleşik komutlar, kendi skill'leriniz, projedeki skill'ler ve plugin skill'leri listelenir. Yerel oturumlar ~/.claude/skills/ dizininden okur; SSH oturumu uzak makinenin ev dizinindeki aynı yola bakar. Bulut oturumları ise ~/.claude/skills/ yerine claude.ai hesabında etkin skill'leri yükler. Bir komutu Claude çalışırken de gönderebilirsiniz; v2.1.206 öncesinde bu, oturumu "çalışıyor" görüntüsünde bırakan bir hataya yol açıyordu.
  • Plugin'ler: + → Plugins ile terminal gerekmeden kurulur; Add plugin yapılandırılmış marketplace'leri açar, Manage plugins etkinleştirme ve kaldırma yapar. Kapsam kullanıcı hesabı, belirli proje veya yalnızca yerel olabilir. Plugin tarayıcı bulut oturumlarında yoktur; Desktop'tan kurulan plugin'ler bulut oturumlarına gitmez; bulut oturumu deponun .claude/settings.json dosyasında bildirilen plugin'leri de kurmaz; WSL oturumlarında plugin'ler kullanılamaz.

Zamanlanmış Görevler: Claude'u Bilgisayarınızda Takvime Bağlamak

Desktop'ın Routines sayfası iki tür iş oluşturur: bilgisayarınızda koşan yerel zamanlanmış görevler ve bulutta koşan uzak routine'ler. Yerel görev, dosyalarınıza ve araçlarınıza doğrudan erişir ama yalnızca uygulama açık ve bilgisayar uyanıkken tetiklenir; uzak routine bilgisayar kapalıyken de çalışır ve API çağrısı ya da GitHub olayıyla tetiklenebilir. Üç zamanlama seçeneğinin karşılaştırması:

Bulut (Routines) Desktop (yerel görev) /loop
Nerede koşarBulutMakinenizMakineniz
Makine açık olmalı mıHayırEvetEvet
Açık oturum gerekir miHayırHayırEvet
Yerel dosyalara erişimHayır (temiz klon)EvetEvet
İzin istemleriYok (otonom)Görev başına ayarlanırOturumdan miras
En kısa aralık1 saat1 dakika1 dakika

Görev oluşturmak için Code sekmesinde Routines → New routine → Local. Dört alan var: Name (kebab-case'e çevrilir ve diskte klasör adı olur), Description, Instructions (izin modu ve model seçicileri burada, altında çalışma klasörü ve worktree anahtarı) ve Schedule. Klasör zorunludur. Hazır seçenekler Manual (yalnızca Run now ile), Hourly, Daily, Weekdays ve Weekly; seçicide olmayan aralıkları herhangi bir oturumda düz dille istersiniz: "schedule a task to run all the tests every 6 hours". Yerel görevler Claude Desktop 1.1.5368 öncesinde yoktur.

Çalışma mantığı: Desktop uygulama açıkken zamanlamayı her dakika kontrol eder ve saati gelen görev için yeni bir oturum başlatır. API trafiğini dağıtmak için her göreve birkaç dakikalık deterministik bir gecikme eklenir. Tetiklenen görev kenar çubuğunda Scheduled bölümünde görünür. Varsayılan olarak görev çalışma dizininin o anki durumuna, commit edilmemiş değişiklikler dahil, karşı çalışır; izolasyon için oluştururken worktree anahtarını açarsınız. Bilgisayar uyuyorsa çalıştırma atlanır; Keep computer awake ayarı boşta uyumayı engeller ama kapağı kapatmak yine uyutur.

Kaçırılan çalıştırmalar için net bir kural var: uygulama açıldığında ya da bilgisayar uyandığında Desktop son yedi güne bakar, kaçırılan en yeni çalıştırma için tek bir telafi başlatır, eskilerini atar. Altı gün kaçırmış günlük bir görev uyanışta bir kez çalışır. Bu yüzden zamanlama önemliyse prompt'a koruma yazın: "Only review today's commits. If it's after 5pm, skip the review and just post a summary of what was missed."

İzinler görev başınadır. ~/.claude/settings.json içindeki allow kuralları da uygulanır. Manual moddaki bir görev izni olmayan bir araca ihtiyaç duyarsa çalıştırma siz onaylayana kadar bekler; oturum kenar çubuğunda açık kalır. Bunu önlemek için görevi oluşturduktan sonra Run now deyip gelen istemlerde "always allow" seçersiniz; sonraki çalıştırmalar aynı araçları sormadan onaylar. requiresUserInteraction işaretli MCP araçları her çağrıda sorar ve always-allow seçeneği sunmaz. Görevin ayrıntı sayfasında Run now, Active/Paused durumu, Edit, atlanan çalıştırmaların nedeniyle birlikte geçmiş, Always allowed paneli ve Delete vardır; silme sırasında Also delete files on disk kutusu görevin SKILL.md dosyasını ve verisini de kaldırır. Prompt diskte ~/.claude/scheduled-tasks/<görev-adı>/SKILL.md içinde durur; YAML frontmatter'da name ve description, gövdede prompt. Zamanlama, klasör, model ve etkinlik durumu bu dosyada değildir. Çalışan bir görev update_scheduled_task MCP aracıyla kendi zamanlamasını ya da prompt'unu değiştirebilir; örneğin bir release dalı açıldığını fark eden kod incelemesi kendini daha erkene alabilir.

Computer Use: Claude'un Uygulamaları Kullanması

Computer use, Claude'un uygulama açmasına, ekranı görmesine ve tıklayıp yazmasına izin verir. macOS ve Windows'ta araştırma önizlemesidir, Pro ve Max planı ister, Team ve Enterprise'da yoktur ve masaüstü uygulamasının çalışıyor olması gerekir. Varsayılan olarak kapalıdır: Settings → General altındaki Computer use anahtarını açarsınız; macOS'ta ayrıca Accessibility (tıklama, yazma, kaydırma) ve Screen Recording (ekranı görme) izinleri verilir. macOS'ta bir de arka plan modu var: Claude onaylı uygulamalarda çalışırken siz işinize devam edersiniz.

Claude en hassas aracı önce dener: bağlayıcı, sonra Bash, sonra Claude in Chrome, sonra iOS Simulator paneli; computer use en son çaredir. Bir uygulamaya ilk kez ihtiyaç duyduğunda Allow for this session ya da Deny istemi çıkar; onaylar oturum boyunca, Dispatch'in başlattığı oturumlarda 30 dakika sürer. Uygulamalar değiştiremeyeceğiniz sabit kademelere ayrılmıştır:

Kademe Claude ne yapabilir Hangi uygulamalar
View onlyEkran görüntüsünde görürTarayıcılar, alım-satım platformları
Click onlyTıklar, kaydırır; yazmaz, kısayol kullanmazTerminaller, IDE'ler
Full controlTıklar, yazar, sürükler, kısayol kullanırDiğer her şey

Settings → General altındaki Denied apps listesindeki uygulamalar sormadan reddedilir; Unhide apps when Claude finishes ise Claude'un gizlediği pencereleri iş bitince geri getirir.

Yerel Oturumlarda Ortam Değişkenleri

Desktop, kabuk ortamınızı tam olarak miras almaz. macOS'ta Dock'tan başlatılan uygulama ~/.zshrc ve ~/.bashrc dosyalarını yalnızca PATH ve sabit Claude Code değişkenleri için okur. Windows'ta sistem değişkenleri alınır ama PowerShell profilleri okunmaz. Değişken tanımlamak için ortam menüsünde Local üzerine gelip dişli simgesine tıklarsınız; buraya yazılanlar şifreli saklanır ve her yerel oturum ile önizleme sunucusuna uygulanır. ~/.claude/settings.json içindeki env anahtarı yalnızca Claude oturumlarına ulaşır, geliştirme sunucularına değil.

Thinking konusunda: extended thinking varsayılan olarak açıktır. Anthropic API'de MAX_THINKING_TOKENS değişkenini 0 yaparak kapatabilirsiniz; ancak bu Opus 5.5 ve Fable modellerinde etkisizdir, onlar her zaman thinking kullanır. Adaptive reasoning'li modellerde 0 dışındaki değerler yok sayılır. Opus 4.6 ve Sonnet 4.6'da sabit bütçe için CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING=1 kullanılır; Fable, Sonnet 5 ve Opus 4.7+ her zaman adaptive çalışır. Model ve effort ayrıntıları için Opus 5.5 rehberine bakın.

SSH Oturumları

Kod bir bulut VM'inde veya dev container'daysa Desktop'ı arayüz olarak kullanıp Claude Code'u uzak makinede çalıştırırsınız. Ortam menüsünden + Add SSH connection seçilir; Name, SSH Host (user@hostname ya da ~/.ssh/config'teki bir host), SSH Port (boşsa 22) ve Identity File istenir. Uzak makine Linux veya macOS olmalıdır; Desktop ilk bağlantıda Claude Code'u oraya kurar. Yöneticiler sshConfigs ile hazır bağlantılar dağıtır, sshHostAllowlist ile host'ları kısıtlar; boş dizi SSH'ı tamamen kapatır. Bu allowlist yalnızca yönetilen ayarlardan okunur ve Bash aracıyla çalıştırılan ssh komutlarını kısıtlamaz.

Kurumsal Yapılandırma

Team ve Enterprise planlarında davranış yönetici konsolu, yönetilen ayarlar ve cihaz yönetimiyle kontrol edilir. Konsolda Desktop'ta Code erişimi, bulut oturumları, Remote Control ve Bypass modu açılıp kapatılır. Yönetilen ayarlardan Desktop'a özgü olanlar:

Anahtar Etkisi
permissions.disableBypassPermissionsMode"disable" ile Bypass modunu engeller
disableAutoMode"disable" ile Auto modunu seçiciden kaldırır
browserExternalPageTools"disabled" ile harici sayfalarda araç kullanımını kapatır
disableBrowserExternalNavigationtrue ile Browser panelinde harici gezinmeyi tamamen kapatır
disableDesktopLocalSessionstrue ile cihazda yerel oturumları kapatır (v1.37937.0+); Local ve WSL gri görünür, yeni oturumlar ilk SSH bağlantısına düşer
sshConfigs / sshHostAllowlistHazır SSH bağlantıları / izinli host desenleri

Ayar önceliği CLI ile aynıdır. Yerel oturumlar diskteki yönetilen ayar dosyasını okur; bulut oturumları Anthropic VM'lerinde koştuğu için sunucu yönetimli ayarları alır; SSH oturumları uzak makinedeki yönetilen ayarları okur. Cihaz yönetimi için macOS'ta com.anthropic.claudefordesktop tercih alanı, Windows'ta SOFTWARE\Policies\Claude kayıt defteri yolu kullanılır.

CLI'dan Geliyorsanız: Ne Aynı, Ne Farklı?

Desktop ve CLI aynı motoru çalıştırır ve aynı dosyaları okur: projedeki CLAUDE.md ve CLAUDE.local.md, ~/.claude.json ile .mcp.json içindeki MCP sunucuları, ayarlardaki hook'lar ve skill'ler, ~/.claude/settings.json içindeki izin kuralları. İki geçiş yolu var: terminalde /desktop yazarsanız oturum kaydedilir, uygulamada açılır ve CLI kapanır (macOS ve x64 Windows'ta, aboneliğle; API anahtarı, Bedrock, Agent Platform ve Foundry ile değil). Tersine, Desktop'ın prompt kutusuna /resume yazınca terminal oturumları listelenir; başlık, klasör veya dala göre arayıp seçtiğiniz oturum tam bağlamıyla devam eder.

CLI Desktop karşılığı
--model sonnetGönder düğmesinin yanındaki model menüsü
--resume, --continueKenar çubuğunda oturuma tıklamak ya da /resume
--permission-modeMod seçici
--dangerously-skip-permissionsBypass permissions modu (Pro/Max'te Ayarlar anahtarı; Team/Enterprise'da politika)
--allowedTools, --disallowedToolsOturum başına karşılığı yok; ayar dosyalarındaki kurallar geçerli
--verboseVerbose görünüm modu
--print, --output-formatYok; Desktop yalnızca etkileşimli
--worktreeOturum başlangıcındaki worktree seçeneği
MAX_THINKING_TOKENSYerel ortam düzenleyicisi

Desktop'ta olmayanlar: üçüncü taraf sağlayıcılar (gateway ya da Claude Desktop on 3P dağıtımları gerekir), Linux'ta computer use, satır içi otomatik tamamlama, agent teams ve terminal diyaloğu açan komutlar: argümansız /permissions "isn't available in this environment" der, /config ise Settings → Claude Code'u açar. Desktop'ın CLI'da olmayanları: dosya ekleri, otomatik tamamlamalı @ bahsetme, sekmeli oturumlar, plugin yöneticisi arayüzü, Dispatch oturumları, iOS Simulator paneli ve yerel zamanlanmış görevler.

MCP tarafında bir özel durum: Desktop, sohbet uygulamasının claude_desktop_config.json dosyasındaki MCP sunucularını da yerel Code oturumlarına yükler ve aynı isimli sunucuda bu dosya kazanır. Bağımsız CLI bu dosyayı okumaz; macOS ve WSL'de claude mcp add-from-claude-desktop sunucuları ~/.claude.json'a kopyalar.

Gerçek Dünya Senaryosu: Bir Web Uygulamasında Hata Düzeltme ve PR

Diyelim ki Next.js tabanlı bir uygulamada ödeme formunda bir doğrulama hatası var ve iki iş paralel yürüyecek: hata düzeltmesi ve bir bağımlılık güncellemesi. Desktop'ta akış şöyle kurulur:

  1. İki oturum, iki worktree. Cmd+N ile iki oturum açıp ikisinde de worktree seçeneğini işaretlersiniz; işler aynı çalışma ağacında çakışmaz. Bağımlılık oturumuna Plan modunda "Update the dependencies in package.json to their latest minor versions and list breaking changes" dersiniz; planı okuyup Accept edits'e geçirirsiniz.
  2. Hatayı tarayıcıda yakalamak. Hata oturumunda Accept edits modunda "Reproduce the validation bug on the checkout form and fix it" yazarsınız. Claude launch.json'a göre dev sunucuyu başlatır, Browser panelinde formu doldurur, hatayı ekran görüntüsüyle doğrular, düzeltmeyi yapar ve auto-verify açıksa değişikliği panelde tekrar dener.
  3. Diff'i yorumlamak. +12 -1 göstergesine tıklayıp diff'i açarsınız. Regex'in fazla gevşek olduğu satıra tıklayıp yorum yazar, Cmd+Enter ile gönderirsiniz. Claude revize eder. Review code ile kendi değişikliğini bir kez de kendisi tarar.
  4. Terminalden doğrulama. Ctrl+` ile terminali açıp npm test çalıştırırsınız; aynı dosyaları Claude ile paylaşıyorsunuz, ek kurulum yok.
  5. PR ve CI. "Commit and open a PR" dediğinizde gh kurulu olduğu için PR açılır, CI çubuğu belirir. Auto-fix açıksa kırmızı kontrolü Claude düzeltir; Auto-merge açıksa tüm kontroller geçince squash merge yapılır ve Auto-archive açıksa oturum kendini arşivler.
  6. Tekrarlayan kısmı takvime bağlamak. Bağımlılık denetimini her Pazartesi tekrarlamak için Routines → New routine → Local ile haftalık bir görev kurar, Run now deyip çıkan istemlerde "always allow" seçersiniz. Bilgisayar kapalıyken de çalışması gerekiyorsa bunu yerel görev yerine bulut routine'i olarak tanımlarsınız.

Sorun Giderme

  • Sürümü bulmak: macOS'ta Claude menüsü → About Claude, Windows'ta Help → About. Sürüm numarasına tıklamak panoya kopyalar.
  • Code sekmesinde 403 veya kimlik doğrulama hatası: Uygulama menüsünden çıkış yapıp yeniden girin (en yaygın çözüm), aboneliğin etkin olduğunu ve internet bağlantısını kontrol edin, araya giren tarayıcı eklentilerini kapatın.
  • Linux'ta "Unable to locate package claude-desktop": Depoyu ekledikten sonra sudo apt update çalıştırın; cat /etc/apt/sources.list.d/claude-desktop.list ile deb satırını doğrulayın; dpkg --print-architecture amd64 ya da arm64 yazmalı.
  • WSL oturumunda eksik özellikler: Entegre terminal, bağlayıcılar ve plugin'ler, oturum çatallama, dosya paneli ve @ önerileri WSL'de henüz yok.
  • Zamanlanmış görev takılı kalıyor: Manual modda izni olmayan bir araç bekliyordur. Görevin ayrıntı sayfasındaki oturumu açıp onaylayın, kalıcı çözüm için Run now ile "always allow" verin.

Sıkça Sorulan Sorular

Claude Code Desktop için ayrıca CLI veya Node.js kurmam gerekir mi?

Hayır. Uygulama Claude Code motorunu kendi içinde taşır; Code sekmesi için Node.js ya da claude komutu gerekmez. Terminalde de kullanmak istiyorsanız CLI'yı ayrıca kurarsınız; ikisi aynı projede yan yana çalışır ve CLAUDE.md, settings.json, MCP yapılandırması gibi dosyaları paylaşır. Ücretli plan (Pro, Max, Team, Enterprise) şarttır.

Desktop'ta hangi izin modları var ve CLI'dan farkı ne?

Manual (default), Accept edits (acceptEdits), Plan (plan), Auto (auto) ve Bypass permissions (bypassPermissions; Pro/Max'te Ayarlar anahtarı, Team/Enterprise'da politika). CLI'daki dontAsk modunun karşılığı yok. Mod klasör başına hatırlanır, Plan hariç. Bulutta Accept edits, Plan ve Auto desteklenir; Manual, Accept edits olarak görünür; Bypass yoktur.

Zamanlanmış görevler bilgisayarım kapalıyken çalışır mı?

Hayır. Yerel görevler yalnızca uygulama açık ve bilgisayar uyanıkken tetiklenir. Uyuyorsa çalıştırma atlanır; uyanınca son yedi günün kaçırılan çalıştırmaları için yalnızca en yenisine tek bir telafi yapılır. Bilgisayar kapalıyken de koşması gereken işler için bulut Routines kullanın.

Terminalde başladığım bir oturumu Desktop'ta sürdürebilir miyim?

Evet. Terminalde /desktop yazarsanız oturum uygulamada açılır ve CLI kapanır (macOS ve x64 Windows, aboneliğle). Ya da Desktop'ın prompt kutusuna /resume yazıp terminal oturumları arasından seçersiniz; konuşma ve bağlam olduğu gibi gelir.

Desktop'ta Amazon Bedrock veya Google Cloud gibi üçüncü taraf sağlayıcıları kullanabilir miyim?

Varsayılan olarak hayır; Desktop doğrudan Anthropic API'sine bağlanır ve Console API anahtarını kabul etmez. Bedrock, Google Cloud Agent Platform ve Microsoft Foundry doğrudan desteği CLI, VS Code ve JetBrains'tedir. Desktop için gateway yönlendirmesi ya da Anthropic'in Claude Desktop on 3P dokümanındaki dağıtımlar gerekir.

Computer use özelliği Desktop'ta kimlere açık?

macOS ve Windows'ta araştırma önizlemesi olarak Pro ve Max planlarına; Team, Enterprise ve Linux betasında yok. Varsayılan kapalı; Settings → General'daki anahtar açılır, macOS'ta Accessibility ve Screen Recording izinleri verilir. Uygulama başına oturumluk onay istenir ve her uygulama View only, Click only veya Full control kademesine sabit atanır.

Özet

Claude Code Desktop, terminaldeki motorun aynısını görsel bir arayüzle sunar ve birkaç şeyi CLI'dan daha iyi yapar: yan yana oturumlar ve worktree izolasyonu, satır yorumlu diff incelemesi, geliştirme sunucusunu otomatik açıp doğrulayan Browser paneli, PR sonrası Auto-fix ve Auto-merge, bilgisayarınızda koşan zamanlanmış görevler ve macOS/Windows'ta computer use. Local, Cloud, SSH ve WSL ortamları arasında seçim yapar; /desktop ve /resume ile CLI oturumlarınızı taşırsınız; CLAUDE.md, ayarlar ve MCP yapılandırması iki tarafta ortaktır. Buna karşılık --print ile betikleme, üçüncü taraf sağlayıcılar ve agent teams CLI'da kalır. Kısa karar kuralı şu: paralel oturumları bir pencerede yönetip değişiklikleri görsel olarak incelemek istiyorsanız Desktop; otomasyon, CI ve terminal odaklı iş akışları için CLI.

Devam okumaları için: bulut oturumları ve Routines'i Claude Code on the Web rehberinde, yerel oturumu telefondan yönetmeyi Remote Control rehberinde, terminal tarafındaki çoklu oturum yönetimini ise Agent View rehberinde bulabilirsiniz. Tüm Claude Code yazıları Yazılar sayfasında.

Bu yazı Ahmet Bilgiç tarafından ahmetbilgic.com için yazılmıştır. Diğer yazılar için: medium.com/@ahmet_bilgic07