İlk ajanını oluştur

Temiz bir kurulumdan çalışan bir AI ajanına. Yeni başlayanların çoğunun kaçırdığı iki konu en üstte: AgentsRoom'un AI CLI'larla ilişkisi ve nasıl oturum açılacağı.

AgentsRoom nasıl çalışır (bu ilki oku)

AgentsRoom kokpit. AI CLI'ler (Claude, Codex, GitHub Copilot CLI, Cursor ve diğer 15 ajan CLI'sı) motorlar. Motorlara kendi komutları aracılığıyla bir kez oturum açarsın, ardından AgentsRoom onları görsel olarak yönetir. AgentsRoom asla tokenlarını, API anahtarlarını veya ChatGPT şifreni saklamaz veya görmez: bunlar her CLI'nin kendi güvenli depolamasında makinende kalır.

ChatGPT" veya "Log in to Anthropic" düğmesine, AgentsRoom'un içinde tasarım. Giriş, CLI'da aşağıdaki 0 adım attığında yaşıyor.

Başlamadan önce

✓Windows 10+, macOS 14+ (Sonoma) veya modern bir 64 bit Linux dağıtımı
✓
En az bir AI kodlama CLI'si yüklü (Claude, Codex, GitHub Copilot CLI, Cursor veya AgentsRoom'un desteklediği diğer 15 ajan CLI'sından herhangi biri)
curl -fsSL https://claude.ai/install.sh | bash
✓Seçilmiş sağlayıcın için aktif bir abonelik veya API key

Adım 0: AI motorunu yükle ve oturum aç

Başlamak için bir sağlayıcı seç (sonra başkalarını da ekleyebilirsin). Her biri için: CLI aracını yükle, oturum açmak için bir kez çalıştır, çalıştığını doğrula. Sonra 1. adıma geç.

Kurulum adımlarını genişletmek için bir sağlayıcı tıkla.

Claude (Anthropic)İlk kez kullanıcılar için önerilen

Works with Works with Works with Works

Claude Pro, Claude Max veya bir Anthropic API anahtarı.

1. Yükleme 1

curl -fsSL https://claude.ai/install.sh | bash

2. oturum aç

claude komutunu herhangi bir terminalde bir kez çalıştır. Anthropic hesabınla oturum açman için bir tarayıcı penceresi açılır.

3. Verify

Yukarıdaki yükleme komutunu çalıştır, sonra CLI'un adını tek başına terminalinde (e.g. type "claude" and press enter). Bir hoşçakal görmek zorundasın. Type "hello" ve bas girer: Eğer bir cevap alırsan, AgentsRoom içinde kullanmaya hazırsın.

Codex (OpenAI / ChatGPT)ChatGPT hesabını kullan

Works with Works with Works with Works

ChatGPT Artı, Pro, Team veya Enterprise veya OpenAI API key.

1. Yükleme 1

curl -fsSL https://chatgpt.com/codex/install.sh | sh

2. oturum aç

codex'i herhangi bir terminalde bir kez çalıştır. Bir tarayıcı penceresi açılır. chatgpt.com'da kullandığın ChatGPT hesabınla oturum aç.

3. Verify

Antigravity CLI (Google)Ücretsiz katman mevcut

Works with Works with Works with Works

Bir Google hesabı (tarayıcıdan oturum açma). Cömert bir ücretsiz katman mevcuttur.

1. Yükleme 1

curl -fsSL https://antigravity.google/cli/install.sh | bash

2. oturum aç

Herhangi bir terminalde antigravity komutunu bir kez çalıştır. Google ile oturum açmak için bir tarayıcı penceresi açılır.

3. Verify

OpenCodeKendi sağlayıcını getir

Works with Works with Works with Works

Yapıladığın herhangi bir sağlayıcı: Anthropic, OpenAI, OpenRouter ve daha fazlası.

1. Yükleme 1

curl -fsSL https://opencode.ai/v2/install | bash

2. oturum aç

opencode komutunu çalıştır, ardından bir sağlayıcı anahtarı veya OpenCode Go aboneliği eklemek için /connect komutunu kullan.

3. Verify

Grok Build (xAI)256K bağlam

Works with Works with Works with Works

Bir xAI hesabı (tarayıcıdan giriş) veya headless kullanım için bir Grok API key.

1. Yükleme 1

curl -fsSL https://x.ai/cli/install.sh | bash

2. oturum aç

Herhangi bir terminalde grok komutunu bir kez çalıştır. xAI girişi için bir tarayıcı penceresi açılır. Headless kullanım için bunun yerine GROK_CODE_XAI_API_KEY ortam değişkenini ayarla.

3. Verify

CursorEditörün, terminalde

Works with Works with Works with Works

Bir Cursor hesabı. Mevcut planın CLI'yi kapsar; ücretsiz katman daha küçük bir model kümesine ulaşır.

1. Yükleme 1

curl https://cursor.com/install -fsS | bash

2. oturum aç

Tarayıcın üzerinden giriş yapmak için cursor-agent login komutunu çalıştır. Yapılandırma ~/.cursor içinde bulunur.

3. Verify

oh-my-pi60'tan fazla arka uç

Works with Works with Works with Works

Zaten ödediğin her şey: Anthropic, OpenAI, Google, xAI, Z.ai, DeepSeek ve daha fazlasında oturum açar ya da düz bir API anahtarı kabul eder.

1. Yükleme 1

curl -fsSL https://omp.sh/install | sh

2. oturum aç

omp komutunu bir kez çalıştır, ardından bir sağlayıcı bağlamak için /login kullan. Yapılandırma ~/.omp içinde bulunur.

3. Verify

Kimi (Moonshot AI)1M'e kadar bağlam

Works with Works with Works with Works

Bir Kimi hesabı (tarayıcıdan giriş) veya Moonshot AI Open Platform API anahtarı.

1. Yükleme 1

curl -fsSL https://code.kimi.com/kimi-code/install.sh | bash

2. oturum aç

Herhangi bir terminalde kimi komutunu bir kez çalıştır, ardından Kimi hesabınla giriş yapmak için /login yaz. Yapılandırma ~/.kimi-code içinde bulunur.

3. Verify

FreebuffAnahtar gerekmez

Works with Works with Works with Works

Yok. Hizmet ücretsizdir ve turlar arasında gösterilen metin reklamlarıyla finanse edilir.

1. Yükleme 1

npm install -g freebuff

2. oturum aç

Projende freebuff komutunu çalıştır. Bir Codebuff hesabı bağlamak istersen freebuff login komutu mevcuttur.

3. Verify

Pi (Earendil)Minimalist ve genişletilebilir

Works with Works with Works with Works

Zaten ödediğin her şey: Pi; Anthropic, OpenAI, Google, GitHub Copilot ve daha birçok sağlayıcıda oturum açar ya da düz bir API anahtarı kabul eder.

1. Yükleme 1

curl -fsSL https://pi.dev/install.sh | sh

2. oturum aç

pi komutunu bir kez çalıştır, ardından bir sağlayıcı bağlamak için /login kullan. Yapılandırma ~/.pi/agent içinde bulunur.

3. Verify

DevinTek plan, çok model

Works with Works with Works with Works

Bir Devin veya Windsurf planı, ücretsiz katman dahil. Aynı abonelik Claude, GPT, Gemini ve Cognition'ın SWE modellerini kapsar.

1. Yükleme 1

curl -fsSL https://cli.devin.ai/install.sh | bash

2. oturum aç

Tarayıcın üzerinden giriş yapmak için devin auth login komutunu çalıştır. Yapılandırma ~/.config/devin içinde bulunur.

3. Verify

Command CodeAçık ve tescilli modeller arasından seç

Works with Works with Works with Works

Bir Command Code hesabı veya COMMAND_CODE_API_KEY API anahtarı gerekir. Model erişimi ve kullanım sınırları sağlayıcı hesabına bağlıdır.

1. Yükleme 1

npm install -g command-code@latest

2. oturum aç

Oturum açmak için command-code login komutunu çalıştır veya ortamında COMMAND_CODE_API_KEY tanımla. Ardından projende command-code çalıştır.

3. Verify

Mistral VibeAvrupa modelleri

Works with Works with Works with Works

Bir Mistral hesabı (Pro veya Team) ya da bir Mistral API anahtarı.

1. Yükleme 1

command -v uv >/dev/null 2>&1 || curl -LsSf https://astral.sh/uv/install.sh | sh; . "$HOME/.local/bin/env" 2>/dev/null; uv tool install --python 3.12 mistral-vibe

2. oturum aç

Mistral API anahtarını kaydetmek için vibe --setup komutunu bir kez çalıştır, ardından başlamak için vibe komutunu çalıştır. Yapılandırma ~/.vibe/config.toml dosyasında saklanır.

3. Verify

Muse Code (Meta)Terminalinde Muse Spark

Works with Works with Works with Works

Muse Code erişimi olan bir Meta hesabı veya META_API_KEY API anahtarı gerekir. Erişim ve kullanım sınırlarını Meta belirler.

1. Yükleme 1

curl -fsSL https://dev.meta.ai/install.sh | sh

2. oturum aç

Oturum açmak için muse login komutunu çalıştır veya ortamında META_API_KEY tanımla. Ardından projende muse çalıştır.

3. Verify

AiderGüç kullanıcıları

Works with Works with Works with Works

API key (Anthropic, OpenAI, DeepSeek ve daha fazlası).

1. Yükleme 1

command -v uv >/dev/null 2>&1 || curl -LsSf https://astral.sh/uv/install.sh | sh; . "$HOME/.local/bin/env" 2>/dev/null; uv tool install --python 3.12 aider-chat

2. oturum aç

Hiçbir giriş komutu yok. API key'ini kabuk profilinde bir ortam değişkeni olarak ayarla, örneğin: export ANTHROPIC_API_KEY=sk-...

3. Verify

Amp (Sourcegraph)Modeller değil, modlar

Works with Works with Works with Works

Bir Amp hesabı (tarayıcıdan giriş) veya bir AMP_API_KEY belirteci.

1. Yükleme 1

curl -fsSL https://ampcode.com/install.sh | bash

2. oturum aç

Giriş yapmak için herhangi bir terminalde amp login komutunu bir kez çalıştır. Ayarlar ~/.config/amp içinde bulunur.

3. Verify

MiniMax Code (MiniMax)M serisi modeller

Works with Works with Works with Works

Bir MiniMax hesabı (tarayıcıdan giriş) veya bir MiniMax API anahtarı.

1. Yükleme 1

curl -fsSL https://filecdn.minimax.chat/public/install.sh | bash

2. oturum aç

Bir terminalde mcode login --region global komutunu çalıştırın (Çin anakarası hesabı için mcode login). Yapılandırma ~/.minimax içindedir.

3. Verify

ZCode (topluluk istemcisi)GLM modelleri, Z.ai'nin değil

Works with Works with Works with Works

Bir Z.ai veya BigModel planı ya da bir API anahtarı. Bu topluluk istemcisi Z.ai tarafından yayımlanmaz veya onaylanmaz.

1. Yükleme 1

npm install -g zcode-app-cli@latest

2. oturum aç

Bir terminalde zcode komutunu bir kez çalıştırın, ardından Z.ai veya BigModel hesabınızla giriş yapmak için /login yazın. Node.js 22.19 veya daha yenisi gerekir. Yapılandırma ~/.zcode içindedir.

3. Verify

Bu adımda Stuck? Bu sayfanın alt kısmında sorun bölümü gör.

AgentsRoom

İşletim sistemine uygun yükleyiciyi indir: macOS için .dmg, Windows için .exe veya Linux için AppImage. Dosyayı aç, kurulum adımlarını izle, ardından AgentsRoom'u başlat.

Tip: AgentsRoom otomatik kontroller güncelleştirmeler için. Yeni bir versiyon mevcut olduğunda bilgilendirilecektir.

İlk projeni oluştur

Kenar çubuğunda + düğmesine tıkla. Makinende herhangi bir klasör seç. Bu, AI ajanlarının çalışacakları yerdir. Projeni belirle ve bir bölgeye tayin et.

Tip: Her proje gerçek bir klasöre eşlenir. Ajanlar, seçtiğin sağlayıcının CLI'sini o dizinde çalıştırır, tıpkı terminalinde yapacağın gibi.

İlk ajanını ekle

Projenin içinde, Ajan Ekle'ye tıkla. Bir rol seç (Fullstack iyi bir başlangıçtır), ardından bir sağlayıcı (adım 0'da kurduğun motor), sonra bir model (Claude için Sonnet önerilir) seç. İsteğe bağlı olarak bir başlangıç istemi yaz ve Başlat'a tıkla. Terminal açılır ve CLI'yi senin için çalıştırır.

Tip: Terminal boş görünüyorsa veya bir giriş ekranı gösterirse, CLI adım 0 henüz imzalanmadı. Düzenli bir terminal aç, kaude veya codex (veya sağlayıcının komutunu) bir kez aç, imzayı tamamla, sonra geri gel.

Çalışmayı izle

Terminal canlı çıktı gösterir: okunan her dosya, yapılan her düzenleme. Durum değişir: çalışıyor, sonra tamamlandı. Tamamlandığında bir masaüstü bildirim alırsın.

Tip: Birden çok ajan başlatabilirsin. Her biri kendi terminalini alır ve bağımsız olarak çalışır.

Kurulumunu özelleştir

Edit CLAUDE.md doğrudan AgentsRoom'dan ajanlara daha iyi bağlam vermek için. Değişim modelleri, izinleri ayarlama, kancaları yapılandır. Farklı roller veya sağlayıcılarla daha fazla ajan ekle.

Tip: Opus mimarlık için. Sonnet61X19Haiku61Haiku testler gibi hızlı görevler için.

İpuçları ve hileler

1.Mimari kararlar için Opus'u, günlük kodlama için Sonnet'i, hızlı görevler için Haiku'yu kullan

2.Daha iyi düzen için projeleri bölgelere göre grupla (İş, Kişisel, Yan projeler)

3.Ajanlara daha iyi proje bağlamı vermek için AgentsRoom'dan CLAUDE.md dosyasını düzenle.

4.Masaüstü bildirimlerini etkinleştir, böylece ajanlar çalışırken başka işlerle ilgilenebilirsin

5.Proje başına bir ajanla başla, rahatladığın kadar daha fazla ekle

Sorun Giderme

Ajan terminalim boş görünüyor veya takılı kaldı

Çoğu zaman sorun, CLI'de oturum açılmamış olmasından kaynaklanır. Terminalini aç (macOS'te Terminal, Windows'ta PowerShell veya Windows Terminal, Linux'ta terminal emülatörün), CLI'nin komutunu tek başına çalıştır (claude, codex, antigravity, opencode), tarayıcıdaki oturum açma işlemini tamamla, ardından AgentsRoom'a geri dönüp aracıyı yeniden başlat. AgentsRoom'un kendine ait bir oturum açma ekranı yoktur: kimlik doğrulama CLI tarafında gerçekleşir.

command not found: claude (veya codex, antigravity vb.)

CLI yüklü değil veya kabuk PATH'in onu görmüyor. Yukarıdaki adım 0'dan yükleme komutunu yeniden çalıştır. Eğer nvm kullanıyorsan, CLI'yi günlük kullandığın Node sürümüyle yükle, aksi takdirde ikili dosya AgentsRoom başlatıldığında PATH'te olmayacaktır.

AgentsRoom içinde ChatGPT veya Claude'a giriş yapmak için bir düğme göremiyorum

Bu bilinçli bir tercih. AgentsRoom, CLI'ların üzerinde çalışan bir arayüzdür ve kimlik bilgilerini asla doğrudan işlemez. Oturum açma, CLI içinde bir kez yapılır (bir terminalde claude veya codex çalıştır), ardından AgentsRoom bu oturumu kullanır. AgentsRoom'u token'larını ele geçiren araçlardan daha güvenli kılan da budur.

Ajan "Düşünmek" üzerine sıkıştı

Aboneliğinin veya API key'inin seçili sağlayıcı için etkin olduğunu kontrol et. Gerçek hata mesajını görmek için CLI'ı doğrudan terminalinde çalıştırmayı dene: Claude veya OpenAI bazen oturumları sessizce kısıtlar ya da sonlandırır.

Kenar çubuğunda hiç proje görünmüyor

Projeyi oluştururken geçerli bir klasör seçtiğinden emin ol. Klasörün diskte bulunması gerekir. Bir proje eklendiği halde henüz görünmüyorsa AgentsRoom'u yeniden başlat.

CLI'u kurdum ama AgentsRoom hala "görmüyor" diyor

AgentsRoom, PATH'ini etkileşimli terminalinden değil, giriş kabuğundan (login shell) devralır. AgentsRoom'dan tamamen çık, yeni bir terminal aç, CLI'nin yeni bir kabuk oturumundan çağrılabildiğini doğrula (which claude), sonra AgentsRoom'u yeniden başlat.