IDE'de Claude Code: eklenti size ne kazandırır ve nerede takılabilirsiniz

Eklentiyi kurdunuz, düğmeyi buldunuz, tıkladınız - ve ilk izlenim genellikle şu olur: bu, ayrı bir terminal penceresine geçmeden claude komutunu çalıştırmanın bir yolu. Kullanışlı, elbette. Ama tek bir düğme için koca bir eklenti kurmak tuhaf olurdu.

Bu izlenim yanıltıcı. IDE'nin içinde terminal eklentiden önce de vardı ve orada claude yazmanıza kimse engel olmuyordu. Eklentinin işi başka: ajanı düzenleyiciye bağlıyor ki ikisi birbirini görebilsin. Neyin açık ve seçili olduğu, linter'ın neye itiraz ettiği, önerilen düzenlemenin satır satır nasıl göründüğü - bunları artık sizin anlatmanız gerekmiyor. Tek düğmeyle başlatma ise bu paketteki en sıkıcı özellik.

Claude Code bir terminal aracıdır ve IDE olmadan da gayet iyi çalışır: terminali açarsınız, claude yazarsınız, sonra da gündelik dille yazmaya devam edersiniz.

Fark, ajanın çalışıp çalışmamasında değil. Fark, onun işini neyle kontrol ettiğinizde. Diskteki dosyaları gerçekten değiştiriyor. Düzenleyici kapalıyken elinizde yalnızca bir rapor olur: "üç metoda hata yönetimi ekledim". Kulağa doğru geliyor. Karşılaştıracak bir şey yok.

Eklenti tam olarak bu boşluğu kapatır. Aşağıda size ne kazandırdığını ve insanların en sık nerede takıldığını bulacaksınız.

1. Düzenleyiciyle bağlantı ne kazandırır

Resmi eklenti beş şey yapar. Sırayla gidelim ve bütün bu işin asıl amacı olandan başlayalım.

• IDE penceresinde diff. Diff, değişikliklerin listesidir: hangi satırlar silindi, hangileri eklendi, eski sürümle yeni sürüm arasında ne değişti. Ajanın düzenlemeleri terminalde metin olarak değil, düzenleyicinin alışık olduğunuz diff görüntüleyicisinde açılır. Solda önceki hali, sağda yeni hali.
• Seçim bağlamı. Açık sekme ve seçili parça ajana kendiliğinden gider. Kodu sohbete kopyalamanıza ve hangi parçadan bahsettiğinizi kelimelerle anlatmanıza gerek kalmaz.
• Kodu ajana gönderme. Bir parçayı seçip kısayol tuşuna basarsınız - prompt'a tam olarak o satırlara işaret eden @src/auth.ts#L1-99 biçiminde bir referans gider.
• IDE'den tanılama. Düzenleyicinin kırmızıyla altını çizdiği linter ve sözdizimi hatalarını Claude, sizin anlatmanıza gerek kalmadan IDE'den kendisi isteyebilir. Bu özellik genellikle en son fark edilir, oysa en faydalılarından biridir. Ancak her düzenlemeden sonra bu hataları otomatik olarak kontrol etmez; gerekirse ondan dosyadaki hatalara bakmasını istemeniz yeterli.
• Hızlı başlatma. IDE panelindeki Claude logosu ya da bir kısayol tuşu - ajan, düzenleyiciden çıkmadan açılır.

2. Kurulum: tek değil, iki parça

En sık burada takılınır. Claude Code eklentinin içinde gelmez. IDE'nin entegre terminalinde claude komutunu çalıştırır ve ona bağlanır. Yani iki parçayı da kurmanız gerekir:

1. Claude Code'un kendisi - yoksa eklenti bunu açıkça söyler: Cannot launch Claude Code;
2. Anthropic PBC'nin Claude Code [Beta] eklentisi - Marketplace üzerinden kurulur, kurulumdan sonra IDE'yi tamamen yeniden başlatmak iyi olur, bazen bir kez yetmiyor.

claude kurulu ama IDE'nin aradığı yerde değilse, tam yolu Settings → Tools → Claude Code [Beta] → Claude command alanına yazın.

3. Hemen gerekecek kısayol tuşları

Tablodaki son satır süs olsun diye orada değil. Kısayol tuşları her zaman çalışmaz: tuş kombinasyonunu bazen işletim sistemi, bazen başka bir eklenti yakalar. Bu bir arıza değil ve IDE'yi onarmaya kalkmak için bir sebep de değil - fareyle açın, daha yavaş ama her yerde çalışır.

Uzun uzun aramanız gerekmeyecek: eklentinin simgesi Claude logosu, arayüzün her yerinde gördüğünüz logonun aynısı. Başka bir şeyle karıştırmazsınız.

Send to Claude Code

İkinci kısayol en çok kullanacağınız kısayol. Bir kod parçasını seçersiniz, Ctrl+Alt+K tuşlarına basarsınız - ve ajanın prompt'una tam olarak o satırlara işaret eden bir referans düşer. Aynı işlem seçili kodun eylem menüsünde de var: Send to Claude Code öğesi.

Prompt'ta şöyle bir satır belirir - dosya yolu ve satır aralığı:

@presentations/assets/slides.css#L29-30

Sonra görevi gündelik dille arkasına eklersiniz:

@presentations/assets/slides.css#L29-30 margin-left'i kaldır, dar ekranda sayfa düzeni onun yüzünden kayıyor

İki taraf da kazançlı çıkar: ajan dosyayı aramaya adım harcamaz, siz de bu arama için bağlam harcamazsınız.

Eklenti yoksa

Bir satıra referansı IDE'nin kendi araçlarıyla da oluşturabilirsiniz: satıra sağ tıklayın - Copy / Paste Special - Copy Reference. Panoya src/utils/slides.js:16 kopyalanır.

Biçim farklı - @ yok ve iki nokta üst üste kullanılıyor. Bu artık dosyanın bağlama otomatik olarak eklenmesi değil, isteğin içinde düz bir metin. Yine de "buraya bak" işareti olarak işe yarar: ajan yolu okur ve doğru yeri kendisi açar.

4. İki başlatma yolu ve /ide komutu

claude komutunu IDE'nin yerleşik terminalinden çalıştırırsanız tüm özellikler kendiliğinden devreye girer, hiçbir şey yapmanız gerekmez.

Harici bir terminalden (ayrı bir pencere, Windows Terminal, iTerm) başlattıysanız, siz söyleyene kadar düzenleyiciyle bağlantı olmaz:

# Claude Code'u açık IDE'ye bağla
/ide

Ben olsam ajanı IDE terminalinden başlatmayı kural haline getirirdim. O zaman /ide komutunu hatırlamanız hiç gerekmez: yalnızca tek bir durumda lazım olur - terminal harici olduğunda.

Bir de başlattığınız klasör meselesi var. Ajan, başlatıldığı yerdeki dosyalara bakar - yan klasörden başlatılırsa yanlış dosyalarla çalışır. Kendi projenizde onu projenin kök klasöründen, IDE'de açık olan kökten başlatın.

Kurs görevlerinde durum farklı: ajanı görevin klasöründen başlatın, codegym-project kök klasöründen değil. Orada her görev kendi dosyaları ve ajan için kendi kuralları olan ayrı bir klasördür; proje kökünden başlatırsanız ajanın görüş alanına bir anda bütün kurs girer.

5. Diff nerede gösterilsin

Değişikliklerin tam olarak nerede gösterileceği bir ayardır, değiştirilemez bir şey değil:

# Claude Code ayarlarını aç
/config

Orada diff tool seçeneği var: auto değeri düzenlemeleri IDE'de gösterir, terminal ise onları terminalde bırakır. Bu seçenek yalnızca ajan IDE'ye bağlıyken görünür, bu yüzden harici bir terminalden önce /ide komutunu çalıştırın. Diff inatla terminalde kalıyorsa eklentide arıza aramak yerine buraya bakın.

Terminalde diff metin olarak gelir, aşağı yukarı şöyle:

diff --git a/src/main/java/RefundQueue.java b/src/main/java/RefundQueue.java
index 3a7f2bc..9d41a80 100644
--- a/src/main/java/RefundQueue.java
+++ b/src/main/java/RefundQueue.java
@@ -42,7 +42,7 @@ void prioritize(RefundRequest refundRequest) {
-    if (refundRequest.isUrgent()) {
+    if (refundRequest.isUrgent() || refundRequest.amount() > 100) {
         moveToTop(refundRequest);
     }
 }

Bu şöyle okunur: eksi işaretli satır eskiden vardı, artı işaretli satır yerine geldi. Geri kalan her şey teknik başlıklar: hangi dosya olduğu ve parçanın hangi satırdan başladığı.

Şimdi de gösterimi IDE'de açmanın asıl sebebine gelelim. Claude'un her düzenlemeden önce izin istediği modlarda soru terminale yalnızca metin olarak gelmez: IDEA değişikliği kendi diff penceresinde Reject ve Apply düğmeleriyle açar. Vurgulanan satırlara dosyanın tamamı bağlamında bakar ve kararı orada verirsiniz.

Konsoldaki metin diff'iyle bunu karşılaştırmak bile haksızlık olur: burada sözdizimi vurgulama, komşu satırlar, alışık olduğunuz gezinme var. "Kabul mü, ret mi" kararı kodun açıklamasına bakarak değil, kodun kendisine bakarak verilir.

6. Tipik üç tuzak

Esc ajanı durdurmuyor

JetBrains terminalinde Esc tuşu varsayılan olarak odağı düzenleyiciye taşır - ve Claude Code'a hiç ulaşmaz. Hoş olmayan bir durum: ajan yanlış bir şey yapıyor, siz Esc'ye basıyorsunuz ve hiçbir şey olmuyor.

Bir kez düzeltmeniz yeterli: Settings → Tools → Terminal altında Move focus to the editor with Escape onay kutusunun işaretini kaldırın. Ben olsam bunu eklentiyi kurar kurmaz yapardım, ilk kez başıma gelmesini beklemeden.

"No available IDEs detected"

Ajan düzenleyiciyi görmüyor. Sırayla kontrol edin: eklenti kurulu ve etkin; IDE tamamen yeniden başlatıldı; claude harici bir pencereden değil, yerleşik terminalden başlatıldı.

WSL: ajan Linux'ta, IDE Windows'ta

Aynı hatanın özel bir durumu. Claude Code WSL2'de, IDE ise Windows'ta çalışıyorsa, bağlantıyı genellikle WSL2'nin ağ yalıtımı ya da güvenlik duvarı engeller. Çözüm ya bir güvenlik duvarı kuralı ya da WSL2'yi mirrored networking moduna geçirmek - iki yol da eklentinin dokümantasyonunda ayrıntılı olarak anlatılıyor. Mirrored networking yalnızca Windows 11 22H2 ve sonrasında var, Windows 10'da geriye güvenlik duvarı kuralı kalıyor.

7. Bütün bunlar ne için

IDE bağlantısı size en önemli şeyi verir: ajan çalışırken ne yaptığını görürsünüz. Bundan sonra ritim şöyle işler:

1. Claude bir değişiklik önerir;
2. siz diff'e bakar ve kabul edip etmeyeceğinize karar verirsiniz;
3. Git, kabul ettiğiniz şeyi kaydeder.

Üçüncü adıma burada yalnızca değiniyoruz. Git ritmi, commit'ler ve geri almalar başlı başına büyük bir konu, kurs ona ayrıca dönecek. Şimdilik tek bir şeyi aklınızda tutmanız yeterli: kayıt noktası sizin kontrolünüzden sonra oluşur, önce değil.

Bu döngü yalnızca şemada bu kadar düzgün görünür. Gerçek işte düzenlemelerin yarısını bakmadan kabul edeceksiniz, çünkü sadece bir değişkenin adı değişmiştir; birinde ise on dakika takılıp yeniden yapılmasını isteyeceksiniz. Bu normal. Amaç her satırı tek tek okumak değil, bir düzenleme tuhaf göründüğü anda bu imkânın elinizde olması.

Düzenleyici olmadan bu imkân hiç yok: kodla değil, açıklamayla karşılaştırmak zorunda kalırsınız.