VS Code’da Claude Code: Uzantı Nasıl Kullanılır

Yetenekler bölümünde ele aldığım gibi, plan modu daha büyük değişikliklerde iyi çalışır. Orada atladığım bir ayrıntı: Claude önce keşif komutlarını da çalıştırır ve tam planı bir dosyaya kaydeder. Herhangi bir şey yazılmadan önce yorumlarınızı ekleyin. Planı yazılı görmek, sonunda çoğunu değiştirmiş olsam bile faydalı oluyor.

Hedefli bağlam için satır aralıklarıyla @-bahsetmeler kullanın: @app.ts#5-10 Claude’u belirli bir bölgeye odaklar. Dosyaları istem kutusuna sürüklerken Shift tuşunu basılı tutmak, onları ek dosya olarak ekler. Mac’te Option+K (Windows ve Linux’ta Alt+K) geçerli dosyanız ve seçiminiz için doğrudan bir @-bahsetme ekler.

Bilmeniz gereken VS Code klavye kısayolları

Bu kısayollar Anthropic’in VS Code uzantı dokümanlarından alınmıştır ve panelde en sık başvurduğum kısayolları kapsar.

İzin modu döngüsü hâlâ CLI’da: tümleşik terminalde Shift+Tab tuşuna basarak varsayılan, plan ve accept-edits modları arasında geçiş yapın. Tam slash-komut seti için Claude Code slash komutları rehberimize bakın.

Kontrol noktaları, oturum boyunca Claude’un dosya düzenlemelerini izler. Sohbetteki herhangi bir iletinin üzerine gelerek geri sar düğmesini görün. Seçenekler: kod değişikliklerini korurken sohbeti çatallamak, sohbet geçmişini korurken kodu geri sarmak veya her ikisini yapmak. Kontrol noktaları 30 gün boyunca kalır. Bash komutlarını izlemez: rm, mv ve cp kontrol noktası sisteminin dışındadır. Yıkıcı işlemler için güvenlik ağı yine git’tir.

VS Code’da Claude Code ile Hata Ayıklama ve Yeniden Düzenleme

Her iki iş akışı da aynı adımları izler: Claude’a bağlam verin, önerilen değişikliği inceleyin, sonucu doğrulayın. Zor olan kısım, her birinde doğru bağlamı toplamaktır.

Hata ayıklama

Hatayı doğrudan yapıştırarak, @terminal:name ile terminal çıktısına atıfta bulunarak veya Claude’un mcp__ide__getDiagnostics üzerinden Sorunlar panelinden veri çekmesine izin vererek paylaşın. Claude kök nedeni izler, diff olarak bir düzeltme önerir ve siz testlerinizi çalıştırarak doğrularsınız.

Claude Code, VS Code’un yerel hata ayıklayıcısıyla entegre değildir: kesme noktaları yok, adım adım yürütme yok, canlı değişkenler yok. Hata yapıştırma ve tanılama yolu çoğu durumu karşılar. Özellikle hata ayıklayıcıya ihtiyacınız varsa, aradaki boşluğu kapatan bir topluluk MCP sunucusu (GitHub’da claude-debugs-for-you) vardır ancak kendi kurulumunu gerektirir.

Canlı web hata ayıklama için @browser Claude’u Chrome için Claude uzantısı (1.0.36 veya üstü) aracılığıyla Chrome’a bağlar. @browser go to localhost:3000 and check the console for errors gibi bir istem, pencereler arasında geçiş yapmadan Claude’un canlı tarayıcı durumunu incelemesine izin verir.

Yeniden düzenleme

Claude dosyalar arası eşgüdümlü değişiklikleri iyi yönetir: geniş bir kod tabanında bir fonksiyonu yeniden adlandırma, bir kütüphaneden diğerine geçiş. Dizaynı pervasızlıktan koruyan, diff inceleme adımıdır.

Burada CLAUDE.md dosyası, yazının herhangi bir başka yerinden daha çok önem taşır. Projeye özgü gelenekler yüklenmeden Claude, kod tabanından çıkardığı kalıplara varsayar ki bu, gerçekte istediğinizle uyuşmayabilir. Kurulum bölümünde belirttiğim gibi, /init size bir başlangıç dosyası verir; büyük bir yeniden düzenleme oturumundan önce bunu on dakika ayırıp iyileştirmeye değer.

Bağlam sıkıştırma, uzun oturumların pratik sınırıdır. Bağlam penceresi dolduğunda, Claude daha eski konuşmaları özetleyerek otomatik sıkıştırma yapar. Bundan sonra, önceki kararları gözden kaçırabilir. Yeni bir aşamaya başlamadan önce /compact komutunu elle çalıştırmak, görev ortasında otomatik sıkıştırmanın devreye girmesini beklemekten daha öngörülebilir sonuçlar verir.

VS Code’da Claude Code vs. Terminal İş Akışı

Anthropic’in dokümanları, VS Code uzantısını "VS Code’da Claude Code’u kullanmanın önerilen yolu" olarak adlandırır. Uzantı, terminalin sağlayamadığı şeyleri ekler: yan yana diff görüntüleyici, düzenleyebileceğiniz bir markdown belgesinde plan incelemesi, ayrı sekmelerde birden çok sohbet ve canlı web hata ayıklama için @browser.

Terminal ise yetenek tarafında kazanır. ! bash kısayolu, sekme tamamlama, tam slash komut seti ve tail -200 app.log | claude -p "..." gibi boru tabanlı iş akışları yalnızca CLI’dadır. MCP sunucu yapılandırması da yalnızca terminaldedir. Uzantıdan mevcut sunucuları /mcp ile yönetebilirsiniz ancak yenilerini ekleyemezsiniz.

İkisi birbirini dışlamaz. VS Code’un tümleşik terminalinde claude çalıştırmak hâlâ IDE entegrasyonu sağlar: diff görüntüleme, seçim bağlamı paylaşımı ve tanılama paylaşımı oradan da çalışır. Uzantıda başlatılan oturumlar, terminalde claude --resume ile sürdürülebilir. CLI’yı VS Code diff görüntüleyicisine ve tanılama köprüsüne bağlanmaya zorlamak istediğinizde tümleşik terminalden claude --ide çalıştırın.

Çoğu geliştirici her ikisini de kullanır: çoklu dosya işleri ve dikkatli inceleme için VS Code, hızlı görevler ve otomasyon için terminal. Bazıları her şey için terminalde kalır ve doğrusu bu da gayet iyi çalışır. VS Code yerine Cursor tercih ediyorsanız, Cursor’da Claude Code rehberimiz aynı uzantı iş akışını orada da kapsar. Tam CLI iş akışımız da her hâlükârda bilinmeye değerdir.

VS Code’da Claude Code vs. GitHub Copilot

Başta belirttiğim gibi, "VS Code’da Claude", yerel uzantı, GitHub Copilot model seçici üzerinden Claude’a erişim veya tümleşik terminalde CLI anlamına gelebilir. Yerel uzantı ve Copilot aynı modeli paylaşır ama aynı ürün değildir; ikisi çok farklı çalışır.

Copilot üzerinden Claude modeli, GitHub’ın sohbet ve tamamlama paradigması içinde çalışır: yerel işletim sistemi alanı (sandbox) yoktur, özel MCP entegrasyonları yoktur, yerel terminal komutları yoktur. Claude Code uzantısı üzerinden ise aynı model 1M token’a kadar bağlam penceresiyle çalışır, dosyalar arasında görevler yürütür ve kontrol noktalarına, plan moduna ve MCP sunucularına erişir.

Araçlar farklı işler için tasarlanmıştır. Copilot’un çekirdek özelliği satır içi otomatik tamamlamadır. Claude Code hiç otomatik tamamlama yapmaz. Copilot’un aracı modu önemli ölçüde gelişti ancak topluluk kıyaslarında çok sayıda dosyayı kapsayan görevlerde genellikle geride kalır. Hiçbiri doğası gereği daha iyi değildir.

Yerel uzantı ve Copilot: aynı model, farklı deneyim. Görsel: Yazar.

Fiyatlandırma hakkında: Copilot Pro aylık 10$ ve 300 premium istek sunar. Claude Code Pro 20$/ay’dır. Her ikisini kullanan geliştiriciler arasında yaygın bir desen, Copilot için 10$ (yazarken otomatik tamamlama) ve Claude Code için 20$ (daha düşünülmüş, daha büyük ölçekli görevler) şeklindedir. İki ürün, iş akışının farklı kısımlarını fazla örtüşme olmadan kapsar. Anthropic ayrıca Copilot içine Claude modellerini yerleştirmek üzere GitHub ile ortaklık yaptı; bu da otomatik tamamlama tarafını ele alır.

Güvenlik ve Gizlilik Hususları

Anthropic, kodunuzu Claude modellerini eğitmek için kullanmaz. Ücretsiz, Pro ve Max kullanıcıları hesap ayarlarından veri günlüğe kaydetmeyi devre dışı bırakabilir; Team, Enterprise ve API planları varsayılan olarak hariçtir. İzin modları, MCP sunucuları ve VS Code yüzeyinin ötesindeki alan (sandbox) ayrıntıları için Claude Code güvenlik rehberimize bakın.

Sabit bir yol kümesi, moddan bağımsız olarak her zaman korunur: .git, .vscode, .idea, .husky ve .claude (kendi çalışma alt dizinlerine yönelik istisnalarla), ayrıca .gitconfig, .gitmodules ve çeşitli kabuk ve araç yapılandırma dosyaları. Bu, duraksamadan yazan ve settings.json ile tasks.json’a dokunabilen otomatik kabul modunda en çok önem taşır. Commit etmeden önce git diff’lerini kontrol edin.

Alan koruması, bash komutlarını çalışma dizininizle sınırlar ve yetkisiz ağ erişimini engeller. Varsayılan olarak kapalıdır; /sandbox ile açın.

Otomatik mod, eylem başına onayı, eylemleri çalışmadan önce inceleyen ve toplu dosya silme, yetkisiz uç noktalara veri gönderme ve main’e zorla itme (force-push) gibi şeyleri engelleyen bir sınıflandırıcıyla değiştirir. Anthropic, bunu --dangerously-skip-permissions için daha güvenli bir alternatif olarak tanımlar.

Yerel dökümler, 30 gün boyunca düz metin olarak ~/.claude/projects/ altında saklanır (cleanupPeriodDays bunu ayarlar). Amazon Bedrock, Google Vertex AI veya Microsoft Foundry üzerindeki kurumsal kurulumlar, bu sağlayıcıların veri şartlarını izler. Otomatik mod bu sağlayıcılarda mevcut değildir; doğrudan Anthropic API’sini gerektirir.

Yaygın VS Code Uzantı Sorunlarını Giderme

Kurulum sorunlarının çoğu kısa bir listeye girer. Bunların hepsine en az bir kez denk geldim.

• Kıvılcım simgesi yok: Sadece bir klasör değil, gerçek bir dosya açın. Komut Paleti’nden (Developer: Reload Window) pencereyi yeniden yükleyin veya bir dosya açık olmasa bile çalışan sağ alttaki Durum Çubuğu’ndaki Kıvılcım girişine tıklayın.

• Uzantı çakışmaları: Claude Code etkinleşmezse diğer yapay zekâ uzantılarını (Cline, Continue vb.) geçici olarak devre dışı bırakın.

• Kısıtlı Mod: Claude Code, VS Code Kısıtlı Mod’da çalışmaz. Çalışma alanını güvenilir olarak işaretleyin.

• Windows dosya kilitleme: Yazmalar oturum ortasında başarısız olursa, büyük çoklu dosya oturumlarından önce Gezgini daraltın ve etkin hata ayıklayıcıları duraklatın.

• macOS Tahoe Cmd+Esc çakışması: Sistem Oyun Yer Paylaşımı Cmd+Esc’i yakalayabilir. Odak geçişi çalışmayı bırakırsa VS Code Klavye Kısayolları’nda (Cmd+K Cmd+S) Claude Code: Focus input kısayolunu yeniden atayın.

• Anthropic girişi yerine Bedrock veya Vertex: Claude Code’u bulut sağlayıcı uç noktalarına yönlendirebilirsiniz. Yerel ve alternatif model kurulum rehberimiz, abonelik dışı yolları adım adım anlatır.

Anthropic, yukarıdakilerin hiçbiri sorununuzu çözmezse başvurabileceğiniz özel bir sorun giderme rehberi sunar.

Sınırlamalar ve Ödünleşimler

Uzantı, CLI’nin bir alt kümesidir. Terminal karşılaştırması bölümünde ele alındığı üzere, sekme tamamlama, ! bash kısayolu ve boru tabanlı iş akışları yalnızca CLI’dadır; CI hatları için dontAsk modu da öyle.

Arka plan görev görünürlüğü sınırlıdır; yakından izlemeniz gereken her şey için tümleşik terminal daha şeffaftır.

Onay dosya bazındadır, parça (hunk) bazında değil: Claude aynı dosyada bir fonksiyonu doğru, diğerini yanlış yaptıysa hepsini kabul edip istemediklerinizi elle geri alırsınız.

Kullanım sınırları, çoğu Pro kullanıcısının ilk karşılaştığı hayal kırıklığıdır. Hız sınırlamaları, ileti başına değil, yuvarlanan pencerelerde çalışır ve yoğun saatlerde daha hızlı tükenir. Ara sıra kullanım için Pro yeterlidir; tam bir çalışma günü için Max 5x veya Max 20x daha gerçekçidir. Topluluk tahminlerine güvenmezdim; Anthropic kesin sayıları yayımlamaz ve bunlar değişir.

Windows’ta, VS Code’un proje gezgini ile Claude’un yazma işlemleri arasındaki dosya kilitleme, macOS veya Linux’a kıyasla daha sık hataya yol açar. Büyük çoklu dosya oturumlarından önce gezgin panelini daraltmak ve etkin hata ayıklayıcıları duraklatmak genellikle bunu önler.

Son Düşünceler

VS Code’da Claude Code, inceleme-öncelikli bir arayüze sahip görev odaklı bir kodlama aracısıdır. Diff görüntüleyici, plan modu ve kontrol noktaları, aracının gerçekten neyi değiştirdiğini yakalamanın, hızlı bir ilk taslaktan daha önemli olmasından dolayı vardır.

Terminal iş akışı ortadan kalkmıyor ve betik, otomasyon veya CLI ağırlıklı işler için daha iyi yüzey olmaya devam ediyor. Ancak, inmeden önce önerilen her değişikliği okumak istediğiniz türden işler yapıyorsanız, düzenleyici daha iyi uyum sağlar.

Claude Code haftalık güncellemeler yayınlar; bu nedenle bu yazının bazı bölümleri hızla eskir. Güncel kalmak için Claude Code en iyi uygulamalar ve Claude Code 2.1 rehberi iyi takip yazılarıdır. Resmî değişiklik günlüğü sürümleri takip eder. Buradaki bir şey gördüklerinizle uyuşmuyorsa önce orayı kontrol edin.

Claude modelleri ve aracısal iş akışlarıyla yapılandırılmış pratik yapmak istiyorsanız, Claude Modellerine Giriş kursumuzu öneririm.