---
title: Bring Your Own Agent (BYOA)
description: "Manager'ın Worker görevlerini Codex veya Claude Code gibi kendi Agent çalışma zamanlarınızda çalıştırın"
---

## BYOA nedir?

BYOA (Bring Your Own Agent), Manager'ın Worker'larına hangi Agent çalışma zamanının güç vereceğini seçmenizi sağlar. Yalnızca Verdent'in varsayılan Agent'larını kullanmak yerine, Manager tarafından gönderilen Worker görevleri, halihazırda kullandığınız veya lisansınızın bulunduğu bir Agent üzerinde çalışabilir.

<Note>
Bunun yerine kendi sağlayıcı API anahtarınızı Verdent'in yerleşik aracılarıyla kullanmak mı istiyorsunuz? [BYOK](/docs/verdent-manager/configuration/byok) bölümüne bakın.
</Note>

## Desteklenen Agent türleri

| Agent | Açıklama | Önkoşullar |
| --- | --- | --- |
| Built-in Agent | Verdent tarafından sağlanan varsayılan Agent | Yok |
| Claude Code | Anthropic'in Claude Code CLI'si | Node.js kurulu olmalı (`npx` için) |
| Codex | OpenAI Codex CLI | Codex CLI kurulu ve OpenAI ortamı yapılandırılmış olmalı |

## Kullanım senaryoları

- **Belirli modellere erişim** — Verdent'in varsayılan setinde bulunmayan model sürümlerini model seçici aracılığıyla kullanıma açın.
- **Ekip standardizasyonu** — Paylaşılan bir kurumsal lisans kullanarak ekip kullanımının merkezi olarak faturalandırılmasını sağlayın.
- **Tanıdık iş akışı** — Mevcut Claude Code veya Codex deneyiminizi korurken Manager'ın Worker görevlerini ona göndermesine izin verin.

## Hızlı erişim

- BYOA ayarları: **Settings → Models → CLI Agents**
- Manager sohbetinde model seçimi: bir Task Model seçmek için giriş kutusundaki **Auto** modunu kapatın
- BYOA'da yapılandırılan API anahtarları yalnızca yerel olarak saklanır ve hiçbir zaman Verdent sunucularına yüklenmez

## Codex

Codex, OpenAI'nin kodlama aracısı CLI'sidir. Claude Code'un aksine, Codex Verdent içinde bir API anahtarı gerektirmez — yerel Codex ortamınızda zaten kurulu olan kimlik doğrulamayı kullanır.

### Önkoşullar

- Codex CLI kurulu (`codex` komutu `PATH` üzerinde erişilebilir olmalı)
- Codex CLI kimliği doğrulanmış ve terminalinizde kullanılabilir durumda

### Kurulum adımları

<Steps>
  <Step title="CLI Agents ayarlarını açın">
    **Settings → Models → CLI Agents** bölümüne gidin.
  </Step>
  <Step title="Codex yoksa ekleyin">
    Codex kartı görünmüyorsa **Add CLI Agent**'a tıklayın. Verdent, `codex` komutu için sistem `PATH` ortamınızı tarar.
  </Step>
  <Step title="Codex'i etkinleştirin">
    **Codex** anahtarını açın.
  </Step>
  <Step title="Modelleri seçin">
    Verdent kullanılabilir modelleri otomatik olarak algılar. Kullanmak istediklerinizi seçin.
  </Step>
</Steps>

### Model keşfi

Codex modelleri dinamik olarak keşfedilir. Codex başlatıldıktan sonra Verdent, `/models` API'si aracılığıyla kullanılabilir modelleri getirir. Codex tarafında yeni modeller eklenirse, listeyi güncellemek için **Refresh Models**'a tıklayın.

### Kimlik doğrulama

Verdent, Codex kimlik doğrulamasını yönetmez. Codex, yerel kabuk ortamınıza (genellikle `OPENAI_API_KEY` veya yerleşik oturum açma akışı) dayanır. `codex` terminalinizde çalıştığı sürece entegrasyon çalışır.

## Claude Code

Claude Code, BYOA'daki en zengin özelliklere sahip Agent'tır ve birden fazla sağlayıcıyı destekler. Anthropic, OpenRouter, Zhipu GLM ve diğerlerini bağlayabilir ve model seçicide aralarında geçiş yapabilirsiniz.

### Önkoşullar

- Node.js kurulu (yalnızca `npx` gereklidir)

Verdent, Claude Code'u şu şekilde başlatır:

```bash
npx -y @agentclientprotocol/claude-agent-acp
```

Genel kurulum gerekmez.

### Kurulum adımları

<Steps>
  <Step title="CLI Agents ayarlarını açın">
    **Settings → Models → CLI Agents** bölümüne gidin.
  </Step>
  <Step title="Claude Code yoksa ekleyin">
    Claude Code kartı görünmüyorsa **Add CLI Agent**'a tıklayın. Verdent, `npx` komutunu algılar.
  </Step>
  <Step title="Claude Code'u etkinleştirin">
    **Claude Code** anahtarını açın.
  </Step>
  <Step title="Bir sağlayıcı ekleyin">
    **Add provider**'a tıklayın ve bir sağlayıcı seçin (örneğin Anthropic).
  </Step>
  <Step title="Kimlik bilgilerini girin">
    API anahtarını girin. Varsayılan değerler otomatik olarak doldurulur.
  </Step>
  <Step title="Test edin ve kaydedin">
    İsteğe bağlı olarak **Test Connection**'a tıklayın, ardından **Save**'e tıklayın.
  </Step>
</Steps>

Kaydettikten sonra, sağlayıcı altındaki modeller model listesinde görünür. Etkinleştirilen modeller varsayılan olarak seçilidir ancak manuel olarak değiştirilebilir.

### Desteklenen sağlayıcılar

Claude Code birden fazla sağlayıcıyı destekler. Aynı anda birkaçını yapılandırabilirsiniz ve tüm modeller seçicide görünür.

#### Anthropic

Claude modelleri için resmi Anthropic API'si.

- **Auth:** API Key
- **Base URL:** `https://api.anthropic.com`
- **Models:** Opus / Sonnet / Haiku
- **Key:** [platform.claude.com/settings/keys](https://platform.claude.com/settings/keys)

#### OpenRouter

Birden fazla model sağlayıcısına birleşik API erişimi.

- **Auth:** Token
- **Base URL:** `https://openrouter.ai/api`
- **Models:** Opus / Sonnet / Haiku
- **Key:** [openrouter.ai/workspaces/default/keys](https://openrouter.ai/workspaces/default/keys)

Diğer OpenRouter modellerine yönlendirmek için Role Models'i geçersiz kılabilirsiniz (örneğin `google/gemini-2.5-pro`).

#### Zhipu GLM (China)

- **Base URL:** `https://open.bigmodel.cn/api/anthropic`
- **Model:** GLM-5
- **Key:** [bigmodel.cn/usercenter/proj-mgmt/apikeys](https://bigmodel.cn/usercenter/proj-mgmt/apikeys)
- **Docs:** [docs.bigmodel.cn](https://docs.bigmodel.cn)

#### Zhipu GLM (Global)

- **Base URL:** `https://api.z.ai/api/anthropic`
- **Model:** GLM-5
- **Key:** [z.ai/manage-apikey/apikey-list](https://z.ai/manage-apikey/apikey-list)
- **Docs:** [docs.z.ai](https://docs.z.ai)

#### Kimi

- **Base URL:** `https://api.kimi.com/coding/`
- **Model:** Kimi K2.5
- **Key:** [kimi.com/code/console](https://kimi.com/code/console)
- **Docs:** [kimi.com/code/docs](https://kimi.com/code/docs)

#### Moonshot

- **Base URL:** `https://api.moonshot.cn/anthropic`
- **Model:** Kimi K2.5
- **Key:** [platform.moonshot.cn/console/api-keys](https://platform.moonshot.cn/console/api-keys)
- **Docs:** [platform.moonshot.cn/docs](https://platform.moonshot.cn/docs)

<Note>
Kimi ve Moonshot'un her ikisi de Kimi K2.5 sağlar ancak farklı uç noktalar ve kimlik doğrulama kullanır. Anahtarınızın nereden geldiğine göre seçim yapın.
</Note>

#### MiniMax (China)

- **Base URL:** `https://api.minimaxi.com/anthropic`
- **Model:** MiniMax-M2.7
- **Key:** [platform.minimaxi.com](https://platform.minimaxi.com)
- **Docs:** [platform.minimaxi.com/docs](https://platform.minimaxi.com/docs)

#### MiniMax (Global)

- **Base URL:** `https://api.minimax.io/anthropic`
- **Model:** MiniMax-M2.7
- **Key:** [platform.minimax.io](https://platform.minimax.io)
- **Docs:** [platform.minimax.io/docs](https://platform.minimax.io/docs)

#### Xiaomi MiMo

- **Base URL:** `https://api.xiaomimimo.com/anthropic`
- **Model:** MiMo V2 Pro
- **Key:** [platform.xiaomimimo.com](https://platform.xiaomimimo.com)
- **Docs:** [platform.xiaomimimo.com/docs](https://platform.xiaomimimo.com/docs)

#### Xiaomi MiMo (Token Plan)

- **Base URL:** `https://token-plan-cn.xiaomimimo.com/anthropic`
- **Model:** MiMo V2 Pro
- **Key:** [platform.xiaomimimo.com](https://platform.xiaomimimo.com)
- **Docs:** [platform.xiaomimimo.com/docs](https://platform.xiaomimimo.com/docs)

#### Anthropic-Compatible (Custom Endpoint)

Anthropic API formatıyla uyumlu herhangi bir hizmet için.

- **Auth:** API Key veya Token (değiştirilebilir)
- **Base URL:** manuel olarak yapılandırılır
- **Models:** manuel olarak belirtilir

Sağlayıcınız listede yoksa ancak Anthropic uyumlu API'leri destekliyorsa bunu kullanın.

### Gelişmiş seçenekler

Sağlayıcı yapılandırma panelinde, bir JSON düzenleyiciye erişmek için **Advanced Options**'ı genişletin:

- **Role Models eşlemesi:**
  - `ANTHROPIC_DEFAULT_OPUS_MODEL`
  - `ANTHROPIC_DEFAULT_SONNET_MODEL`
  - `ANTHROPIC_DEFAULT_HAIKU_MODEL`
  - `CLAUDE_CODE_SUBAGENT_MODEL`
- **Özel ortam değişkenleri** (örneğin `API_TIMEOUT_MS`)

Çoğu kullanıcının bunları değiştirmesi gerekmez — varsayılanlar kutudan çıktığı haliyle iyi çalışır.

## Manager'da BYOA modellerini kullanma

Yapılandırmadan sonra:

<Steps>
  <Step title="Auto modunu devre dışı bırakın">
    Sohbet girişinde **Auto** modunu kapatın.
  </Step>
  <Step title="Task Model'i açın">
    **Task Model** açılır menüsünü açın.
  </Step>
  <Step title="Bir BYOA modeli seçin">
    Etkinleştirilmiş herhangi bir BYOA modelini seçin. Worker görevleri o modeli kullanarak çalışır.
  </Step>
</Steps>

Modeller şu şekilde görünür:

- `GPT-5.4 Codex-CLI` (Codex'ten)
- `Claude-Opus-4.7 ClaudeCode-CLI` (Claude Code'dan)

Üzerine gelindiğinde CLI kaynağı, model adı ve sağlayıcı gibi ayrıntılar gösterilir.

## Güvenlik ve gizlilik

- **Yalnızca yerel depolama:** API anahtarları yerel olarak saklanır ve hiçbir zaman yüklenmez.
- **Claude Code anahtarları:** güvenli bir şekilde saklanır, düz yapılandırma dosyalarına yazılmaz.
- **Codex kimlik doğrulaması:** tamamen yerel ortamınız tarafından yönetilir; Verdent OpenAI anahtarlarına erişmez.

## SSS

### CLI Agent algılanmıyor mu?

Komutların `PATH` içinde kullanılabilir olduğundan emin olun:

- Claude Code, `npx` gerektirir (Node.js kurulu)
- Codex, `codex` CLI'sinin kurulu olmasını gerektirir

Şunu çalıştırın:

```bash
which npx
which codex
```

### Test Connection başarısız mı oldu?

- API anahtarını doğrulayın
- Base URL'yi kontrol edin
- API uç noktasına ağ erişimi olduğundan emin olun
- Kullanılıyorsa proxy yapılandırmasını kontrol edin

### Sağlayıcı eklendi ama modeller görünmüyor mu?

- Claude Code'un etkinleştirildiğinden emin olun
- Sağlayıcı modellerinin açık olduğundan emin olun
- Gerekirse Verdent'i yeniden başlatın