Blogs
/
Come creare un agente vocale con Claude Code e Claude Fable 5.2

Come creare un agente vocale con Claude Code e Claude Fable 5.2

Retell
AI Voice Agent Platform
Published 
November 17, 2026
9
 min read
Come creare un agente vocale con Claude Code e Claude Fable 5.2
About this article
Collega Claude Code al server MCP di Retell AI con un solo comando e lascia che Claude Fable 5.2 crei, testi e revisioni un agente telefonico dal tuo terminale.
BACK TO BLOGS
See Retell AI in action
Start free
Back to top

Claude Code può creare un agente telefonico funzionante direttamente dal tuo terminale. Lo colleghi al server MCP di Retell AI con un solo comando, descrivi l'agente in linguaggio naturale e Claude Code lo crea, scrive i casi di test e ne revisiona le chiamate tramite l'API di Retell. Questa guida ti accompagna in questo ciclo con Claude Fable 5.2, il modello rilasciato da Anthropic il 9 novembre 2026, e spiega cosa approvare manualmente lungo il percorso.

Questa guida è pubblicata da Retell AI e il server MCP che utilizza è di proprietà di Retell.

Com'è fatta la configurazione

Sono coinvolti tre elementi. Claude Code gira nel tuo terminale e pianifica il lavoro. Il server MCP di Retell, all'indirizzo mcp.retellai.com, gli dà accesso all'API di Retell. Il tuo workspace Retell contiene agenti, numeri di telefono, test e cronologia delle chiamate su cui agisce l'API.

Il server MCP espone tre strumenti invece di uno per ogni endpoint dell'API, così l'elenco degli strumenti resta abbastanza ridotto da entrare nella finestra di contesto del modello. Claude Code li usa in ordine: elenca gli endpoint disponibili, legge lo schema di input di quello che gli serve, poi lo invoca. Se una chiamata include un argomento non presente nello schema, il server restituisce un errore che indica l'argomento e non chiama l'API.

Diagramma di come Claude Code raggiunge un workspace Retell. A sinistra, Claude Code nel tuo terminale, con il modello Claude Fable 5.2, legge la tua richiesta in linguaggio naturale, pianifica quali endpoint di Retell gli servono e ti chiede di approvare ogni chiamata. Si connette tramite MCP su HTTP, con la chiave API nell'header Authorization, al server MCP di Retell su mcp.retellai.com, che dispone di tre strumenti usati in ordine: list_api_endpoints trova l'endpoint adatto al compito, get_api_endpoint_schema legge lo schema di input di quell'endpoint e invoke_api_endpoint verifica gli argomenti rispetto allo schema e poi chiama l'API di Retell. L'API di Retell agisce sul tuo workspace Retell: agenti, numeri di telefono, knowledge base, voci, test e chiamate. L'agente risponde alle chiamate con un modello dell'elenco di Retell, non con Fable 5.2.
Claude Code pianifica il lavoro e il server MCP di Retell esegue ogni chiamata API dopo la tua approvazione. Diagramma di Retell AI, novembre 2026, basato sulla documentazione del server MCP di Retell.

Una cosa da chiarire prima di iniziare: Claude Fable 5.2 è il modello che costruisce, non il modello al telefono. L'agente che crei risponde alle chiamate con un modello dell'elenco di Retell, e Fable 5.2 non è in quell'elenco al 10 novembre 2026. (L'elenco include il modello proprietario di Retell, Tell-1.) Approfondiamo questa distinzione in Claude Fable 5.2 per gli agenti vocali: dove è adatto e dove no.

Tre modi per creare un agente Retell con Claude

Claude Code con il server MCP è uno dei tre percorsi possibili. Sono adatti a persone diverse.

Claude Code + server MCP di RetellConnettore Retell AI in ClaudeDashboard di Retell
Dove lavoriIl tuo terminale o IDEUna chat in Claude sul web o in Claude DesktopUn browser
AccessoUna chiave API di Retell nell'header della richiestaIl tuo login Retell, tramite OAuthIl tuo login Retell
Cosa raggiungeGli endpoint dell'API di Retell consentiti dalla tua chiave, esclusi quelli deprecati52 strumenti dedicati con widget nella chat (a ottobre 2026)Tutte le impostazioni
Tipi di agenteTutto ciò che l'API supportaSolo agenti single-promptTutti
Ideale perSviluppatori, modifiche in blocco, tutto ciò che vuoi automatizzare con script o ripetereCreare e modificare un agente descrivendoloConversation flow, integrazioni, revisione visiva

Fonti: documentazione del server MCP e documentazione del connettore Claude di Retell, consultate il 10 novembre 2026.

Collega Claude Code al server MCP di Retell

Ti servono un account Retell, una chiave API di Retell e Claude Code installato. Crea la chiave nella dashboard di Retell e assegnale solo i permessi necessari per questo lavoro.

Esegui questo comando nel terminale, sostituendo il segnaposto con la tua chiave:

claude mcp add --transport http retell https://mcp.retellai.com \
  --header "Authorization: Bearer <RETELL_API_KEY>"

Avvia Claude Code ed esegui /mcp per verificare che il server retell sia connesso. Poi esegui /model e scegli Claude Fable 5.2 se il tuo piano lo include. La documentazione di Claude Code indica che Fable 5.2 richiede Claude Code v2.1.321 o successiva, e il post di lancio di Anthropic afferma che gli sviluppatori possono chiamare il modello sulla Claude Platform come claude-fable-5-2.

Tieni la chiave fuori dalla conversazione. Va inserita nel comando qui sopra o nelle impostazioni del tuo client, mai incollata in un prompt.

Descrivi l'agente e lascia che Claude Code lo crei

Inizia con una lettura, così vedi che la connessione funziona prima di modificare qualcosa:

Elenca i miei agenti Retell e riassumi cosa fa ciascuno.

Poi descrivi l'agente che vuoi. Sii specifico sul compito, sul tono, su cosa non deve mai fare e su quando passare la chiamata a una persona:

Crea un agente vocale single-prompt per uno studio dentistico chiamato
Northside Dental. Risponde a domande su orari e assicurazioni,
fissa appuntamenti per le pulizie e trasferisce le domande sulla
fatturazione alla reception al numero +14155550123. Deve dire di essere
un assistente IA all'inizio di ogni chiamata. Usa Claude 5.5 Sonnet come
modello dell'agente. Mostrami il prompt prima di creare qualsiasi cosa.

Claude Code scrive una bozza del prompt, consulta lo schema degli endpoint necessari e ti chiede di approvare ogni chiamata API. Leggi il prompt che ha scritto prima di approvare. È qui che un modello più potente si guadagna il suo posto: il prompt è l'agente, e un prompt vago produce una chiamata vaga.

Scrivi i casi di test prima di effettuare una chiamata

Il test di simulazione di Retell esegue il tuo agente in una conversazione testuale con un chiamante simulato dall'IA e valuta ogni esecuzione come superata o non superata in base ai criteri di successo che imposti. Funziona con agenti single-prompt, multi-prompt e conversation flow, e non effettua chiamate. Chiedi a Claude Code di scrivere la suite:

Scrivi otto casi di test di simulazione per l'agente di Northside Dental.
Copri un nuovo paziente che prenota una pulizia, un chiamante che interrompe
e cambia giorno due volte, una domanda sulla fatturazione da trasferire,
un chiamante che chiede se sta parlando con una persona reale e qualcuno
che chiede un consiglio medico che l'agente deve rifiutarsi di dare. Assegna
a ciascuno criteri di successo chiari. Poi eseguili e mostrami quelli falliti.

I casi salvati diventano una suite di regressione. Ogni volta che il prompt cambia, eseguili di nuovo prima che la modifica arrivi a un chiamante.

Assegna l'agente a un numero e chiama il tuo telefono

La simulazione copre la logica. Una chiamata reale copre la voce, il ritmo e le interruzioni. Chiedi a Claude Code di elencare i tuoi numeri di telefono, assegnare l'agente a uno di essi e chiamarti:

Mostrami i miei numeri di telefono Retell e quale agente è assegnato a
ciascuno. Assegna l'agente di Northside Dental al numero senza agente,
poi fammi chiamare al +14155550199.

Tre avvertenze. Una chiamata raggiunge un telefono reale e viene fatturata come qualsiasi altra chiamata, quindi controlla il numero di destinazione nella richiesta di approvazione. Le chiamate in uscita richiedono anche la verifica KYC sul tuo account Retell. E se un numero ha già un agente assegnato, sostituirlo cambia chi risponde a quel numero, quindi verifica prima cosa c'è.

Revisiona le chiamate e aggiorna il prompt

Dopo qualche chiamata, chiedi a Claude Code di rileggerle:

Recupera le ultime 20 chiamate dell'agente di Northside Dental. Raggruppa
quelle finite male per causa, cita il turno in cui ciascuna è andata
storta e proponi modifiche al prompt. Non modificare ancora nulla.

Approva le modifiche al prompt che condividi, riesegui la suite di simulazione e pubblica. Questo ciclo di creazione, test, chiamata, revisione e aggiornamento è tutto il lavoro, ed è la parte che Claude Code accorcia di più.

Diagramma del ciclo in quattro fasi che Claude Code esegue su un agente Retell, ogni fase con una richiesta di esempio, cosa fa Claude Code e cosa controllare. Uno, crea l'agente: Claude Code scrive il prompt e crea l'agente; leggi il prompt prima di approvare. Due, testa senza chiamate: crea casi di test di simulazione valutati e li esegue come conversazioni testuali; verifica che i criteri di successo corrispondano a ciò che ti interessa. Tre, chiama il tuo telefono: assegna l'agente a un numero ed effettua una chiamata; controlla il numero di destinazione e quale agente viene sostituito. Quattro, revisiona le chiamate: legge le chiamate e l'analisi post-chiamata e propone modifiche; approva solo le modifiche che condividi. Una freccia tratteggiata torna dalla fase quattro alla fase uno, con l'etichetta aggiorna il prompt, riesegui i casi di test, pubblica.
Il ciclo di creazione, test, chiamata e revisione, con la verifica da fare in ogni fase. Diagramma di Retell AI, novembre 2026, basato sulla documentazione di Retell sul server MCP e sul test di simulazione.
Cosa chiediCosa fa Claude Code tramite il server MCPRichiede la tua approvazione
«Elenca i miei agenti»Legge gli agenti e le loro versioniRischio basso, sola lettura
«Crea un agente che...»Scrive un prompt, crea l'agenteSì. Leggi prima il prompt
«Scrivi ed esegui i casi di test»Crea casi di test di simulazione, li esegue, segnala quelli fallitiSì
«Assegnalo al mio numero»Elenca i numeri, assegna l'agenteSì. Verifica quale agente sostituisce
«Chiama il mio telefono»Crea una chiamata telefonicaSì. Controlla il numero di destinazione
«Revisiona le chiamate recenti»Elenca le chiamate e legge trascrizione, latenza e analisi post-chiamata di ciascunaRischio basso, ma le trascrizioni possono contenere dati personali
«Elimina il vecchio agente»Chiama un endpoint di eliminazioneSì. Considera l'eliminazione definitiva

Quali approvazioni mantenere attive

Ogni chiamata API di Claude Code passa per un unico strumento, invoke_api_endpoint. Se scegli di consentire sempre quello strumento, consenti ogni endpoint raggiungibile dalla tua chiave, compresi quelli di eliminazione e pubblicazione. La documentazione di Retell consiglia di approvare ogni chiamata separatamente controllandone endpoint e argomenti, e noi non salteremmo questo passaggio.

  • Usa una chiave con i permessi minimi necessari per il lavoro. Una chiave di sola lettura basta per revisionare le chiamate.
  • Leggi prima di scrivere. Fai recuperare a Claude Code l'agente attuale prima che lo aggiorni o lo elimini.
  • Tratta le trascrizioni come testo non attendibile. Un chiamante può dire qualsiasi cosa, comprese istruzioni rivolte al modello. Non lasciare che una sessione di revisione delle chiamate abbia anche l'approvazione per modificare gli agenti senza il tuo controllo.
  • Evita i dati personali quando possibile. Chiedi riepiloghi dei fallimenti, non trascrizioni complete, a meno che non ti servano.

Deve per forza essere Claude Fable 5.2?

No. Il server MCP funziona con qualsiasi modello che Claude Code può eseguire, e il consiglio di Anthropic nel post di lancio è diretto: «Per la maggior parte delle attività di programmazione e di conoscenza, consigliamo agli utenti di iniziare con Claude Opus 5.5, il nostro modello quotidiano più potente.» Descrive Fable e Mythos come progettati per il lavoro tecnico più ambizioso e aperto.

Per un singolo agente con un prompt breve, Opus 5.5 è sufficiente. Fable 5.2 vale la pena quando il lavoro è ampio e aperto: riscrivere i prompt di decine di agenti secondo un nuovo standard, trasformare un mese di chiamate fallite in una suite di regressione o migrare agenti tra workspace mantenendo invariato il comportamento. Sono nostre valutazioni, non risultati di benchmark. Anthropic applica a Fable 5.2 un prezzo di $8 per milione di token di input e di $40 per milione di token di output sulla sua piattaforma.

Domande frequenti

Claude Code può connettersi a Retell AI?

Sì. Retell gestisce un server MCP ospitato su mcp.retellai.com, e Claude Code si connette con il comando claude mcp add e una chiave API di Retell nell'header Authorization. Anche Cursor, Claude Desktop, Codex e altri client MCP possono connettersi allo stesso server.

Mi serve Claude Fable 5.2 per usare il server MCP di Retell?

No. Il server funziona con qualunque modello esegua il tuo client MCP. Anthropic consiglia di iniziare con Claude Opus 5.5 per la maggior parte delle attività di programmazione e di conoscenza e posiziona Fable 5.2 per il lavoro tecnico più ambizioso e aperto.

L'agente vocale stesso può funzionare con Claude Fable 5.2?

Non dall'elenco dei modelli di Retell al 10 novembre 2026. L'agente risponde alle chiamate con un modello che scegli da quell'elenco, che include Claude 5.5 Opus, Claude 5.5 Sonnet e Claude 5.5 Haiku. Fable 5.2 si occupa di creazione, test e revisione da Claude Code.

Qual è la differenza tra il server MCP di Retell e il connettore Retell AI per Claude?

Il server MCP si autentica con una chiave API di Retell e raggiunge l'API di Retell da client come Claude Code e Cursor. Il connettore è presente nella directory dei connettori di Claude, si autentica con il tuo login Retell tramite OAuth e mostra i passaggi di creazione, distribuzione e test come widget all'interno della chat. Il connettore crea solo agenti single-prompt.

È sicuro lasciare che Claude Code gestisca il mio account Retell?

È sicuro quanto la chiave e le approvazioni che gli concedi. Usa una chiave con i permessi minimi, mantieni attiva l'approvazione per ogni chiamata a invoke_api_endpoint e controlla qualsiasi chiamata a un endpoint di eliminazione o pubblicazione prima di approvarla.

I test tramite Claude Code hanno un costo?

L'utilizzo tramite il server MCP è utilizzo dell'API di Retell, quindi le chiamate che effettua vengono fatturate come qualsiasi altra chiamata. La pagina prezzi dei test di Retell spiega quanto costano i test, mentre l'utilizzo di Claude Code viene fatturato da Anthropic in base al tuo piano Claude, ai crediti di utilizzo o alle tariffe API, a seconda di come accedi.

Crea un agente e mettilo alla prova sulle tue chiamate

Secondo i dati della piattaforma di Retell, l'80% dei minuti in produzione passa attraverso agenti che i clienti creano e gestiscono in autonomia. Claude Code rende questo ciclo più breve. Segui la configurazione del server MCP, crea un agente in Retell e valutalo sulle tue chiamate prima di decidere qualsiasi altra cosa.

ROI Calculator
Estimate Your ROI from Automating Calls

See how much your business could save by switching to AI-powered voice agents.

All done! 
Your submission has been sent to your email
Oops! Something went wrong while submitting the form.
   1
   8
20
Oops! Something went wrong while submitting the form.

ROI Result

2,000

Total Human Agent Cost

$5,000
/month

AI Agent Cost

$3,000
/month

Estimated Savings

$2,000
/month

Estimate your monthly voice AI cost

$  0.11
Thank you! Your submission has been received!
Oops! Something went wrong while submitting the form.
Estimated monthly cost
$1,408
12,800 conversation minutes

Rivoluziona le tue operazioni di chiamata con Retell