Bring Your Own Agent (BYOA)

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.

¿Quieres usar tu propia clave API de proveedor con los agentes integrados de Verdent en su lugar? Consulta BYOK.

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

Abre la configuración de CLI Agents

Ve a Settings → Models → CLI Agents.

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.

Habilita Codex

Activa el interruptor de Codex.

Selecciona modelos

Verdent detecta automáticamente los modelos disponibles. Selecciona los que quieras usar.

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:

npx -y @agentclientprotocol/claude-agent-acp

No se requiere ninguna instalación global.

Pasos de configuración

Abre la configuración de CLI Agents

Ve a Settings → Models → CLI Agents.

Agrega Claude Code si falta

Si la tarjeta de Claude Code no es visible, selecciona Add CLI Agent. Verdent detecta npx.

Habilita Claude Code

Activa el interruptor de Claude Code.

Agrega un proveedor

Selecciona Add provider y elige un proveedor (por ejemplo, Anthropic).

Ingresa las credenciales

Ingresa la clave API. Los valores predeterminados se completan automáticamente.

Prueba y guarda

Opcionalmente, selecciona Test Connection y luego selecciona Save.

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

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

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
Docs: docs.bigmodel.cn

Zhipu GLM (Global)

Base URL: https://api.z.ai/api/anthropic
Model: GLM-5
Key: z.ai/manage-apikey/apikey-list
Docs: docs.z.ai

Kimi

Base URL: https://api.kimi.com/coding/
Model: Kimi K2.5
Key: kimi.com/code/console
Docs: kimi.com/code/docs

Moonshot

Base URL: https://api.moonshot.cn/anthropic
Model: Kimi K2.5
Key: platform.moonshot.cn/console/api-keys
Docs: platform.moonshot.cn/docs

Kimi y Moonshot proporcionan Kimi K2.5, pero usan distintos endpoints y autenticación. Elige según el origen de tu clave.

MiniMax (China)

Base URL: https://api.minimaxi.com/anthropic
Model: MiniMax-M2.7
Key: platform.minimaxi.com
Docs: platform.minimaxi.com/docs

MiniMax (Global)

Base URL: https://api.minimax.io/anthropic
Model: MiniMax-M2.7
Key: platform.minimax.io
Docs: platform.minimax.io/docs

Xiaomi MiMo

Base URL: https://api.xiaomimimo.com/anthropic
Model: MiMo V2 Pro
Key: platform.xiaomimimo.com
Docs: 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
Docs: 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:

Desactiva el modo Auto

Desactiva el modo Auto en la entrada del chat.

Abre Task Model

Abre el menú desplegable Task Model.

Selecciona un modelo de BYOA

Elige cualquier modelo de BYOA habilitado. Las tareas de Worker se ejecutarán usando ese modelo.

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.