Bring Your Own Agent (BYOA)

Execute as tarefas de Worker do Manager nos seus próprios runtimes de Agent, como Codex ou Claude Code

O que é BYOA?

BYOA (Bring Your Own Agent) permite escolher qual runtime de Agent alimenta os Workers do Manager. Em vez de usar apenas os Agents padrão do Verdent, as tarefas de Worker despachadas pelo Manager podem rodar em um Agent que você já usa ou para o qual tem licença.

Quer usar sua própria chave API de provedor com os agentes integrados do Verdent? Consulte BYOK.

Tipos de Agent suportados

Agent	Descrição	Pré-requisitos
Agent integrado	Agent padrão fornecido pelo Verdent	Nenhum
Claude Code	CLI Claude Code da Anthropic	Node.js instalado (para `npx`)
Codex	CLI Codex da OpenAI	CLI Codex instalado e ambiente OpenAI configurado

Casos de uso

Acessar modelos específicos — Exponha versões de modelos não incluídas no conjunto padrão do Verdent por meio do seletor de modelos.
Padronização da equipe — Use uma licença empresarial compartilhada para que o uso da equipe seja faturado de forma centralizada.
Fluxo de trabalho familiar — Mantenha sua experiência existente com Claude Code ou Codex enquanto o Manager despacha tarefas de Worker para ele.

Acesso rápido

Configurações de BYOA: Settings → Models → CLI Agents
Seleção de modelo no chat do Manager: desative o modo Auto na caixa de entrada para escolher um Task Model
As chaves API configuradas no BYOA são armazenadas apenas localmente e nunca são enviadas aos servidores do Verdent

Codex

Codex é a CLI de agente de codificação da OpenAI. Diferente do Claude Code, o Codex não requer uma chave API dentro do Verdent — ele usa a autenticação já configurada no seu ambiente Codex local.

Pré-requisitos

CLI Codex instalado (codex deve estar disponível no seu PATH)
CLI Codex autenticado e utilizável no seu terminal

Etapas de configuração

Abra as configurações de CLI Agents

Vá em Settings → Models → CLI Agents.

Adicione o Codex se estiver ausente

Se o card do Codex não estiver visível, clique em Add CLI Agent. O Verdent verifica o PATH do seu sistema em busca do comando codex.

Habilite o Codex

Ative o botão Codex.

Selecione os modelos

O Verdent detecta automaticamente os modelos disponíveis. Selecione aqueles que você deseja usar.

Descoberta de modelos

Os modelos do Codex são descobertos dinamicamente. Após iniciar o Codex, o Verdent busca os modelos disponíveis por meio da API /models. Se novos modelos forem adicionados no lado do Codex, clique em Refresh Models para atualizar a lista.

Autenticação

O Verdent não gerencia a autenticação do Codex. O Codex depende do seu ambiente de shell local (normalmente OPENAI_API_KEY ou seu fluxo de login integrado). Desde que codex funcione no seu terminal, a integração funciona.

Claude Code

Claude Code é o Agent mais rico em recursos no BYOA e suporta múltiplos provedores. Você pode conectar Anthropic, OpenRouter, Zhipu GLM e outros, e alternar entre eles no seletor de modelos.

Pré-requisitos

Node.js instalado (apenas npx é necessário)

O Verdent inicia o Claude Code via:

npx -y @agentclientprotocol/claude-agent-acp

Nenhuma instalação global é necessária.

Etapas de configuração

Abra as configurações de CLI Agents

Vá em Settings → Models → CLI Agents.

Adicione o Claude Code se estiver ausente

Se o card do Claude Code não estiver visível, clique em Add CLI Agent. O Verdent detecta o npx.

Habilite o Claude Code

Ative o botão Claude Code.

Adicione um provedor

Clique em Add provider e selecione um provedor (por exemplo, Anthropic).

Insira as credenciais

Insira a chave API. Os valores padrão são preenchidos automaticamente.

Teste e salve

Opcionalmente, clique em Test Connection e depois em Save.

Após salvar, os modelos do provedor aparecem na lista de modelos. Os modelos habilitados são selecionados por padrão, mas podem ser alternados manualmente.

Provedores suportados

O Claude Code suporta múltiplos provedores. Você pode configurar vários ao mesmo tempo, e todos os modelos aparecem no seletor.

Anthropic

API oficial da Anthropic para os modelos Claude.

Auth: chave API
Base URL: https://api.anthropic.com
Modelos: Opus / Sonnet / Haiku
Chave: platform.claude.com/settings/keys

OpenRouter

Acesso API unificado a múltiplos provedores de modelos.

Auth: Token
Base URL: https://openrouter.ai/api
Modelos: Opus / Sonnet / Haiku
Chave: openrouter.ai/workspaces/default/keys

Você pode sobrescrever os Role Models para rotear para outros modelos do OpenRouter (por exemplo, google/gemini-2.5-pro).

Zhipu GLM (China)

Base URL: https://open.bigmodel.cn/api/anthropic
Modelo: GLM-5
Chave: bigmodel.cn/usercenter/proj-mgmt/apikeys
Docs: docs.bigmodel.cn

Zhipu GLM (Global)

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

Kimi

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

Moonshot

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

Kimi e Moonshot fornecem o Kimi K2.5, mas usam endpoints e autenticação diferentes. Escolha com base na origem da sua chave.

MiniMax (China)

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

MiniMax (Global)

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

Xiaomi MiMo

Base URL: https://api.xiaomimimo.com/anthropic
Modelo: MiMo V2 Pro
Chave: platform.xiaomimimo.com
Docs: platform.xiaomimimo.com/docs

Xiaomi MiMo (Token Plan)

Base URL: https://token-plan-cn.xiaomimimo.com/anthropic
Modelo: MiMo V2 Pro
Chave: platform.xiaomimimo.com
Docs: platform.xiaomimimo.com/docs

Compatível com Anthropic (Endpoint personalizado)

Para qualquer serviço compatível com o formato API da Anthropic.

Auth: chave API ou Token (alternável)
Base URL: configurada manualmente
Modelos: especificados manualmente

Use isso se o seu provedor não estiver listado, mas suportar APIs compatíveis com Anthropic.

Opções avançadas

No painel de configuração do provedor, expanda Advanced Options para acessar um editor JSON:

Mapeamento de Role Models:
- ANTHROPIC_DEFAULT_OPUS_MODEL
- ANTHROPIC_DEFAULT_SONNET_MODEL
- ANTHROPIC_DEFAULT_HAIKU_MODEL
- CLAUDE_CODE_SUBAGENT_MODEL
Variáveis de ambiente personalizadas (por exemplo, API_TIMEOUT_MS)

A maioria dos usuários não precisa modificar isso — os padrões funcionam bem por conta própria.

Usando modelos BYOA no Manager

Após a configuração:

Desative o modo Auto

Desligue o modo Auto na entrada do chat.

Abra o Task Model

Abra o menu suspenso Task Model.

Selecione um modelo BYOA

Escolha qualquer modelo BYOA habilitado. As tarefas de Worker serão executadas usando esse modelo.

Os modelos aparecem como:

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

Ao passar o mouse, são exibidos detalhes como a fonte CLI, o nome do modelo e o provedor.

Segurança e privacidade

Apenas armazenamento local: as chaves API são armazenadas localmente e nunca enviadas.
Chaves Claude Code: armazenadas com segurança, não gravadas em arquivos de configuração em texto puro.
Autenticação do Codex: totalmente gerenciada pelo seu ambiente local; o Verdent não acessa as chaves OpenAI.