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

Adres: https://agentvera.dev/blog/cursor-cli-nasil-kullanilir/ · Yayın: 2026-10-29

Cursor CLI nasıl kullanılır: agent komutunu kur, giriş yap, Agent, Plan ve Ask modları arasında geç, print modunda betikle; model, kurallar ve MCP ayarlarını yap.

**Kısaca:**

- Cursor CLI’ı tek bir curl komutuyla (Windows’ta bir PowerShell satırıyla) kur, agent login ile giriş yap ve projende agent çalıştır. Eski cursor-agent adı hâlâ takma ad olarak çalışıyor.
- agent; Agent, Plan ve Ask modlarıyla etkileşimli bir oturum açar. agent -p betikler ve CI için tek bir görev çalıştırır; dosya değişikliklerini uygulatmak için --force, makine çıktısı için --output-format json ekle.
- CLI, Cursor planındaki kullanım havuzunu, editörle aynı kuralları (.cursor/rules, AGENTS.md, CLAUDE.md) ve aynı mcp.json dosyasını kullanır; Cursor’daki kurulumun aynen taşınır.

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](/blog/claude-code-mu-cursor-mu/ "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

| Platform | Komut |
| --- | --- |
| macOS, Linux, WSL | `curl https://cursor.com/install -fsS \| bash` |
| Windows (PowerShell) | `irm 'https://cursor.com/install?win32=true' \| iex` |

Kurulumu kontrol et:

```bash
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

```bash
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:

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

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

| Mod | Ne yapar | Nasıl geçilir |
| --- | --- | --- |
| Agent | Varsayılan. Dosya düzenler ve komut çalıştırır. | Varsayılan |
| Plan | Koda dokunmadan önce yaklaşımı seninle birlikte çıkarır. | Shift+Tab, `/plan`, `--plan` ya da `--mode=plan` |
| Ask | Salt okuma. Kodu inceler ve sorularını yanıtlar. | `/ask` ya da `--mode=ask` |

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:

```bash
# 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ç

```bash
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.

```markdown
# 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](/blog/claude-md-nasil-yazilir/ "CLAUDE.md nasıl yazılır") yazısı anlatıyor.

## 7. Adım: MCP sunucuları

[MCP sunucuları](/blog/mcp-sunucusu-nedir/ "MCP sunucusu nedir") 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.

```bash
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.

```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.

| Plan | Aylık fiyat | Dahil kullanım | Üçüncü taraf modeller |
| --- | --- | --- | --- |
| Free | 0 $ | Sınırlı | Yok |
| Plus | 8 $ | Temel | Yok |
| Premium | 30 $ | Plus’ın 4 katı | Ön ödemeli krediden API liste fiyatı |
| Super | 100 $ | Plus’ın 15 katı | Ön ödemeli krediden API liste fiyatı |
| Ultra | 200 $ | Plus’ın 50 katı | Ön ödemeli krediden API liste fiyatı |
| Teams | Koltuk başına 30, 100 ya da 200 $ | Koltuğun seviyesine göre | API liste fiyatı artı Cursor’ın token ücreti |

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](/blog/cursor-alternatifleri/ "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](/ajanlar/cursor-agent/ "AgentVera’da Cursor") şö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ı](/ozellikler/calisma-alani/ "Ç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ı](/ozellikler/hesap-gecisi/ "Hesap geçişi") yedek sırasına koyabilirsin; bir Cursor ajanı kayıtlı bir SSH sunucusunda da çalışabilir.

Denemek için [AgentVera’yı indir](/indir/ "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ç.

## Sık sorulanlar

**Cursor CLI komutu agent mı, cursor-agent mı?** İkisi de çalışır. Ekim 2026 itibarıyla ana komut agent; cursor-agent ise eski betikler ve araçlar için takma ad olarak duruyor. Kurulumunu agent --version ile kontrol edebilirsin.

**Cursor CLI ücretsiz mi?** CLI’ı kurmak ücretsiz ve Cursor’ın Free planında sınırlı kullanımla çalışıyor. Ücretli planlar, Cursor’ın kendi modelleri için editörün, CLI’ın ve Cloud Agents’ın ortak kullandığı haftalık bir kullanım havuzu verir. Claude, GPT ve Gemini gibi üçüncü taraf modeller Premium ve üstünü ister; ön ödemeli krediden API liste fiyatıyla faturalanır.

**Cursor CLI AGENTS.md ve CLAUDE.md dosyalarını okur mu?** Evet. CLI, .cursor/rules içindeki kuralların yanında proje kökündeki AGENTS.md ve CLAUDE.md dosyalarını da okur ve kural olarak uygular. Alt klasörlerdeki AGENTS.md dosyaları, ajan o klasörlerdeki dosyaları düzenlerken devreye girer.

**agent -p neden dosyalarımı değiştirmiyor?** Print modunda --force (ya da takma adı --yolo) eklemezsen dosya değişiklikleri yalnızca önerilir, uygulanmaz. Dosya yazması gereken betiklerde agent -p --force kullan; bunu da yalnızca buna gönül rahatlığıyla izin verebileceğin depo ve makinelerde yap.

**Cursor editörünün kurulu ya da açık olması gerekir mi?** Hayır. Cursor CLI ayrı kurulur ve macOS, Linux, WSL ya da Windows’ta herhangi bir terminalde tek başına çalışır. Hesabını, kurallarını ve MCP ayarlarını editörle paylaşır ama editörün açık olmasına ihtiyaç duymaz.

---

**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/