# Bring Your Own Agent (BYOA) (/it/docs/verdent-manager/configuration/byoa)
> Esegui le attività Worker di Manager sui tuoi runtime Agent, come Codex o Claude Code
## Cos'è BYOA? [#cosè-byoa]
BYOA (Bring Your Own Agent) ti permette di scegliere quale runtime Agent alimenta i Worker di Manager. Invece di usare solo gli Agent predefiniti di Verdent, le attività Worker inviate da Manager possono essere eseguite su un Agent che già utilizzi o per cui hai una licenza.
Vuoi invece usare la tua chiave API del provider con gli agent integrati di Verdent? Vedi [BYOK](/docs/verdent-manager/configuration/byok).
## Tipi di Agent supportati [#tipi-di-agent-supportati]
| Agent | Descrizione | Prerequisiti |
| -------------- | ------------------------------------ | -------------------------------------------------- |
| Built-in Agent | Agent predefinito fornito da Verdent | Nessuno |
| Claude Code | CLI Claude Code di Anthropic | Node.js installato (per `npx`) |
| Codex | CLI Codex di OpenAI | CLI Codex installata e ambiente OpenAI configurato |
## Casi d'uso [#casi-duso]
* **Accedere a modelli specifici** — Esponi versioni di modelli non incluse nel set predefinito di Verdent tramite il selettore dei modelli.
* **Standardizzazione del team** — Usa una licenza aziendale condivisa in modo che l'utilizzo del team venga fatturato in modo centralizzato.
* **Flusso di lavoro familiare** — Mantieni la tua esperienza esistente con Claude Code o Codex, lasciando che Manager vi invii le attività Worker.
## Accesso rapido [#accesso-rapido]
* Impostazioni BYOA: **Settings → Models → CLI Agents**
* Selezione del modello nella chat di Manager: disattiva la modalità **Auto** nella casella di input per scegliere un Task Model
* Le chiavi API configurate in BYOA sono salvate solo localmente e non vengono mai caricate sui server di Verdent
## Codex [#codex]
Codex è la CLI dell'agente di coding di OpenAI. A differenza di Claude Code, Codex non richiede una chiave API all'interno di Verdent — utilizza l'autenticazione già configurata nel tuo ambiente Codex locale.
### Prerequisiti [#prerequisiti]
* CLI Codex installata (`codex` deve essere disponibile nel tuo `PATH`)
* CLI Codex autenticata e utilizzabile nel tuo terminale
### Passaggi di configurazione [#passaggi-di-configurazione]
Vai su **Settings → Models → CLI Agents**.
Se la scheda Codex non è visibile, seleziona **Add CLI Agent**. Verdent esegue una scansione del tuo `PATH` di sistema per trovare il comando `codex`.
Attiva l'interruttore **Codex**.
Verdent rileva automaticamente i modelli disponibili. Seleziona quelli che vuoi usare.
### Individuazione dei modelli [#individuazione-dei-modelli]
I modelli Codex vengono individuati dinamicamente. Dopo aver avviato Codex, Verdent recupera i modelli disponibili tramite la sua API `/models`. Se sul lato Codex vengono aggiunti nuovi modelli, seleziona **Refresh Models** per aggiornare l'elenco.
### Autenticazione [#autenticazione]
Verdent non gestisce l'autenticazione di Codex. Codex si basa sull'ambiente shell locale (tipicamente `OPENAI_API_KEY` o il suo flusso di login integrato). Finché `codex` funziona nel tuo terminale, l'integrazione funziona.
## Claude Code [#claude-code]
Claude Code è l'Agent più ricco di funzionalità in BYOA e supporta più provider. Puoi collegare Anthropic, OpenRouter, Zhipu GLM e altri, e passare dall'uno all'altro nel selettore dei modelli.
### Prerequisiti [#prerequisiti-1]
* Node.js installato (è richiesto solo `npx`)
Verdent avvia Claude Code tramite:
```bash
npx -y @agentclientprotocol/claude-agent-acp
```
Non è richiesta alcuna installazione globale.
### Passaggi di configurazione [#passaggi-di-configurazione-1]
Vai su **Settings → Models → CLI Agents**.
Se la scheda Claude Code non è visibile, seleziona **Add CLI Agent**. Verdent rileva `npx`.
Attiva l'interruttore **Claude Code**.
Seleziona **Add provider** e scegli un provider (per esempio, Anthropic).
Inserisci la chiave API. I valori predefiniti vengono compilati automaticamente.
Facoltativamente seleziona **Test Connection**, poi seleziona **Save**.
Dopo il salvataggio, i modelli sotto il provider compaiono nell'elenco dei modelli. I modelli abilitati sono selezionati per impostazione predefinita, ma possono essere attivati o disattivati manualmente.
### Provider supportati [#provider-supportati]
Claude Code supporta più provider. Puoi configurarne diversi contemporaneamente e tutti i modelli compaiono nel selettore.
#### Anthropic [#anthropic]
API ufficiale di Anthropic per i modelli Claude.
* **Auth:** Chiave API
* **Base URL:** `https://api.anthropic.com`
* **Modelli:** Opus / Sonnet / Haiku
* **Chiave:** [platform.claude.com/settings/keys](https://platform.claude.com/settings/keys)
#### OpenRouter [#openrouter]
Accesso unificato tramite API a più provider di modelli.
* **Auth:** Token
* **Base URL:** `https://openrouter.ai/api`
* **Modelli:** Opus / Sonnet / Haiku
* **Chiave:** [openrouter.ai/workspaces/default/keys](https://openrouter.ai/workspaces/default/keys)
Puoi sovrascrivere i Role Models per instradare verso altri modelli OpenRouter (per esempio, `google/gemini-2.5-pro`).
#### Zhipu GLM (Cina) [#zhipu-glm-cina]
* **Base URL:** `https://open.bigmodel.cn/api/anthropic`
* **Modello:** GLM-5
* **Chiave:** [bigmodel.cn/usercenter/proj-mgmt/apikeys](https://bigmodel.cn/usercenter/proj-mgmt/apikeys)
* **Documentazione:** [docs.bigmodel.cn](https://docs.bigmodel.cn)
#### Zhipu GLM (Globale) [#zhipu-glm-globale]
* **Base URL:** `https://api.z.ai/api/anthropic`
* **Modello:** GLM-5
* **Chiave:** [z.ai/manage-apikey/apikey-list](https://z.ai/manage-apikey/apikey-list)
* **Documentazione:** [docs.z.ai](https://docs.z.ai)
#### Kimi [#kimi]
* **Base URL:** `https://api.kimi.com/coding/`
* **Modello:** Kimi K2.5
* **Chiave:** [kimi.com/code/console](https://kimi.com/code/console)
* **Documentazione:** [kimi.com/code/docs](https://kimi.com/code/docs)
#### Moonshot [#moonshot]
* **Base URL:** `https://api.moonshot.cn/anthropic`
* **Modello:** Kimi K2.5
* **Chiave:** [platform.moonshot.cn/console/api-keys](https://platform.moonshot.cn/console/api-keys)
* **Documentazione:** [platform.moonshot.cn/docs](https://platform.moonshot.cn/docs)
Sia Kimi che Moonshot forniscono Kimi K2.5, ma usano endpoint e autenticazione diversi. Scegli in base alla provenienza della tua chiave.
#### MiniMax (Cina) [#minimax-cina]
* **Base URL:** `https://api.minimaxi.com/anthropic`
* **Modello:** MiniMax-M2.7
* **Chiave:** [platform.minimaxi.com](https://platform.minimaxi.com)
* **Documentazione:** [platform.minimaxi.com/docs](https://platform.minimaxi.com/docs)
#### MiniMax (Globale) [#minimax-globale]
* **Base URL:** `https://api.minimax.io/anthropic`
* **Modello:** MiniMax-M2.7
* **Chiave:** [platform.minimax.io](https://platform.minimax.io)
* **Documentazione:** [platform.minimax.io/docs](https://platform.minimax.io/docs)
#### Xiaomi MiMo [#xiaomi-mimo]
* **Base URL:** `https://api.xiaomimimo.com/anthropic`
* **Modello:** MiMo V2 Pro
* **Chiave:** [platform.xiaomimimo.com](https://platform.xiaomimimo.com)
* **Documentazione:** [platform.xiaomimimo.com/docs](https://platform.xiaomimimo.com/docs)
#### Xiaomi MiMo (Token Plan) [#xiaomi-mimo-token-plan]
* **Base URL:** `https://token-plan-cn.xiaomimimo.com/anthropic`
* **Modello:** MiMo V2 Pro
* **Chiave:** [platform.xiaomimimo.com](https://platform.xiaomimimo.com)
* **Documentazione:** [platform.xiaomimimo.com/docs](https://platform.xiaomimimo.com/docs)
#### Compatibile con Anthropic (endpoint personalizzato) [#compatibile-con-anthropic-endpoint-personalizzato]
Per qualsiasi servizio compatibile con il formato API di Anthropic.
* **Auth:** Chiave API o Token (commutabile)
* **Base URL:** configurato manualmente
* **Modelli:** specificati manualmente
Usa questa opzione se il tuo provider non è elencato ma supporta API compatibili con Anthropic.
### Opzioni avanzate [#opzioni-avanzate]
Nel pannello di configurazione del provider, espandi **Advanced Options** per accedere a un editor JSON:
* **Mappatura dei Role Models:**
* `ANTHROPIC_DEFAULT_OPUS_MODEL`
* `ANTHROPIC_DEFAULT_SONNET_MODEL`
* `ANTHROPIC_DEFAULT_HAIKU_MODEL`
* `CLAUDE_CODE_SUBAGENT_MODEL`
* **Variabili d'ambiente personalizzate** (per esempio, `API_TIMEOUT_MS`)
La maggior parte degli utenti non ha bisogno di modificarle — i valori predefiniti funzionano bene fin da subito.
## Usare i modelli BYOA in Manager [#usare-i-modelli-byoa-in-manager]
Dopo la configurazione:
Disattiva la modalità **Auto** nell'input della chat.
Apri il menu a discesa **Task Model**.
Scegli un qualsiasi modello BYOA abilitato. Le attività Worker verranno eseguite usando quel modello.
I modelli compaiono come:
* `GPT-5.4 Codex-CLI` (da Codex)
* `Claude-Opus-4.7 ClaudeCode-CLI` (da Claude Code)
Passandoci sopra con il mouse vengono mostrati dettagli come la fonte CLI, il nome del modello e il provider.
## Sicurezza e privacy [#sicurezza-e-privacy]
* **Solo archiviazione locale:** le chiavi API sono salvate localmente e non vengono mai caricate.
* **Chiavi Claude Code:** salvate in modo sicuro, non scritte in file di configurazione in chiaro.
* **Autenticazione Codex:** gestita interamente dal tuo ambiente locale; Verdent non accede alle chiavi OpenAI.
## FAQ [#faq]
### CLI Agent non rilevato? [#cli-agent-non-rilevato]
Assicurati che i comandi siano disponibili in `PATH`:
* Claude Code richiede `npx` (Node.js installato)
* Codex richiede la CLI `codex` installata
Esegui:
```bash
which npx
which codex
```
### Test Connection fallito? [#test-connection-fallito]
* Verifica la chiave API
* Controlla la base URL
* Assicurati di avere accesso di rete all'endpoint API
* Controlla la configurazione del proxy se in uso
### Provider aggiunto ma i modelli non sono visibili? [#provider-aggiunto-ma-i-modelli-non-sono-visibili]
* Assicurati che Claude Code sia abilitato
* Assicurati che i modelli del provider siano attivati
* Riavvia Verdent se necessario