Chiavi sviluppatore
Ultimo aggiornamento: 11 nov 2026
Chi può creare una chiave
Una chiave sviluppatore appartiene al tuo account ToRun. Per crearne una, il tuo account deve avere:
- un indirizzo email confermato,
- un piano a pagamento o un saldo acquistato, perché la quota gratuita non paga mai le chiamate API.
Creare una chiave
- Apri la pagina Sviluppatori del tuo account ToRun.
- Premi Crea chiave e compila il modulo:
- Nome: qualcosa che ti dica dove viene usata la chiave, ad esempio "opencode sul mio portatile".
- Limite di spesa mensile (Runs): il massimo che questa chiave può spendere in un mese.
- Chiedi prima di una singola generazione oltre (Runs): una generazione che costerebbe più di questo importo ti chiede prima conferma.
- Quando la quota del mio piano è esaurita, consenti a questa chiave di spendere dal mio portafoglio: lascia l'opzione disattivata se la chiave deve usare solo la quota del tuo piano.
- Supera il controllo di sicurezza e crea la chiave.
- Copia la chiave. Viene mostrata una sola volta.
Tieni la chiave fuori dai tuoi file
Salva la chiave in una variabile d'ambiente chiamata TORUN_API_KEY e fai puntare la configurazione del tuo strumento alla variabile invece di incollarci la chiave.
macOS e Linux, nel profilo della tua shell (ad esempio ~/.zshrc o ~/.bashrc):
export TORUN_API_KEY="trn_live_..."
Windows, in PowerShell (poi apri un nuovo terminale):
setx TORUN_API_KEY "trn_live_..."
Non fare mai il commit di una chiave in un repository e non metterla in un file di configurazione che condividi.
Monitorare e revocare
La pagina Sviluppatori elenca le tue chiavi con quanto ciascuna ha speso questo mese rispetto al suo limite, quando è stata usata l'ultima volta e se è attiva. L'ultimo utilizzo viene aggiornato ogni pochi minuti, quindi lì compare qualsiasi chiave che non riconosci quando viene usata.
Revoca blocca subito una chiave: uno strumento che la usa viene rifiutato alla chiamata successiva. Se una chiave potrebbe essere trapelata, revocala e creane una nuova.
C'è un limite al numero di chiavi attive che un account può avere e al numero di chiavi che può creare in un giorno.
Passi successivi
- Il server MCP di ToRun: cosa fanno gli strumenti e come vengono pagate le chiamate.
- Collega uno strumento: opencode, Claude Code, Cursor.