---
title: Bring Your Own Agent (BYOA)
description: "Ejecuta las tareas de Worker de Manager en tus propios entornos de ejecución de Agent, como Codex o Claude Code"
---

## ¿Qué es BYOA?

BYOA (Bring Your Own Agent) te permite elegir qué entorno de ejecución de Agent impulsa los Workers de Manager. En lugar de usar únicamente los Agents predeterminados de Verdent, las tareas de Worker enviadas por Manager pueden ejecutarse en un Agent que ya usas o para el que tienes licencia.

<Note>
¿Quieres usar tu propia clave API de proveedor con los agentes integrados de Verdent en su lugar? Consulta [BYOK](/docs/verdent-manager/configuration/byok).
</Note>

## Tipos de Agent compatibles

| Agent | Descripción | Requisitos previos |
| --- | --- | --- |
| Agent integrado | Agent predeterminado proporcionado por Verdent | Ninguno |
| Claude Code | CLI de Claude Code de Anthropic | Node.js instalado (para `npx`) |
| Codex | CLI de Codex de OpenAI | CLI de Codex instalado y entorno de OpenAI configurado |

## Casos de uso

- **Acceder a modelos específicos** — Expón versiones de modelos no incluidas en el conjunto predeterminado de Verdent a través del selector de modelos.
- **Estandarización de equipo** — Usa una licencia empresarial compartida para que el uso del equipo se facture de forma centralizada.
- **Flujo de trabajo familiar** — Conserva tu experiencia existente con Claude Code o Codex mientras Manager le envía tareas de Worker.

## Acceso rápido

- Configuración de BYOA: **Settings → Models → CLI Agents**
- Selección de modelo en el chat de Manager: desactiva el modo **Auto** en el cuadro de entrada para elegir un Task Model
- Las claves API configuradas en BYOA se almacenan únicamente de forma local y nunca se suben a los servidores de Verdent

## Codex

Codex es el CLI de agente de programación de OpenAI. A diferencia de Claude Code, Codex no requiere una clave API dentro de Verdent: usa la autenticación que ya está configurada en tu entorno local de Codex.

### Requisitos previos

- CLI de Codex instalado (`codex` debe estar disponible en tu `PATH`)
- CLI de Codex autenticado y utilizable en tu terminal

### Pasos de configuración

<Steps>
  <Step title="Abre la configuración de CLI Agents">
    Ve a **Settings → Models → CLI Agents**.
  </Step>
  <Step title="Agrega Codex si falta">
    Si la tarjeta de Codex no es visible, selecciona **Add CLI Agent**. Verdent examina el `PATH` de tu sistema en busca del comando `codex`.
  </Step>
  <Step title="Habilita Codex">
    Activa el interruptor de **Codex**.
  </Step>
  <Step title="Selecciona modelos">
    Verdent detecta automáticamente los modelos disponibles. Selecciona los que quieras usar.
  </Step>
</Steps>

### Detección de modelos

Los modelos de Codex se detectan de forma dinámica. Después de iniciar Codex, Verdent obtiene los modelos disponibles a través de su API `/models`. Si se agregan nuevos modelos del lado de Codex, selecciona **Refresh Models** para actualizar la lista.

### Autenticación

Verdent no gestiona la autenticación de Codex. Codex depende de tu entorno de shell local (normalmente `OPENAI_API_KEY` o su flujo de inicio de sesión integrado). Mientras `codex` funcione en tu terminal, la integración funcionará.

## Claude Code

Claude Code es el Agent con más funciones de BYOA y admite varios proveedores. Puedes conectar Anthropic, OpenRouter, Zhipu GLM y otros, y alternar entre ellos en el selector de modelos.

### Requisitos previos

- Node.js instalado (solo se requiere `npx`)

Verdent inicia Claude Code mediante:

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

No se requiere ninguna instalación global.

### Pasos de configuración

<Steps>
  <Step title="Abre la configuración de CLI Agents">
    Ve a **Settings → Models → CLI Agents**.
  </Step>
  <Step title="Agrega Claude Code si falta">
    Si la tarjeta de Claude Code no es visible, selecciona **Add CLI Agent**. Verdent detecta `npx`.
  </Step>
  <Step title="Habilita Claude Code">
    Activa el interruptor de **Claude Code**.
  </Step>
  <Step title="Agrega un proveedor">
    Selecciona **Add provider** y elige un proveedor (por ejemplo, Anthropic).
  </Step>
  <Step title="Ingresa las credenciales">
    Ingresa la clave API. Los valores predeterminados se completan automáticamente.
  </Step>
  <Step title="Prueba y guarda">
    Opcionalmente, selecciona **Test Connection** y luego selecciona **Save**.
  </Step>
</Steps>

Después de guardar, los modelos del proveedor aparecen en la lista de modelos. Los modelos habilitados se seleccionan de forma predeterminada, pero pueden alternarse manualmente.

### Proveedores compatibles

Claude Code admite varios proveedores. Puedes configurar varios a la vez, y todos los modelos aparecen en el selector.

#### Anthropic

API oficial de Anthropic para los modelos de Claude.

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

#### OpenRouter

Acceso API unificado a múltiples proveedores de modelos.

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

Puedes anular los Role Models para enrutar hacia otros modelos de OpenRouter (por ejemplo, `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 y Moonshot proporcionan Kimi K2.5, pero usan distintos endpoints y autenticación. Elige según el origen de tu clave.
</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)

Para cualquier servicio compatible con el formato API de Anthropic.

- **Auth:** Clave API o Token (conmutable)
- **Base URL:** configurada manualmente
- **Models:** especificados manualmente

Usa esta opción si tu proveedor no está en la lista pero admite APIs compatibles con Anthropic.

### Opciones avanzadas

En el panel de configuración del proveedor, expande **Advanced Options** para acceder a un editor JSON:

- **Mapeo de Role Models:**
  - `ANTHROPIC_DEFAULT_OPUS_MODEL`
  - `ANTHROPIC_DEFAULT_SONNET_MODEL`
  - `ANTHROPIC_DEFAULT_HAIKU_MODEL`
  - `CLAUDE_CODE_SUBAGENT_MODEL`
- **Variables de entorno personalizadas** (por ejemplo, `API_TIMEOUT_MS`)

La mayoría de los usuarios no necesitan modificar estos valores: los predeterminados funcionan bien de fábrica.

## Uso de modelos de BYOA en Manager

Después de la configuración:

<Steps>
  <Step title="Desactiva el modo Auto">
    Desactiva el modo **Auto** en la entrada del chat.
  </Step>
  <Step title="Abre Task Model">
    Abre el menú desplegable **Task Model**.
  </Step>
  <Step title="Selecciona un modelo de BYOA">
    Elige cualquier modelo de BYOA habilitado. Las tareas de Worker se ejecutarán usando ese modelo.
  </Step>
</Steps>

Los modelos aparecen como:

- `GPT-5.4 Codex-CLI` (de Codex)
- `Claude-Opus-4.7 ClaudeCode-CLI` (de Claude Code)

Al pasar el cursor se muestran detalles como la fuente del CLI, el nombre del modelo y el proveedor.

## Seguridad y privacidad

- **Almacenamiento solo local:** las claves API se almacenan localmente y nunca se suben.
- **Claves de Claude Code:** se almacenan de forma segura, no se escriben en archivos de configuración en texto plano.
- **Autenticación de Codex:** totalmente gestionada por tu entorno local; Verdent no accede a las claves de OpenAI.

## Preguntas frecuentes

### ¿No se detecta el CLI Agent?

Asegúrate de que los comandos estén disponibles en `PATH`:

- Claude Code requiere `npx` (Node.js instalado)
- Codex requiere el CLI de `codex` instalado

Ejecuta:

```bash
which npx
which codex
```

### ¿Falló Test Connection?

- Verifica la clave API
- Comprueba la base URL
- Asegúrate de tener acceso de red al endpoint de API
- Revisa la configuración del proxy si lo usas

### ¿Agregaste un proveedor pero los modelos no son visibles?

- Asegúrate de que Claude Code esté habilitado
- Asegúrate de que los modelos del proveedor estén activados
- Reinicia Verdent si es necesario