Cursor CLI nasıl kullanılır? Adım adım rehber

Cursor CLI’ı kullanmak için curl https://cursor.com/install -fsS | bash ile kurarsın, agent login ile giriş yaparsın, bir proje klasörüne geçip agent çalıştırırsın. Bir görev anlatırsın; Cursor’ın ajanı kodunu okur, dosyaları düzenler ve sen onayladıktan sonra komut çalıştırır. Betikler ve CI için agent -p "görevin" etkileşimli ekranı açmadan tek bir prompt çalıştırır.

Temel döngü bu. Bu rehber gerisini anlatıyor: üç mod, print modu, modeller, kural dosyaları, MCP sunucuları, izinler, CLI’ın Cursor planından nasıl kullanım düştüğü, sınırları ve onu diğer kodlama CLI’larının yanında çalıştırmak. Buradaki her şey Ekim 2026 itibarıyla Cursor’ın resmi belgelerine dayanıyor.

Cursor CLI nedir?

Cursor CLI, Cursor editöründeki ajanı terminale taşır. Editörle aynı hesabı, aynı modelleri, aynı kuralları ve aynı MCP ayarlarını kullanır; ekibin zaten Cursor kullanıyorsa CLI da herkesin beklediği gibi davranır. Terminalin olduğu her yerde çalışır: SSH ile bağlandığın bir sunucuda, bir CI runner’ında ya da başka bir ajanın yanındaki bir bölmede.

İsimle ilgili bir not: komutun adı eskiden cursor-agent idi. Cursor, Ocak 2026’da ana komutu agent yaptı; cursor-agent takma ad olarak çalışmaya devam ediyor. cursor-agent çağıran eski rehberler ve araçlar bozulmuyor; bu rehber agent kullanıyor.

Cursor ile terminal öncelikli bir ajan arasında hâlâ karar vermediysen Claude Code mu Cursor mu yazısı ikisini karşılaştırıyor. Bu yazı Cursor’ı seçtiğini ve terminalden kullanmak istediğini varsayıyor.

1. Adım: Cursor CLI’ı kur

Kurulumu kontrol et:

agent --version

Kabuk agent komutunu bulamıyorsa ~/.local/bin klasörünü PATH’ine ekle ve yeni bir terminal aç. CLI varsayılan olarak kendini günceller; elle güncellemek için agent update yeterli.

2. Adım: giriş yap

agent login     # tarayıcıyı açar
agent status    # hangi hesapla giriş yaptığını gösterir
agent logout

Tarayıcısı olmayan bir makinede NO_OPEN_BROWSER=1 ayarlarsan agent login adresi açmak yerine ekrana yazar. CI ve betikler için Cursor panelinde API Keys bölümünden bir API anahtarı oluştur ve onu CURSOR_API_KEY ortam değişkeniyle ya da --api-key ile ver.

3. Adım: etkileşimli oturum

Ajanı bir projede ilk prompt’la ya da prompt’suz başlat:

cd my-project
agent
agent "add input validation to the signup form"

CLI’ın üç modu var ve Shift+Tab aralarında dolaşır:

Basit olmayan her iş için iyi bir alışkanlık: Plan’da başla, yaklaşım üzerinde anlaş, sonra Agent’a geçip uygulat. Her gün kullanacağın birkaç şey daha:

• @ mesajına eklenecek dosyaları seçer.
• Ctrl+R ajanın yaptığı değişiklikleri incelemeni sağlar.
• Shift+Enter (ya da Ctrl+J) yeni satır ekler; yukarı ok önceki mesajlarında gezinir.
• Kabuk komutları çalışmadan önce y/n onayını bekler.
• /model model değiştirir; /clear temiz bir sohbet başlatır; /summarize uzayan bir sohbeti özetler.
• İki kez Ctrl+D çıkar.

Sohbetler kaydedilir. agent ls onları listeler, agent resume (ya da --continue) en sonuncusuna döner, --resume="chat-id" ise belirli birini açar. Oturum içinde /resume, /fork ve /rewind adlarından anlaşılan işi yapar.

Bilmeye değer iki ek özellik var. Bir mesajın başına & koyarsan konuşma bir Cursor Cloud Agent’a devredilir; sen yokken çalışmaya devam eder, sen de kaldığı yerden cursor.com/agents adresinde alırsın. -w (ya da --worktree isim) ise ajanı ~/.cursor/worktrees/ altında yeni bir Git worktree’sinde çalıştırır, böylece mevcut çalışma kopyana dokunmaz.

4. Adım: betikler ve CI için print modu

Print modu tek bir prompt çalıştırır ve çıkar. Bu sayede CLI’ı betiklerden, Git hook’larından ve CI hatlarından kullanabilirsin:

# Salt okuma bir soru, düz metin yanıt
agent -p "summarize what changed in src/billing since the last release"

# Değişiklikleri uygula (--force olmadan değişiklikler yalnızca önerilir)
agent -p --force "add JSDoc comments to every exported function in src/utils"

# Başka bir araç için makinenin okuyabileceği çıktı
agent -p --output-format json "list the TODO comments in this repo"

Burada önemli olan bayraklar:

• --force (takma adı --yolo) ajanın, bir reddetme kuralı engellemedikçe sormadan dosya yazmasına ve komut çalıştırmasına izin verir. Print modunun gerçekten bir şeyleri değiştirmesini sağlayan anahtar bu.
• --output-format text (varsayılan), json ya da stream-json alır. Metni üretildikçe almak için stream-json ile birlikte --stream-partial-output ekle.
• --trust çalışma alanına sormadan güvenir; --approve-mcps ayarlı MCP sunucularını onaylar.
• --model ve --workspace modeli ve klasörü belirler.

Cursor, CLI’ı GitHub Actions içinde çalıştırmayı da belgeliyor. CI’da --force kullanırken başında kimsenin olmadığı her ajana davrandığın gibi davran: kapsamı dar bir API anahtarı, kullanıp atılacak bir runner ve incelemeye bir dalda gelen değişiklikler.

5. Adım: model seç

agent models                   # hesabının kullanabildiği modeller
agent --model <model-id>       # belirli bir modelle başla

Oturum içinde /model model seçiciyi açar, /model grok ise listeyi süzer. Model vermezsen CLI hesabında ayarlı modeli kullanır. Hangi modelleri göreceğin planına bağlı (aşağıdaki fiyat bölümüne bak): her ücretli plan Cursor’ın kendi modellerini içerir, üçüncü taraf modeller ise Premium ve üstünü ister.

6. Adım: kurallar, AGENTS.md ve CLAUDE.md

Cursor CLI, editörle aynı kural sistemini kullanır. Kurallar .cursor/rules içinde durur; CLI ayrıca proje kökündeki AGENTS.md ve CLAUDE.md dosyalarını okur ve onları da kural olarak uygular. Ekim 2026 sürümüyle birlikte alt klasörlerdeki AGENTS.md dosyaları, ajan o klasörlerdeki dosyaları düzenlerken devreye giriyor.

# Project rules

- Package manager: pnpm. Run `pnpm test` before you finish a task.
- TypeScript strict mode; no `any` in new code.
- Never edit files in src/generated/.

Aynı depoda birkaç ajan çalışıyorsa hepsinin okuduğu dosya AGENTS.md’dir; ortak kurallar için en doğru yer burası. agent generate-rule etkileşimli olarak yeni bir Cursor kuralı oluşturur. Bu dosyalara neyin girmesi gerektiğini CLAUDE.md nasıl yazılır yazısı anlatıyor.

7. Adım: MCP sunucuları

MCP sunucuları ajana yeni araçlar verir: bir tarayıcı, bir iş takip aracı, bir veritabanı. Cursor CLI editörle aynı mcp.json dosyasını okur: proje için .cursor/mcp.json, tüm projeler için ~/.cursor/mcp.json. Editörde kurduğun her şey CLI’da da hazır.

agent mcp list                 # ayarlı sunucular ve durumları
agent mcp list-tools <id>      # bir sunucunun sunduğu araçlar
agent mcp login <id>           # OAuth kullanan bir sunucuya giriş
agent mcp disable <id>         # silmeden kapat

Oturum içinde /mcp list aynı bilgiyi gösterir. Her sunucu araçlarını ajanın bağlamına ekler; bu yüzden yalnızca ihtiyacın olanları açık tut.

8. Adım: izinler ve ayarlar

Genel ayarlar ~/.cursor/cli-config.json dosyasında (Windows’ta %USERPROFILE%\.cursor\cli-config.json) durur. Bir proje, yalnızca izinleri tutan bir .cursor/cli.json ekleyebilir. İkisi de yorum satırı içermeyen düz JSON.

{
  "permissions": {
    "allow": ["Shell(git)", "Shell(ls)", "Read(src/**/*.ts)", "Write(package.json)", "Mcp(datadog:*)"],
    "deny": ["Shell(rm)", "Read(.env*)", "Write(**/*.key)"]
  }
}

Her girdi bir araç ve bir kalıp belirtir: Shell(...), Read(...), Write(...), WebFetch(alan-adı) ve Mcp(sunucu:araç). Reddetme kuralı izin kuralını yener. Genel dosya ayrıca onay modunu (allowlist, auto-review ya da unrestricted), sandbox ayarlarını ve commit’lere “Made with Cursor” satırı eklenip eklenmeyeceğini belirler.

Cursor CLI, Cursor planına nasıl bağlı?

Ayrı bir CLI aboneliği yok. CLI Cursor hesabını kullanır; Ekim 2026 itibarıyla Cursor, Grok ve X ile birlikte The X Subscription’ın parçası olarak satılıyor. Her ücretli planda Cursor’ın kendi modelleri (Grok 4.7, Grok 4.6, Grok 4.5 ve Composer 2.5) için tek bir kullanım havuzu var. Editör, CLI, Cloud Agents ve Grok uygulamaları bu havuzdan harcar; havuz her hafta yenilenir.

CLI kullanımı açısından anlamı şu:

• Her model havuzdan farklı hızda harcar. Kalan kullanımın ve bir sonraki yenilenme tarihi editör ayarlarında ve kullanım panelinde görünür.
• Claude, GPT ve Gemini havuza dahil değil. Premium ve üstünde bunları ilk istekten itibaren ön ödemeli krediden API liste fiyatıyla ödersin. Plus ve Free bu modelleri kullanamaz.
• Plus’ta Cloud Agents ve Auto yok. Bir Cloud Agent’a & ile devretmek Premium ya da üstünü ister.
• Eski planlar çalışmaya devam ediyor. Pro, Pro+, Ultra, Start ve Teams Standard ya da Premium koltuklar eski plan sayılıyor; iki aylık havuzlarını ve talebe bağlı kullanımlarını koruyorlar.

Bilmeye değer sınırlar

• Shell Mode’da 30 saniyelik zaman aşımı var. /shell komutları doğrudan çalıştırır ama uzun süre açık kalan sunucuları ya da etkileşimli istemleri çalıştıramaz; cd de komutlar arasında korunmaz.
• Print modu varsayılan olarak temkinli. --force olmadan değişiklikleri yazmaz, önerir; bu ilk seferde çoğu kişiyi şaşırtıyor.
• Ayar dosyaları katı JSON. cli-config.json içindeki bir yorum satırı ya da sondaki fazladan bir virgül dosyayı bozar.
• Terminal başına bir sohbet. CLI’da worktree’ler ve Cloud Agents var, ama birkaç yerel ajanı aynı anda gösteren yerleşik bir görünüm yok.

Sık yapılan hatalar

• command not found: agent. ~/.local/bin klasörü PATH’inde değil.
• Bir araç hâlâ cursor-agent çağırıyor. Sorun değil, takma ad duruyor. Yalnızca belgeler agent adına geçti.
• İstediğin model listede yok. O bir üçüncü taraf model ve planın Free ya da Plus.
• Kurallar dikkate alınmıyor. AGENTS.md ya da CLAUDE.md dosyasının proje kökünde olduğunu veya .cursor/rules içindeki kuralın düzenlenen dosyalara uygulandığını kontrol et.
• CI bir onay isteminde takılıyor. --trust ekle, CURSOR_API_KEY kullan, MCP sunucuları ayarlıysa --approve-mcps ver.

Cursor CLI’ı diğer CLI’ların yanında çalıştırmak

Ekibin zaten Cursor’da yaşıyorsa Cursor CLI iyi bir seçim: editörde ve terminalde aynı modeller, kurallar ve MCP sunucuları. Hook’lar, skill’ler ve eklentiler gibi derin terminal uzantı noktaları istiyorsan Claude Code bu konuda daha güçlü. Cursor’ı tamamen bırakmayı düşünüyorsan Cursor alternatifleri yazımız seçenekleri dürüstçe anlatıyor.

Birçok kişi sonunda Cursor CLI’ı Claude Code, Codex ya da Gemini CLI’ın yanında, her birini ayrı bir görevde çalıştırıyor. Düz terminallerde bu, her ajan için bir sekme ve onları ayrı tutmak için -w worktree’leri demek. AgentVera bu CLI’ları senin kurulumların ve girişlerinle, gerçek terminallerde yan yana çalıştıran bir masaüstü uygulaması. Cursor desteği şöyle çalışır:

• Her ajana kendi sohbeti. Her yeni Cursor ajanı için boş bir sohbet açılır (cursor-agent create-chat) ve ajan hep ona döner; böylece aynı projede birkaç Cursor ajanı birbirine karışmadan çalışır. Cursor editörünün açık olması gerekmez.
• Senin girişin, senin modellerin. Cursor CLI’ın kendi girişini kullanır; model boş bırakılırsa Cursor ayarlarındaki model kullanılır.
• Rol prompt’u değil, kurallar. Cursor CLI’ın ek talimat bayrağı yok, bu yüzden ajanın Rol alanı Cursor’a ulaşmaz. Kalıcı talimatları AGENTS.md ya da kural dosyalarına yaz.
• MCP tek bir yerden. AgentVera’da eklediğin MCP sunucuları ve AgentVera’nın tarayıcısı yerel bir eklenti olarak eklenir ve o çalıştırma için onaylanır.
• Izgara, hesaplar ve sunucular. Cursor’ı çalışma alanı ızgarasında diğer ajanların yanında çalıştır; her tur bittiğinde otomatik kod incelemesi yapılır. Ayarlar → Hesaplar altında birkaç Cursor hesabını yedek sırasına koyabilirsin; bir Cursor ajanı kayıtlı bir SSH sunucusunda da çalışabilir.

Denemek için AgentVera’yı indir.

Toparlarsak

Cursor CLI’ı kullanmak için kur, agent login çalıştır ve bir projede agent başlat. Büyük değişikliklerden önce Shift+Tab ile Plan’a geç, betiklerde agent -p --force kullan, kurallarını AGENTS.md ya da .cursor/rules içinde, araçlarını mcp.json içinde tut. Kullanımın ne kadar yeteceğini Cursor planın belirliyor; modelleri haftalık havuzu düşünerek seç.