---
title: Bring Your Own Agent (BYOA)
description: "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.

<Note>
Quer usar sua própria chave API de provedor com os agentes integrados do Verdent? Consulte [BYOK](/docs/verdent-manager/configuration/byok).
</Note>

## 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

<Steps>
  <Step title="Abra as configurações de CLI Agents">
    Vá em **Settings → Models → CLI Agents**.
  </Step>
  <Step title="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`.
  </Step>
  <Step title="Habilite o Codex">
    Ative o botão **Codex**.
  </Step>
  <Step title="Selecione os modelos">
    O Verdent detecta automaticamente os modelos disponíveis. Selecione aqueles que você deseja usar.
  </Step>
</Steps>

### 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:

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

Nenhuma instalação global é necessária.

### Etapas de configuração

<Steps>
  <Step title="Abra as configurações de CLI Agents">
    Vá em **Settings → Models → CLI Agents**.
  </Step>
  <Step title="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`.
  </Step>
  <Step title="Habilite o Claude Code">
    Ative o botão **Claude Code**.
  </Step>
  <Step title="Adicione um provedor">
    Clique em **Add provider** e selecione um provedor (por exemplo, Anthropic).
  </Step>
  <Step title="Insira as credenciais">
    Insira a chave API. Os valores padrão são preenchidos automaticamente.
  </Step>
  <Step title="Teste e salve">
    Opcionalmente, clique em **Test Connection** e depois em **Save**.
  </Step>
</Steps>

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](https://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](https://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](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`
- **Modelo:** GLM-5
- **Chave:** [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/`
- **Modelo:** Kimi K2.5
- **Chave:** [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`
- **Modelo:** Kimi K2.5
- **Chave:** [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 e Moonshot fornecem o Kimi K2.5, mas usam endpoints e autenticação diferentes. Escolha com base na origem da sua chave.
</Note>

#### MiniMax (China)

- **Base URL:** `https://api.minimaxi.com/anthropic`
- **Modelo:** MiniMax-M2.7
- **Chave:** [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`
- **Modelo:** MiniMax-M2.7
- **Chave:** [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`
- **Modelo:** MiMo V2 Pro
- **Chave:** [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`
- **Modelo:** MiMo V2 Pro
- **Chave:** [platform.xiaomimimo.com](https://platform.xiaomimimo.com)
- **Docs:** [platform.xiaomimimo.com/docs](https://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:

<Steps>
  <Step title="Desative o modo Auto">
    Desligue o modo **Auto** na entrada do chat.
  </Step>
  <Step title="Abra o Task Model">
    Abra o menu suspenso **Task Model**.
  </Step>
  <Step title="Selecione um modelo BYOA">
    Escolha qualquer modelo BYOA habilitado. As tarefas de Worker serão executadas usando esse modelo.
  </Step>
</Steps>

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.

## Perguntas frequentes

### CLI Agent não detectado?

Certifique-se de que os comandos estão disponíveis no `PATH`:

- Claude Code requer `npx` (Node.js instalado)
- Codex requer a CLI `codex` instalada

Execute:

```bash
which npx
which codex
```

### Test Connection falhou?

- Verifique a chave API
- Confira a base URL
- Garanta o acesso de rede ao endpoint API
- Verifique a configuração de proxy, se usada

### Provedor adicionado, mas os modelos não aparecem?

- Certifique-se de que o Claude Code está habilitado
- Certifique-se de que os modelos do provedor estão ativados
- Reinicie o Verdent se necessário