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



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.

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 Retell | Connettore Retell AI in Claude | Dashboard di Retell | |
|---|---|---|---|
| Dove lavori | Il tuo terminale o IDE | Una chat in Claude sul web o in Claude Desktop | Un browser |
| Accesso | Una chiave API di Retell nell'header della richiesta | Il tuo login Retell, tramite OAuth | Il tuo login Retell |
| Cosa raggiunge | Gli endpoint dell'API di Retell consentiti dalla tua chiave, esclusi quelli deprecati | 52 strumenti dedicati con widget nella chat (a ottobre 2026) | Tutte le impostazioni |
| Tipi di agente | Tutto ciò che l'API supporta | Solo agenti single-prompt | Tutti |
| Ideale per | Sviluppatori, modifiche in blocco, tutto ciò che vuoi automatizzare con script o ripetere | Creare e modificare un agente descrivendolo | Conversation 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ù.

| Cosa chiedi | Cosa fa Claude Code tramite il server MCP | Richiede la tua approvazione |
|---|---|---|
| «Elenca i miei agenti» | Legge gli agenti e le loro versioni | Rischio basso, sola lettura |
| «Crea un agente che...» | Scrive un prompt, crea l'agente | Sì. Leggi prima il prompt |
| «Scrivi ed esegui i casi di test» | Crea casi di test di simulazione, li esegue, segnala quelli falliti | Sì |
| «Assegnalo al mio numero» | Elenca i numeri, assegna l'agente | Sì. Verifica quale agente sostituisce |
| «Chiama il mio telefono» | Crea una chiamata telefonica | Sì. Controlla il numero di destinazione |
| «Revisiona le chiamate recenti» | Elenca le chiamate e legge trascrizione, latenza e analisi post-chiamata di ciascuna | Rischio basso, ma le trascrizioni possono contenere dati personali |
| «Elimina il vecchio agente» | Chiama un endpoint di eliminazione | Sì. 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.
See how much your business could save by switching to AI-powered voice agents.
Your submission has been sent to your email
ROI Result
Total Human Agent Cost
AI Agent Cost
Estimated Savings
Estimate your monthly voice AI cost
Read Other Blogs
Rivoluziona le tue operazioni di chiamata con Retell

Inizia oggi a creare conversazioni più intelligenti.




