# Droid nasıl kullanılır? Factory Droid CLI için adım adım rehber

Adres: https://agentvera.dev/blog/droid-nasil-kullanilir/ · Yayın: 2026-11-14

Factory Droid terminalde nasıl kullanılır: kurulum, giriş, model seçimi, otonomi seviyeleriyle droid exec, AGENTS.md, MCP ve özel droid’ler tek rehberde.

**Kısaca:**

- curl -fsSL https://app.factory.ai/cli | sh ile (ya da brew install --cask droid ile) kur, bir projede droid çalıştır, tarayıcıdan giriş yap ve işi anlat. Droid dosya düzenlemeden ya da komut çalıştırmadan önce sorar.
- Betiklerde ve CI’da droid exec varsayılan olarak salt okunurdur; --auto low düzenlemeye, medium ayrıca kurulum, build, test ve commit’e, high push ve deploy’a izin verir. Tarayıcısız ortamda FACTORY_API_KEY kullan.
- Free plan kendi çıkarımınla (ChatGPT, Copilot, OpenRouter ya da API anahtarları) çalışır; Pro, Kasım 2026 itibarıyla aylık 20 $. Kurallar AGENTS.md’ye, ayarlar ve MCP sunucuları ~/.factory/ altına gider.

Factory’nin kodlama ajanı Droid’i kullanmak için CLI’ı `curl -fsSL https://app.factory.ai/cli | sh` ile kurarsın, bir projenin içinde `droid` çalıştırırsın, tarayıcıdan giriş yapar ve işi anlatırsın. **Droid bir dosyayı düzenlemeden ya da bir komut çalıştırmadan önce sorar; betikler ve CI için de sen otonomisini yükseltene kadar salt okunur kalan `droid exec` var.**

Bu rehber, Kasım 2026 itibarıyla (sürüm 1.12) Droid CLI’ı anlatıyor: kurulum, giriş, modeller, etkileşimli oturum, `droid exec` ve otonomi seviyeleri, AGENTS.md, MCP sunucuları, özel droid’ler ve maliyet.

## Droid nedir?

Droid, [Factory](https://factory.com "Factory")’nin terminalde çalışan kodlama ajanı. Kod tabanını okur, değişiklik önerir ve sen onayladıktan sonra uygular. Aynı ajan Factory’nin masaüstü ve web uygulamalarında, IDE entegrasyonlarında ve bir SDK üzerinden de çalışıyor. Sürüm 1.0, 29 Ekim 2026’da çıktı; yeni sürümler haftada birkaç kez geliyor.

Droid tek bir model sağlayıcısına bağlı değil. Anthropic, OpenAI, Google ve xAI modellerinin yanında Factory’nin “Droid Core” adı altında topladığı açık ağırlıklı modeller sunuyor; kendi uç noktalarını da ekleyebilirsin.

## 1. Adım: CLI’ı kur

macOS ya da Linux’ta:

```bash
curl -fsSL https://app.factory.ai/cli | sh
```

Diğer seçenekler:

```bash
brew install --cask droid      # Homebrew
npm install -g droid           # npm
```

Windows PowerShell’de:

```powershell
irm https://app.factory.ai/cli/windows | iex
```

Linux’ta giriş için ayrıca `xdg-utils` gerekir (`sudo apt-get install xdg-utils`). Sonradan güncellemek için `droid update` çalıştır.

## 2. Adım: giriş yap

```bash
cd my-project
droid
```

İlk çalıştırmada bir Factory hesabıyla giriş yapman için tarayıcı açılır. CI ve tarayıcısı olmayan diğer makineler için Factory ayarlarından bir API anahtarı oluştur ve onu dışa aktar:

```bash
export FACTORY_API_KEY=fk-...
```

## 3. Adım: bir oturumda çalış

İşi sade bir dille anlat. Droid ne yapmayı planladığını açıklar, sonra her düzenleme ya da komuttan önce sorar. İşine yarayacak tuşlar ve komutlar:

- `Shift+Tab`, normal mod ile Droid’in kodu değiştirmeden önce bir plan yazdığı spec modu arasında geçiş yapar.
- `!` ile bir kabuk komutunu kendin çalıştırırsın; `?` kısayolları listeler.
- `/model` modeli değiştirir, `/settings` ayarları açar, `/review` değişikliklerin incelenmesini ister.
- `/compress` uzun bir konuşmayı kısaltır; `/sessions` önceki oturumları listeler.

Daha sonra kaldığın yere dönmek için `droid --resume` (ya da `droid --resume <id>`) çalıştır. `droid search "checkout bug"` eski bir oturumu metninden bulur, `--fork <id>` de bir oturumu kopyalar.

## 4. Adım: model seç

Modeli bir oturumda `/model` ile, komut satırında `-m` ile ya da ayarlardaki `model` anahtarıyla değiştirirsin. Ücretli planlarda her model kullanım hakkından bir çarpanla düşer: Kasım 2026 itibarıyla Claude Opus 5.5 1,6x, Claude Sonnet 5.5 0,8x, Claude Haiku 5.5 de 0,04x sayılıyor. Rutin düzenlemeler için küçük, tasarım ve hata ayıklama için büyük bir model kullan.

Kendi anahtarını kullanmak için `~/.factory/settings.json` dosyasına özel bir model ekle:

```json
{
  "customModels": [
    {
      "model": "claude-sonnet-5-5",
      "displayName": "Sonnet (my key)",
      "baseUrl": "https://api.anthropic.com",
      "apiKey": "${ANTHROPIC_API_KEY}",
      "provider": "anthropic"
    }
  ]
}
```

`provider` değeri `anthropic`, `openai`, `generic-chat-completion-api` ya da `bedrock-converse` olur. Anahtarlar senin makinende kalır.

## 5. Adım: droid exec ve otonomi seviyeleri

`droid exec` tek bir işi sohbet olmadan çalıştırır; betiklerde ve CI’da tam da istediğin şey bu:

```bash
droid exec "summarize the changes on this branch"
droid exec --auto low "fix the failing unit test in price.test.ts"
droid exec -f task.md -o json --auto medium
```

Varsayılan olarak salt okunurdur. Neler yapabileceğini sen genişletirsin:

| Seviye | Neye izin verir |
|---|---|
| (varsayılan) | Yalnızca okuma |
| `--auto low` | Dosya düzenleme |
| `--auto medium` | Ayrıca kurulum, build, test, commit, checkout ve pull |
| `--auto high` | Ayrıca push ve deploy |

`--skip-permissions-unsafe` tüm onay sorularını kapatır; onu atılacak container’lar için sakla. Çıkış kodu 0’ın görevin başarılı olduğunu değil, Droid’in işini bitirdiğini gösterdiğini unutma; CI’da sonucu ayrıca kontrol et. Etkileşimli oturumlar için ayarlarda `sessionDefaultSettings.autonomyLevel` ile varsayılan bir seviye ve daha ince `permissionRules` (allow, ask, block) tanımlayabilirsin.

## 6. Adım: AGENTS.md ve ayarlar

Droid, `AGENTS.md` dosyasını deponun talimatları olarak okur. Kısa tut: teknoloji yığını, testlerin nasıl çalıştırılacağı, nelere dokunulmayacağı ve “bitti”nin ne anlama geldiği. [CLAUDE.md ve AGENTS.md](/blog/claude-md-nasil-yazilir/ "CLAUDE.md ve AGENTS.md") rehberimiz içine ne yazacağını anlatıyor.

Ayarlar senin için `~/.factory/settings.json`, proje için `.factory/settings.json` dosyasında durur; her birinin, commit etmediğin geçersiz kılmalar için bir `settings.local.json` dosyası olur.

## 7. Adım: MCP sunucuları ve özel droid’ler

MCP sunucularını komut satırından ekle:

```bash
droid mcp add docs https://example.com/mcp --type http
droid mcp add memory "npx -y @modelcontextprotocol/server-memory"
```

Bunlar `~/.factory/mcp.json` (proje için `.factory/mcp.json`) içinde `mcpServers` altında kaydedilir. Bir oturumda OAuth girişleri dahil hepsini `/mcp` ile yönetirsin.

Özel droid’ler alt ajanlardır: `.factory/droids/` ya da `~/.factory/droids/` içinde YAML başlıklı (`name`, `description`, `model`, `tools` ve diğerleri) bir Markdown dosyası. Droid onlara Task aracıyla iş devreder, `/droids` de onları yönetir. Ucuz bir model üzerinde küçük bir “test yazarı” ya da “inceleyici” droid’i iyi bir başlangıç olur.

## Droid’in maliyeti (Kasım 2026 itibarıyla)

| Plan | Fiyat | Notlar |
|---|---|---|
| Free | 0 $ | Çıkarımı sen getirirsin: ChatGPT, Copilot, OpenRouter ya da kendi anahtarların |
| Pro | Aylık 20 $ | Tüm modeller, masaüstü uygulaması, CLI ve SDK |
| Plus | Aylık 100 $ | Pro’nun yaklaşık 5 katı kullanım |
| Max | Aylık 200 $ | Pro’nun yaklaşık 10 katı kullanım |
| Teams | Aylık 60 $ + koltuk başına 40 $ | En fazla 10 koltuk |

Karar vermeden önce [Factory’nin fiyat sayfasına](https://factory.com/pricing "Factory fiyatları") bak; planlar sık değişiyor.

## Sık yapılan hatalar

- **Eski belge bağlantıları.** Belgeler docs.factory.ai’den [docs.factory.com](https://docs.factory.com "Factory belgeleri") adresine taşındı; kurulum adresleri hâlâ app.factory.ai kullanıyor.
- **exec’i fazla erken yüksek otonomiyle çalıştırmak.** CI işlerine `--auto low` ile başla, seviyeyi yalnızca ihtiyaç duyan adımlarda yükselt.
- **Çıkış kodu 0’a güvenmek.** Bu yalnızca çalıştırmanın bittiğini gösterir. Ardından testleri ya da diff’i kontrol et.
- **`-r` iki farklı anlama geliyor.** `droid` içinde `-r` bir oturuma geri döner; `droid exec` içinde akıl yürütme düzeyini belirler. Sürprizlerle karşılaşmamak için `--resume`’u açık açık yaz.

## Droid’i diğer CLI’ların yanında AgentVera’da çalıştırmak

Tek ajanın Droid ise Factory’nin kendi uygulamaları sana yetebilir. İş, Droid aynı projede Claude Code, Codex ya da Gemini CLI’ın yanında çalışınca zorlaşıyor. [AgentVera](/ "AgentVera"), bu CLI’ları kendi kurulumların ve girişlerinle gerçek terminallerde yan yana çalıştıran bir masaüstü uygulaması. [Droid desteği](/ajanlar/factory-droid/ "AgentVera’da Factory Droid") şöyle çalışıyor:

- **Her ajana bir oturum.** AgentVera, Droid’in oluşturduğu oturumu bulur ve sonraki açılışlarda `droid --resume <id>` ile yeniden açar; böylece konuşma uygulama yeniden başlasa da kaybolmaz.
- **Model, efor ve rol.** Ajan için seçtiğin model ve efor bir ayar dosyasıyla, ajanın rolü de `--append-system-prompt` ile aktarılır.
- **Senin girişin ya da API anahtarların.** Droid, Factory girişini korur. Ayarlar → Hesaplar bölümünden `FACTORY_API_KEY` hesapları ekleyip her ajana kendi hesabını verebilirsin.
- **Paneller, worktree’ler ve inceleme.** Droid’i [çalışma alanı](/ozellikler/calisma-alani/ "Çalışma alanı") ızgarasında diğer ajanların yanında, her biri kendi git worktree’sinde çalıştır ve değişikliklerini [kod incelemesiyle](/ozellikler/kod-incelemesi/ "Kod incelemesi") kontrol et.

Ücretsiz plan 18 ajana kadar, MCP, Git, Docker, SSH, kod incelemesi ve token tasarrufu içerir. Pro aylık 9,99 $; daha önce hiç deneme kullanmadıysan uygulamaya ilk girişin Pro’yu kart istemeden 7 gün açar. Denemek için [AgentVera’yı indir](/indir/ "AgentVera’yı indir").

## Toparlarsak

Droid’e başlamak iki komut alır: kurulum betiği ve `droid`. Sonrasında önemli olan kontrol: etkileşimli oturumları onaylı modda tut, `droid exec`’e `--auto low` ile başla, projenin kurallarını `AGENTS.md`’ye yaz ve her iş için modeli kullanım çarpanını göz önünde tutarak seç.

Kaynaklar: [Droid hızlı başlangıç](https://docs.factory.com/cli/getting-started/quickstart "Droid hızlı başlangıç"), [CLI başvuru kılavuzu](https://docs.factory.com/docs/droid-cli/cli-reference "Droid CLI başvuru kılavuzu"), [droid exec](https://docs.factory.com/docs/droid-exec/overview "droid exec"), [modeller](https://docs.factory.com/docs/models "Droid modelleri"), [MCP](https://docs.factory.com/docs/harness/mcp "Droid MCP"), [sürüm notları](https://docs.factory.com/changelog/cli-updates "Droid CLI sürüm notları").

## Sık sorulanlar

**Factory Droid ücretsiz mi?** Çıkarımı senin getirdiğin 0 $’lık bir Free plan var: ChatGPT, GitHub Copilot ya da OpenRouter ile giriş yaparsın veya kendi API anahtarlarını eklersin. Kasım 2026 itibarıyla ücretli planlar aylık 20 $ ile Pro, 100 $ ile Plus ve 200 $ ile Max; her basamakta kullanım hakkı artıyor.

**Droid ile kendi API anahtarımı kullanabilir miyim?** Evet. ~/.factory/settings.json dosyasına model adı, temel URL, sağlayıcı ve anahtarla bir customModels girdisi ekle (anahtarı bir ortam değişkeninden okuyabilir). Anahtarlar senin makinende kalır; özel modeller CLI’da da masaüstü uygulamasında da çalışır.

**droid ile droid exec arasındaki fark ne?** droid, her düzenleme ya da komuttan önce soran etkileşimli bir oturum açar. droid exec ise betikler ve CI için tek bir işi sohbet olmadan çalıştırır. Sen otonomiyi --auto low, medium ya da high ile yükseltmedikçe salt okunurdur.

**Droid AGENTS.md okur mu?** Evet. AGENTS.md, Droid’in bir depo için okuduğu talimat dosyasıdır: teknoloji yığınını, test komutunu, kuralları ve dokunulmaması gereken yerleri oraya yaz.

**Bir Droid oturumuna nasıl geri dönerim?** Son oturumlardan birini seçmek için droid --resume, belirli bir oturum için droid --resume <id> çalıştır. droid search "metin" eski oturumları bulur, --fork <id> de başka bir yön deneyebilmen için bir oturumu kopyalar.

---

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