Cursor’da Claude Code: Kurulum ve İş Akışı Rehberi

Cursor, kendi yapay zekâ aracısıyla birlikte gelir. Dosyaları düzenleyebilir, komutlar çalıştırabilir ve kod tabanınız genelinde çalışabilir. Peki, aynı editöre neden ikinci bir aracı kurasınız?

Claude Code, Anthropic’in aracısal kodlama aracıdır: kod tabanınızı okur, değişiklikleri planlar, dosyaları düzenler, testleri çalıştırır ve incelemeniz için bir diff geri verir. VS Code uzantısı, bu iş akışını aynı VS Code temeli üzerine inşa edilen Cursor’a taşır. Sonuç, aynı pencerede yer alan, her birinin kendi bağlamı, faturası ve çalışma biçimi olan iki ayrı yapay zekâ sistemi olur. Bunun faydalı olup olmadığı, ne inşa ettiğinize bağlıdır.

Devam etmeden önce: "Cursor’da Claude Code" ifadesi şu anda iki farklı anlama gelebilir. Biri Claude Code uzantısıdır (bu yazının konusu), diğeri ise Cursor’ın yerleşik model seçicisinden Claude modellerini seçmektir (yalnızca Claude’u arka uç olarak kullanan tamamen ayrı bir ürün). Bu ayrımı ileride ayrıca ele alacağım. Bunun yerine iki aracı bağımsız ürünler olarak birebir karşılaştırmak istiyorsanız, ayrı bir Claude Code vs. Cursor makalemiz var.

Cursor’da Claude Code Nedir?

Claude Code, Anthropic’in aracısal kodlama aracıdır. Kod tabanlarını okur, dosyaları düzenler, terminal komutları çalıştırır, git iş akışlarını yönetir ve MCP (Model Context Protocol) üzerinden haricî servislere bağlanır. CLI, VS Code uzantısı, masaüstü uygulaması ve web üzerinden kullanılabilir.

Cursor, VS Code türevi bir ortam üzerine kuruludur ve Claude Code VS Code uzantısı bunun için resmen desteklenir. Anthropic dokümantasyonunda standart VS Code kurulumundan ayrı, doğrudan bir kurulum yolu olarak "Install for Cursor" listelenir. Bu bir topluluk geçici çözümü değildir.

Tek editörde iki yapay zekâ iş akışı. Görsel: Yazar.

Kafa karıştıran nokta şu: Biri "Cursor’da Claude Code" dediğinde, Anthropic’in kendi paneli, izin modeli ve oturum geçmişiyle tam aracısal iş akışını sunan Claude Code uzantısını veya CLI’ını Cursor içinde çalıştırmayı kastedebilir. Ya da Cursor’ın kendi yerel yapay zekâsı için arka uç olarak Claude modellerini kullanmayı kastedebilir. İlgilidirler ama aynı ürün değildirler ve aynı şekilde davranmazlar.

Cursor’da Claude Code vs. Claude Modelleri

Her birinin gerçekte ne anlama geldiği şöyle.

Cursor’da Claude modelleri

Cursor’da Claude Sonnet, Claude Opus, GPT, Gemini ve diğerleri arasında seçim yapmanızı sağlayan bir model seçicisi vardır. "auto" modunda Cursor modeli otomatik seçer. Cursor’ın sohbetinde veya aracı modunda Claude Sonnet kullandığınızda Cursor’ın ürününü kullanırsınız: onun arayüzü, faturası, bağlam yönetimi. Model Claude’dur, fakat deneyim Cursor’a aittir.

Cursor’da Claude Code

Cursor’a Claude Code uzantısını kurmak, size kendi panelini, kendi bağlam penceresini ve Anthropic aboneliğiniz veya API anahtarınıza bağlı faturalamayı sunar. İkisi aynı editör penceresinde çalışabilir ama bağlam paylaşmazlar. Claude Code, Cursor’ın yerel aracısının ne yaptığının farkında değildir.

Cursor’ın model seçicisinden "Claude Sonnet"i seçmek, Claude Code’u kurmakla aynı şey değildir. Claude Code’un planla-ve-uygula iş akışını ve CLAUDE.md proje belleğini istiyorsanız, uzantıya veya CLI’a ihtiyacınız var. Geliştirici topluluğundan bir ifade farkı iyi özetler: "Cursor, yapay zekâ özelliklerine sahip bir IDE’dir. Claude Code ise IDE erişimi olan bir yapay zekâ aracıdır."

Cursor’da Claude Code Nasıl Kurulur

Cursor’da Claude Code kurulumu için üç yol var; hangisinin mantıklı olduğu sizin durumunuza bağlıdır.

Her şeyden önce: Claude Code, ücretli bir Anthropic planı gerektirir. Claude.ai üzerindeki ücretsiz katman buna dahil değildir. Minimum, aylık 20 $’lık Pro plandır. Ayrıca Cursor’ın VS Code motor sürümü 1.98.0 veya üstünde çalışıyor olması gerekir.

Üç yol şunlardır:

• Yol 1: VS Code uzantısı (resmî, çoğu geliştirici için önerilir)
• Yol 2: Entegre terminal (Claude Code zaten kuruluysa en az sürtünme)
• Yol 3: MCP sunucusu (ileri seviye, ekip ortamları veya çoklu araç kurulumları için)

Claude Code bilgisayarınızda zaten kuruluysa, doğrudan Yol 2’ye geçin.

Yol 1: VS Code uzantısı (önerilen)

Cursor’ın Uzantılar panelini Mac’te Cmd+Shift+X, Windows ve Linux’ta Ctrl+Shift+X ile açın. "Claude Code"u aratın ve Anthropic tarafından yayımlanan uzantıyı kurun. Uzantı kimliği anthropic.claude-code’dur.

Cursor’da Claude Code arama. Görsel: Yazar.

Önden bilinmesi gereken bir şey: uzantı bazen Cursor’ın market aramasında görünmez. Yeterince sık olduğu için başlamadan hazırlıklı olun. Görünmezse, Anthropic’in VS Code dokümantasyonu "Install for Cursor" düğmesine sahiptir ve cursor:extension/anthropic.claude-code URI’sini doğrudan tetikler. Bu da başarısız olursa, aynı sayfada manuel VSIX kurulum talimatları vardır.

Kurulduktan sonra, bir dosya açıkken düzenleyici araç çubuğunda bir Kıvılcım simgesi görünür; yalnızca klasör açıkken görünmez. Aynı simge sol kenar çubuğundaki Etkinlik Çubuğunda ve sağ alttaki Durum Çubuğunda da görünür; bu ikisi dosya açık değilken de görünür. Bunlardan herhangi birine tıklayın, ardından ilk oturumunuzda kimlik doğrulaması için tarayıcı üzerinden Oturum aç’ı tıklayın.

Bir şeyler garip görünüyorsa kontrol etmeye değer birkaç nokta:

• Kurulumdan sonra simge görünmüyorsa, Komut Paletinden "Developer: Reload Window" çalıştırın

• Kabuğunuzda ANTHROPIC_API_KEY varsa ama yine de oturum açma istemini görüyorsanız, ortamınızı devralması için Cursor’ı bir terminalden cursor . ile başlatın

Yol 2: Entegre terminal (en az sürtünme)

Claude Code bilgisayarınızda zaten kuruluysa, uzantıyı tamamen atlayın. Cursor’ın entegre terminalini `Ctrl+`` ile açın ve claude` yazın. Claude Code, editörünüz açık kalırken terminalde etkileşimli bir oturum çalıştırır. Bu, uzantı uyumluluk sorunlarını tamamen önler.

Claude Code henüz kurulu değilse, yerel yükleyici önerilen yöntemdir. Kendi içinde yeterlidir, Node.js gerektirmez ve arka planda otomatik güncellenir:

# macOS, Linux, or WSL
curl -fsSL https://claude.ai/install.sh | bash

# Windows PowerShell (requires Git for Windows)
irm https://claude.ai/install.ps1 | iex

npm yöntemi (npm install -g @anthropic-ai/claude-code) hâlâ çalışır ancak artık eski usuldür.

Yol 3: MCP sunucusu (ileri seviye)

Kişisel kullanım için kurulum yapıyorsanız, bunu atlayın.

Çoklu araç MCP ortamları kuran ekipler için, Claude Code’u yerel bir MCP sunucusu olarak çalıştırabilir ve Cursor’ın MCP ayarları üzerinden aşağıdakini mcp.json dosyanıza ekleyerek bağlanabilirsiniz:

{
  "mcpServers": {
    "claude-code": {
      "type": "stdio",
      "command": "claude",
      "args": ["--mcp"]
    }
  }
}

Bu, yapılandırdığınız diğer MCP sunucularının yanında Claude Code’un araçlarını da sunar. Cursor ile çalışır. Çoğu bireysel geliştiricinin buna ihtiyacı olmaz.

Cursor’da Claude Code ile Neler Yapabilirsiniz

Claude Code, çoğu kişinin sohbet tabanlı bir araçtan beklediğinden daha geniş bir görev yelpazesini yönetir. Cursor içinde elde ettikleriniz şunlardır:

• İlgili dosyaları doğrudan okuyarak bilinmeyen veya eski kodu açıklamak
• Birden çok dosyaya yayılan özellikleri planlamak ve uygulamak; herhangi bir değişiklikten önce inceleme adımıyla
• Hata mesajları veya yığın izlerinden yola çıkarak, sorunu kod tabanı boyunca geri izleyerek hata ayıklamak
• Testler üretmek, çalıştırmak ve geçene kadar hataları düzeltmek
• Değişiklikleri aşamalandırmak, commit mesajları yazmak, dallar oluşturmak ve pull request açmak

@-bahsetme söz dizimi bilmeye değerdir. Bağlama çağırmak için @ yazıp bir dosya veya klasör adı ekleyin. Claude Code bulanık eşleşmeyi destekler; kısmi adlar çalışır. Düzenleyicide kod seçerseniz, Claude bunu otomatik olarak görür.