# Bring Your Own Key (BYOK) (/it/docs/verdent-manager/configuration/byok)

> Usa le tue chiavi API dei provider in Verdent Desktop e scopri dove sono disponibili i modelli BYOK



## Panoramica [#panoramica]

BYOK (Bring Your Own Key) ti permette di collegare le tue chiavi API dei provider e usare quei modelli direttamente negli agenti integrati di Verdent.

### BYOK vs BYOA [#byok-vs-byoa]

Verdent offre due percorsi "bring your own": non confonderli.

|                                 | BYOK                                                                                           | BYOA                                                                                                                     |
| ------------------------------- | ---------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------ |
| **Cosa porti**                  | Una chiave API di un provider                                                                  | Un runtime Agent (Codex / Claude Code)                                                                                   |
| **Cosa esegue la tua attività** | L'agente integrato di Verdent, usando il provider dietro la tua chiave                         | L'agente CLI esterno sulla tua macchina                                                                                  |
| **Caso d'uso tipico**           | Accedere a un modello con la tua fatturazione, oppure usare un provider non incluso di default | Mantenere il tuo flusso di lavoro Codex / Claude Code esistente lasciando che Manager assegni le attività Worker ad esso |
| **Configuralo in**              | Settings → Models → Configure Models                                                           | Settings → Models → CLI Agents                                                                                           |

Consulta [BYOA](/docs/verdent-manager/configuration/byoa) per eseguire le attività Worker su un runtime Agent esterno.

## Provider supportati [#provider-supportati]

* Anthropic
* OpenAI
* OpenRouter

## Aggiungere una chiave API [#aggiungere-una-chiave-api]

<Steps>
  <Step title="Apri la configurazione dei modelli">
    Vai su **Settings → Models → Configure Models**.
  </Step>

  <Step title="Inizia ad aggiungere una chiave">
    Seleziona &#x2A;*Add API Key +** nell'angolo in alto a destra.
  </Step>

  <Step title="Scegli provider e modelli">
    Seleziona un provider e scegli i modelli che vuoi abilitare.
  </Step>

  <Step title="Inserisci le credenziali">
    Aggiungi la tua chiave API.
  </Step>

  <Step title="Salva e convalida">
    Seleziona **Save**. Verdent convalida la chiave automaticamente.
  </Step>
</Steps>

### Risultati della convalida [#risultati-della-convalida]

* Se la convalida ha esito positivo, la chiave viene salvata e i modelli selezionati diventano disponibili.
* Se la convalida fallisce, Verdent mostra un errore così puoi aggiornare la chiave e riprovare.

## Gestire le chiavi API esistenti [#gestire-le-chiavi-api-esistenti]

In **Settings → Models → Configure Models** puoi:

* Abilitare o disabilitare tutti i modelli di un provider
* Abilitare o disabilitare singoli modelli
* Modificare una chiave API esistente
* Eliminare una chiave API

## Dove compaiono i modelli BYOK [#dove-compaiono-i-modelli-byok]

Dopo aver aggiunto una chiave valida, i modelli BYOK compaiono in:

* Il selettore del modello della chat
* La configurazione dei modelli preimpostati
* Le impostazioni dei sottoagenti
* Le impostazioni del reviewer

I modelli BYOK si comportano come i modelli integrati una volta abilitati.

## Limitazioni [#limitazioni]

* Le funzionalità integrate come Smart Suggestions non supportano le chiavi BYOK API.
* La compressione automatica non supporta le chiavi BYOK API.