Claude Code VS Code eklentisi, Claude Code’u VS Code içinde görsel bir panele taşıyan Anthropic’in resmi eklentisidir (kimliği anthropic.claude-code). Eklentiler görünümünden kurar, giriş yaparsın; ardından Claude açık dosyanı ve seçimini görür, önerdiği düzenlemeleri onaylayıp reddedebileceğin yan yana farklar olarak gösterir ve CLI ile aynı geçmişi paylaşır. VS Code 1.94.0 ya da üstü ve ücretli bir Claude planı veya Console hesabı gerekir. Terminali seviyorsan claude CLI’ını VS Code’un entegre terminalinde de çalıştırabilir, IDE’deki diff görünümünü yine kullanabilirsin.
Bu rehber kurulumu, eklenti ile CLI farkını, diff görünümünü, seçim bağlamını, değiştirmeye değer ayarları, sık sorunları ve kısaca JetBrains’i anlatıyor. Bilgilerin hepsi resmi VS Code belgelerinden ve JetBrains belgelerinden.
Eklentiyi kurmak
- VS Code’u aç,
Cmd+Shift+X(Mac) ya daCtrl+Shift+X(Windows/Linux) tuşlarına bas. - Claude Code diye ara ve Anthropic’in eklentisini kur.
- Hemen görünmezse VS Code’u yeniden başlat ya da Komut Paleti’nden Developer: Reload Window çalıştır.
- Paneli aç, istediğinde giriş yap.
| Gereksinim | Ayrıntı |
|---|---|
| VS Code | 1.94.0 ya da üstü |
| Hesap | Pro, Max, Team ya da Enterprise planı, veya Console hesabı |
| Çalışma alanı | Güvenilir olmalı (Restricted Mode’da çalışmaz) |
Cursor ve diğer VS Code çatalları
Belgelerde Install for Cursor bağlantısı var, yani Cursor destekleniyor. Diğer VS Code çatalları eklentiyi Open VSX kayıt deposundan kurabilir. Editörün eklentiyi hiç kuramıyorsa entegre terminalini açıp claude yaz.
Claude Code’u açmak
Dört yol var:
- Kıvılcım simgesi: editör araç çubuğunda, sağ üstte. Yalnızca bir dosya açıkken görünür.
- Activity Bar: soldaki oturum listesi.
- Komut Paleti (
Cmd+Shift+P/Ctrl+Shift+P): “Claude Code” yaz, Open in New Tab seç. - Durum çubuğu: sağ alttaki ✻ Claude Code öğesine tıkla. Dosya açık olmasa da çalışır.
Paneli sürükleyip sağdaki ikincil kenar çubuğuna, soldaki birincil kenar çubuğuna ya da editör alanına sekme olarak koyabilirsin. Belgelerin önerisi: ana oturum kenar çubuğunda, yan işler sekmelerde.
Eklenti mi, entegre terminalde CLI mı?
İkisi de aynı Claude Code. Fark arayüzde ve birkaç özellikte.
| Özellik | CLI | VS Code eklentisi |
|---|---|---|
| Komutlar ve skill’ler | Hepsi | Bir kısmı (/ yazınca görürsün) |
| MCP sunucu ayarı | Var | Var, panelde /mcp ile |
| Kontrol noktaları | Var | Var |
! kabuk kısayolu | Var | Yok |
| Tab ile tamamlama | Var | Yok |
Çoğu kişinin takıldığı nokta: eklentiyi kurmak claude komutunu PATH’e eklemez. Eklenti, paneli için CLI’ın kendine ait bir kopyasını taşır. Terminalde claude yazabilmek için bağımsız CLI kurulumunu yapman gerekir.
İkisi de kurulunca aynı sohbet geçmişini paylaşırlar. Panelde başladığın bir sohbete terminalden devam etmek için claude --resume çalıştır.
CLI’ı VS Code içinde kullanmak için Ctrl+` (Mac’te Cmd+`) ile terminali aç ve claude yaz. Diff görünümü ve tanılama paylaşımı için IDE’ye kendiliğinden bağlanır. Harici bir terminaldeysen Claude Code içinde /ide çalıştırarak VS Code’a bağlarsın.
Terminal arayüzünü panelin yerinde istiyorsan Use Terminal ayarını (claudeCode.useTerminal) aç.
Kısaca: farklara tıklayarak bakmak ve planları belge olarak okumak istiyorsan panel; her slash komutunu, ! kabuk modunu ve Claude Code komutları yazısındaki kısayolları istiyorsan CLI.
Seçim bağlamı ve @ ile dosya eklemek
Eklenti editörde açık olan dosyayı mesajına ekler, seçtiğin metni de Claude görür. Kodu mesaja yapıştırman gerekmez.
Option+K(Mac) /Alt+K(Windows/Linux), açık dosyaya ve seçime@auth.ts#5-10gibi bir referans ekler. Odak editörde olmalı.- Mesaj kutusunda
@herhangi bir dosya ya da klasörü ekler. @terminal:adbir terminalin çıktısına referans verir.Cmd+Esc/Ctrl+Escodağı editör ile Claude arasında değiştirir.
Gizlilik notu: files.exclude ya da search.exclude ile eşleşen dosyalardan ve respectGitIgnore açıkken git’in yok saydığı dosyalardan seçili metin gönderilmez. Bu kural sohbet paneli için geçerli. Açık dosyanın tamamı değil yalnızca seçimin gitsin istiyorsan attachOpenFile ayarını kapat.
Diff görünümü
Manual modda Claude bir dosyayı değiştirmek istediğinde VS Code önerilen düzenlemeyi yan yana bir fark olarak gösterir. Kabul edebilir, reddedebilir ya da kabul etmeden önce önerilen metni düzenleyebilirsin. Yeni sürümlerde tek bir düzenlemenin içindeki değişiklikleri de ayrı ayrı kabul ya da reddedebilirsin; Komut Paleti’nde Accept Change at Cursor ve Reject Change at Cursor var. 100’den fazla değişiklik içeren düzenlemelerde değişiklik başına düğme çıkmaz.
Farkları ne sıklıkla göreceğin mesaj kutusundaki izin moduna bağlı:
| Mod | Ne olur |
|---|---|
| Manual | Her düzenlemeden önce sorar, farkı gösterir |
| Edit automatically | Düzenlemeleri sormadan uygular |
| Plan | Yorum ekleyebileceğin Markdown bir plan yazar ve bekler |
| Auto | Bir güvenlik kontrolüyle kendisi karar verir; yeni sürümlerde varsayılan bu |
Bunun üstünde kontrol noktaları var. Bir mesajın üstüne gelince geri sarma düğmesi çıkar: Rewind code to here, Fork conversation from here ya da ikisi birden.
Değiştirmeye değer ayarlar
VS Code ayarlarını aç (Cmd+, / Ctrl+,) ve Extensions > Claude Code bölümüne git. İzinli komutlar, hook’lar ve MCP sunucuları gibi ortak ayarlar CLI’ın da okuduğu ~/.claude/settings.json dosyasına gider.
| Ayar | Varsayılan | Neden değiştirirsin |
|---|---|---|
useTerminal | false | Sohbet paneli yerine CLI arayüzünü açar |
initialPermissionMode | ayarsız | Yeni sohbetleri default, plan, acceptEdits ya da bypassPermissions ile başlatır |
preferredLocation | panel | sidebar Claude’u sağda sabit tutar |
attachOpenFile | true | Kapatırsan yalnızca seçimin gider |
autosave | true | Claude okumadan ya da yazmadan önce dosyaları kaydeder |
useCtrlEnterToSend | false | Göndermek için Ctrl/Cmd+Enter, yeni satır için Enter |
respectGitIgnore | true | Git’in yok saydığı dosyaları aramadan ve seçim bağlamından çıkarır |
allowDangerouslySkipPermissions | false | Mod menüsüne Bypass permissions ekler. Yalnızca sandbox’ta |
initialPermissionMode yalnızca kullanıcı ayarlarından okunur, çalışma alanı ayarlarından değil. settings.json dosyana "$schema": "https://json.schemastore.org/claude-code-settings.json" eklersen otomatik tamamlama da gelir.
Sık sorunlar ve çözümleri
| Sorun | Çözüm |
|---|---|
| Eklenti kurulmuyor | VS Code 1.94.0+ mı, eklenti kurma izni var mı bak; ya da Marketplace sayfasından kur |
| Kıvılcım simgesi yok | Bir dosya aç (yalnızca klasör yetmez), çalışma alanına güven, çakışan yapay zekâ eklentilerini kapat, pencereyi yenile |
macOS’ta Cmd+Esc çalışmıyor | macOS Tahoe bu tuşu Game Overlay’e atar. Klavye Kısayolları → Oyun Kumandaları altında kapat ya da Claude Code: Focus input komutuna başka tuş ata |
| “Not logged in · Please run /login” | Pencereyi yenile ve tekrar giriş yap |
ANTHROPIC_API_KEY okunmuyor | Ortam değişkenlerini alsın diye VS Code’u terminalden code . ile aç |
Terminalde claude bulunamıyor | Bağımsız CLI’ı kur; eklenti PATH’e eklemez |
| Claude hiç cevap vermiyor | Bağlantını kontrol et, yeni sohbet aç, daha net hata için terminalde claude dene |
| Log lazım | Komut Paleti’nden Claude Code: Show Logs çalıştır |
JetBrains IDE’lerinde Claude Code
JetBrains Marketplace’teki Claude Code [Beta] eklentisi IntelliJ IDEA, PyCharm, Android Studio, WebStorm, PhpStorm ve GoLand’i destekler. VS Code eklentisinden farklı olarak claude CLI’ını IDE terminalinde çalıştırır, bu yüzden önce CLI’ı kur. “Cannot launch Claude Code” görüyorsan claude PATH’te değil demektir.
Neler geliyor:
Cmd+Esc/Ctrl+Esceditörden Claude Code’u açar.Cmd+Option+K/Alt+Ctrl+K,@src/auth.ts#L1-99gibi bir dosya referansı ekler.- Önerilen değişiklikler IDE’nin diff görüntüleyicisinde açılır.
/configiçinde Diff tool ayarınıautoya daterminalyap. - Seçimin ve IDE tanılamaları (lint ve tür hataları) Claude ile paylaşılır.
- Harici terminalden bağlanmak için
/ideçalıştır.
Belgelerden iki çözüm: Esc Claude’u durdurmuyorsa Settings → Tools → Terminal altında “Move focus to the editor with Escape” kutusunu kaldır. WSL’de eklentinin Claude komutunu wsl -d Ubuntu -- bash -lic "claude" yap; “No available IDEs detected” görürsen bir güvenlik duvarı kuralı ekle ya da WSL’i mirrored ağ moduna al.
Ayrı bir uygulama ne zaman mantıklı?
Eklenti tek editör penceresi ve birkaç sohbet etrafında kurulu; çoğu gün bu yeter. Farklı dallarda aynı anda dört beş ajan çalıştırdığında ya da Claude Code’u Codex veya başka CLI ajanlarıyla karıştırdığında hangisinin cevap beklediğini kaçırmaya başlarsın.
AgentVera tam bu durum için var. macOS, Windows ve Linux’ta çalışan, her CLI ajanını proje başına bir ızgarada kendi panelinde açan bir masaüstü uygulaması. Bir editör değil, VS Code’un yerini almaz; çoğu kişi ikisini birlikte açık tutuyor.
- Çok ajan, tek görünüm. Çalışma alanı ajanları 5×4’e kadar ızgaralara dizer. Grup görünümü çalışan, cevap bekleyen ve onay bekleyen ajanları sayar; her kartta onay ve ret düğmeleri var.
- Pencere değiştirmeden fark. Kod editörü ve terminal araçlarında bir dosya editörü ve HEAD ile çalışma ağacı arasındaki farkı birleşik ya da yan yana gösteren Değişiklikler sekmesi var. Git ve GitHub worktree ve PR ekler.
- İkinci bir göz. Kod incelemesi, bir ajanın turu bitince kodunu senin seçtiğin bir Claude modeline inceletir; bulgular dosya:satır bağlantısıyla gelir.
Paralel çalışmayı kuruyorsan sıradaki adım git worktree ile paralel geliştirme.
AgentVera’yı denemek için ana sayfadan başla.