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

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’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:

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

Diğer seçenekler:

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

Windows PowerShell’de:

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

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:

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:

{
  "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:

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:

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

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)

Karar vermeden önce Factory’nin fiyat sayfasına 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 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, bu CLI’ları kendi kurulumların ve girişlerinle gerçek terminallerde yan yana çalıştıran bir masaüstü uygulaması. Droid desteği şö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ı ızgarasında diğer ajanların yanında, her biri kendi git worktree’sinde çalıştır ve değişikliklerini kod incelemesiyle 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.

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ıç, CLI başvuru kılavuzu, droid exec, modeller, MCP, sürüm notları.