# Claude Code VS Code kurulumu: eklenti, diff ve ayarlar

Adres: https://agentvera.dev/blog/claude-code-vs-code-kurulumu/ · Yayın: 2026-10-23

Claude Code VS Code eklentisini kur, seçimi bağlam olarak ver, diff görünümüyle değişiklikleri onayla, doğru ayarları seç, sık sorunları çöz ve JetBrains’e kur.

**Kısaca:**

- Resmi Claude Code eklentisi (anthropic.claude-code) VS Code 1.94.0 ya da üstü ile Pro, Max, Team, Enterprise planı veya bir Console hesabı ister.
- Eklentiyi kurmak claude komutunu PATH’e eklemez; terminalde kullanmak için bağımsız CLI’ı kurman gerekir, ikisi aynı sohbet geçmişini paylaşır.
- JetBrains IDE’lerinde Claude Code [Beta] eklentisi claude CLI’ını IDE terminalinde çalıştırır, bu yüzden önce CLI kurulu olmalıdır.

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](https://code.claude.com/docs/en/vs-code "VS Code’da Claude Code") ve [JetBrains belgelerinden](https://code.claude.com/docs/en/jetbrains "JetBrains IDE’lerinde Claude Code").

## Eklentiyi kurmak

1. VS Code’u aç, `Cmd+Shift+X` (Mac) ya da `Ctrl+Shift+X` (Windows/Linux) tuşlarına bas.
2. **Claude Code** diye ara ve Anthropic’in eklentisini kur.
3. Hemen görünmezse VS Code’u yeniden başlat ya da Komut Paleti’nden **Developer: Reload Window** çalıştır.
4. 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](https://code.claude.com/docs/en/setup "Claude Code kurulumu") 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ı](/blog/claude-code-komutlari/ "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-10` gibi bir referans ekler. Odak editörde olmalı.
- Mesaj kutusunda `@` herhangi bir dosya ya da klasörü ekler.
- `@terminal:ad` bir terminalin çıktısına referans verir.
- `Cmd+Esc` / `Ctrl+Esc` odağı 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+Esc` editörden Claude Code’u açar.
- `Cmd+Option+K` / `Alt+Ctrl+K`, `@src/auth.ts#L1-99` gibi bir dosya referansı ekler.
- Önerilen değişiklikler IDE’nin diff görüntüleyicisinde açılır. `/config` içinde **Diff tool** ayarını `auto` ya da `terminal` yap.
- 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](/blog/en-iyi-yapay-zeka-kodlama-araclari/ "En iyi yapay zekâ kodlama CLI araçları") karıştırdığında hangisinin cevap beklediğini kaçırmaya başlarsın.

[AgentVera](/ajanlar/claude-code/ "AgentVera’da Claude Code") 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ı](/ozellikler/calisma-alani/ "Çalışma alanı") ajanları 5×4’e kadar ızgaralara dizer. [Grup görünümü](/ozellikler/grup-gorunumu/ "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](/ozellikler/kod-editoru-ve-terminal/ "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](/ozellikler/git-ve-github/ "Git ve GitHub") worktree ve PR ekler.
- **İkinci bir göz.** [Kod incelemesi](/ozellikler/kod-incelemesi/ "Otomatik 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](/blog/git-worktree-paralel-gelistirme/ "Git worktree ile paralel geliştirme").

AgentVera’yı denemek için [ana sayfadan](/ "AgentVera") başla.

## Sık sorulanlar

**Claude Code eklentisini VS Code’a nasıl kurarım?** Cmd+Shift+X ya da Ctrl+Shift+X ile Eklentiler görünümünü aç, Claude Code diye ara ve Anthropic’in yayımladığı eklentiyi kur (kimliği anthropic.claude-code). VS Code 1.94.0 ya da üstü ve Pro, Max, Team, Enterprise planı veya bir Console hesabı gerekir.

**VS Code eklentisi Claude Code CLI’ını da kuruyor mu?** Sohbet paneli için CLI’ın kendine ait bir kopyasını içerir ama claude komutunu PATH’e eklemez. Entegre terminalde claude yazmak için bağımsız CLI’ı bir kez kur. İkisi aynı sohbet geçmişini paylaşır, claude --resume eklentideki oturumları da bulur.

**Claude Code eklentisi Cursor’da çalışır mı?** Evet. VS Code belgelerinde Cursor için doğrudan bir kurulum bağlantısı var; diğer VS Code çatalları eklentiyi Open VSX kayıt deposundan kurabilir. Eklenti kurulamayan bir editörde entegre terminalde claude çalıştırırsın.

**Claude Code’un kıvılcım simgesini neden göremiyorum?** Simge editör araç çubuğunda yalnızca bir dosya açıkken görünür. VS Code’un 1.94.0 ya da üstü olduğunu, çalışma alanına güvenildiğini ve başka bir yapay zekâ eklentisinin çakışmadığını kontrol et, sonra Developer: Reload Window çalıştır. Durum çubuğundaki Claude Code öğesi dosya açmadan da çalışır.

**JetBrains IDE’leri için Claude Code eklentisi var mı?** Var. JetBrains Marketplace’teki Claude Code [Beta] eklentisi IntelliJ IDEA, PyCharm, WebStorm, GoLand, PhpStorm ve Android Studio ile çalışır. CLI’ı IDE terminalinde çalıştırdığı için CLI’ın kurulu olması gerekir; IDE’nin diff görünümünü ve seçim paylaşımını ekler.

---

**AgentVera hakkında.** AgentVera, Solviera Teknoloji tarafından geliştirilen macOS, Windows ve Linux masaüstü uygulamasıdır. 18 yapay zeka kodlama ajanını (Claude Code, Codex, Gemini CLI, Copilot, Cursor, Antigravity, opencode, Hermes, Qwen Code, Kimi Code, Kiro, Amp, Droid, Goose, Vibe, Crush, Aider, Cline) proje bazında, gerçek terminallerde ve kullanıcının kendi CLI kurulum ve girişleriyle yan yana çalıştırır. Ücretsiz planda sınırsız ajan vardır. İndir: https://agentvera.dev/indir/ · Fiyatlar: https://agentvera.dev/fiyatlar/