# Ajanslar için yapay zeka kodlama ajanları ve müşteri projeleri

Adres: https://agentvera.dev/blog/ajanslar-icin-yapay-zeka-kodlama-ajanlari/ · Yayın: 2026-11-09

Bir ajans Claude Code, Codex ve diğer kodlama ajanlarını hesapları, bağlamı, sırları ve maliyetleri karıştırmadan birden çok müşteri projesinde nasıl kullanır?

**Kısaca:**

- Her müşteriye bir klasör, bir talimat dosyası ve müşteri isterse bir ajan hesabı. Karışıklıkların çoğu modelden değil, paylaşılan bağlamdan çıkar.
- Her müşteriye kendi CLAUDE.md ya da AGENTS.md dosyasını ver: stack, kurallar ve ajanın asla dokunmaması gerekenler. Ajanlar bu dosyayı her oturumun başında okur.
- Token kullanımını ajan başına izle ve her diff’i müşteriye ulaşmadan önce incele. Kodu ajan yazar; teslim edilenin sorumluluğu yine ajanstadır.

**Yapay zeka kodlama ajanlarını birden çok müşteri projesinde çalıştırmak için her müşteriye kendi klasörünü, kendi talimat dosyasını ve sözleşme gerektiriyorsa kendi ajan hesabını ver, sonra her ajanı yalnızca o müşterinin klasörünün içinde başlat.** Ajansların ajanlarla yaşadığı sorunların çoğu (yanlış kurallar, sızan bağlam, sürpriz maliyetler) modelden değil, paylaşılan kurulumdan kaynaklanır.

Bu rehber, Claude Code, Codex ya da başka bir kodlama ajanını zaten bir projede kullanan ve şimdi beş projede kullanmak isteyen küçük ajanslar ve serbest çalışanlar için. Müşteri başına kurulumu, maliyetleri görünür tutmayı, teslimden önce incelemeyi ve tüm bunları tek pencerede nasıl tutacağını anlatıyor.

## Tüm müşteriler için tek kurulum neden bozulur

Bir kodlama ajanı gördüğüyle çalışır: başladığı klasör, oradaki talimat dosyaları ve oturum açtığı hesap. Bunlar müşteriler arasında paylaşıldığında üç şey ters gider:

- **Kurallar sızar.** Ajan, önceki müşterinin kodundan ya da talimatlarından alışkanlıklar edinir ve bunları sıradaki müşteriye uygular.
- **Maliyetler bulanıklaşır.** Her şey için tek hesap ve tek kullanım çubuğu, hangi müşterinin ne kadar kullandığını ayırt edemeyeceğin anlamına gelir.
- **Erişim olması gerekenden geniştir.** Üst klasörde başlatılan bir ajan, altındaki tüm müşteri klasörlerini, `.env` dosyaları dahil, okuyabilir.

Çözüm sıkıcı ama işe yarıyor: her müşteriye bir sınır.

## Adım 1: her müşteriye bir klasör, ajanları onun içinde başlat

Her müşteriyi kendi deposuyla kendi klasöründe tut:

```
~/clients/
  acme-shop/
  dental-clinic-site/
  logistics-dashboard/
```

Ajanı her zaman tek bir müşteri klasörünün içinden başlat, asla `~/clients/` klasöründen değil. Claude Code, Codex ve Gemini CLI, başlattığın klasörü proje olarak kabul eder. Aynı müşteride ikinci bir ajana ihtiyacın varsa, örneğin biri bir hatayı düzeltirken diğeri yeni bir sayfa yapıyorsa, aynı dosyaları düzenlemesinler diye ona bir [git worktree](/blog/git-worktree-paralel-gelistirme/) ver.

## Adım 2: her müşteri için bir talimat dosyası yaz

Her kodlama ajanı oturumun başında bir proje talimat dosyası okur: Claude Code için `CLAUDE.md`, Codex ve diğer pek çoğu için `AGENTS.md`. Her müşteri klasörünün köküne bir tane koy. Kısa ve net tut:

```markdown
# Müşteri: online mağaza (Shopify teması + Node API)

- Stack: Liquid teması, Node 22, Postgres. Testler: npm test.
- Müşterinin tarzı: sormadan yeni bağımlılık yok; Türkçe ve İngilizce metinler.
- Asla dokunma: ödeme ayarları, /infra, production .env dosyaları.
- Bitti demek: testler geçiyor, müşteri için kısa bir özetle pull request açılmış.
```

Bu dosya, tahmin yürüten bir ajanla müşterinin kurallarına uyan bir ajan arasındaki farktır. Müşteri bir kuralı değiştirdiğinde prompt’larını değil, dosyayı değiştir.

## Adım 3: müşteri başına hesaba karar ver

Bazı müşteriler ajanın hangi hesapla çalıştığını umursamaz. Diğerleri işin kendi ödedikleri bir hesapta yapılmasını ister ya da kodlarının onaylamadıkları bir sağlayıcıya gönderilmesini yasaklar. Önce sözleşmeye bak.

Bir müşterinin kendi oturumuna ihtiyacı varsa o hesaba kendi yapılandırma klasörünü ver. Claude Code klasörünü `CLAUDE_CONFIG_DIR`’dan, Codex `CODEX_HOME`’dan okur; yani iki klasör, aynı makinede çıkış yapmadan iki oturum demektir. [Claude Code hesabını değiştirme](/blog/claude-code-hesap-degistirme/) rehberimiz elle kurulumu adım adım gösteriyor.

## Adım 4: gizli bilgileri erişim dışında tut

Ajanlar bir projeyi anlamak için dosya okur ve `.env` de bir dosyadır. Her müşteri için:

- production kimlik bilgilerini çalışma klasörünün dışında tut; test anahtarlı bir geliştirme `.env` dosyası kullan;
- hassas yolları talimat dosyasına “asla dokunma” başlığı altında ekle;
- ajanın izin ayarlarını kullan ki deploy eden, migration çalıştıran ya da silen komutlardan önce sorsun.

## Adım 5: token kullanımını müşteri başına ölç

Yapay zeka kullanımını faturalamayı düşünüyorsan ya da sadece hangi müşterinin kârlı olduğunu bilmek istiyorsan, ilk günden ajan başına ve klasör başına ölç. İki basit kural işe yarar:

- her ajana günlük bir üst sınır koy ki takılıp kalan bir döngü bir gecede müşterinin bütçesini yakmasın;
- rutin düzenlemeler için ucuz modeli, güçlü modeli ise yalnızca tasarım ve hata ayıklama için kullan.

[Claude Code limitleri](/blog/claude-code-limit/) yazımız 5 saatlik ve haftalık limitlerin nasıl işlediğini anlatıyor; birkaç müşteri tek bir aboneliği paylaştığında bu önem kazanır.

## Adım 6: müşteri görmeden önce her diff’i incele

Ajanların bir branch’te çalışıp pull request açmasına izin ver. Diff’i oku, testleri çalıştır ve sayfayı kendin kontrol et. Müşteriler bir ajanın yazdığı kod için ödeme yapmaz; güvendikleri birinin kontrol ettiği kod için ödeme yapar. Her pull request için yazılı kısa bir özet, müşteriye haftalık durum güncellemesini de kolaylaştırır.

## Tüm bunları AgentVera ile tek pencerede yapmak

Yukarıdaki adımlar düz terminallerle de çalışır. Zor olan, beş müşteriyi ve on ajanı göz önünde tutmak. [AgentVera](/), Claude Code, Codex, Gemini CLI ve diğer ajanları yan yana çalıştıran macOS, Windows ve Linux için bir masaüstü uygulaması; her ajan senin kurulumun ve oturumunla gerçek bir terminalde çalışır. Ajans işi için önemli olan kısımlar:

- **Proje başına bir ızgara.** Her müşteri klasörünün kendi ajan seti olur ve müşteriler arasında durumlarını kaybetmeden geçiş yaparsın. Bkz. [çalışma alanı](/ozellikler/calisma-alani/).
- **Ajan başına bir hesap.** Hesapları Ayarlar → Hesaplar’a ekle ve ajan oluştururken birini seç; böylece bir müşterinin ajanları her zaman doğru oturumla çalışır. Bkz. [hesaplar](/ozellikler/hesap-gecisi/).
- **Ajan başına token sınırı.** Ajan başına, tur başına ve gün başına sınırlar, %80’de uyarı; sınıra gelince ajan durur ama konuşmasını korur. Bkz. [token bütçesi](/ozellikler/token-butcesi/).
- **Teslimden önce kod incelemesi.** Ajanın değişikliklerini müşterinin deposuna gitmeden önce uygulamanın içinde incele. Bkz. [kod incelemesi](/ozellikler/kod-incelemesi/).

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

## Özetle

Her müşterinin net bir sınırı olduğunda ajanlar çok sayıda müşteriye ölçeklenir: kendi klasörü, kendi talimat dosyası, doğru hesap, erişim içinde production gizli bilgisi olmaması, kendi token sayımı ve teslimden önce bir insan incelemesi. Bunu her müşteri için bir kez kur; altıncı müşteriyi eklemek bir haftalık temizlik değil, birkaç dakika sürer.

Kaynaklar: [Claude Code settings](https://code.claude.com/docs/en/settings "Claude Code settings"), [AGENTS.md](https://agents.md/ "AGENTS.md format").

## Sık sorulanlar

**Bir ajans tüm müşteri projeleri için tek bir Claude Code hesabı kullanabilir mi?** Teknik olarak evet: ajan, onu hangi klasörde başlatırsan orada çalışır. Bunu yapman gerekip gerekmediği sözleşmene ve sağlayıcının koşullarına bağlı. Bazı müşteriler işlerinin kendi ödedikleri ya da kontrol ettikleri bir hesapta yapılmasını ister; bu durumda o müşteriye ayrı bir oturum ve ayrı bir yapılandırma klasörü ver.

**Bir ajanın iki müşterinin kodunu karıştırmasını nasıl önlerim?** Her ajanı kendi müşteri klasöründe başlat, birkaç müşteriyi içeren bir üst klasörde asla başlatma; müşterinin kurallarını da o klasörün kökündeki bir CLAUDE.md ya da AGENTS.md dosyasına yaz. Ajan yalnızca başladığı yerden ulaşabildiğini okur.

**Yapay zeka ajanı kullanımını müşteriye nasıl faturalarım?** Token ya da maliyeti ajan başına ve müşteri klasörü başına ölç; sonra bunu maliyetine yansıtmaya, ücretine dahil etmeye ya da hiç hesaba katmamaya karar ver. Ölçmediğini faturalayamazsın, o yüzden bunu ilk projeden sonra değil, önce kur.

**Ajanlar doğrudan müşterinin deposuna push etmeli mi?** Ajanın bir branch’te ya da git worktree’de çalışıp pull request açmasına izin ver, merge’den önce diff’i kendin incele. Müşteri sana muhakemen için ödeme yapıyor ve bu muhakeme tam da bu adımda görünür.

---

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