{"id":19043,"date":"2026-09-09T06:56:03","date_gmt":"2026-09-09T10:56:03","guid":{"rendered":"https:\/\/wp.glbgpt.com\/?p=19043"},"modified":"2026-09-09T06:56:05","modified_gmt":"2026-09-09T10:56:05","slug":"claude-api-guide","status":"publish","type":"post","link":"https:\/\/wp.glbgpt.com\/it\/hub\/claude-api-guide","title":{"rendered":"Guida all'API Claude: prezzi, configurazione e la tua prima richiesta"},"content":{"rendered":"<p class=\"claude-api-deck wp-block-paragraph\">Per effettuare la tua prima richiesta API Claude, crea una chiave della Console Claude, memorizzala in una variabile d'ambiente, chiama l'endpoint Messages e leggi il dato restituito <code>utilizzo<\/code> campi e calcolare il costo in token. Questa guida illustra la procedura da seguire utilizzando gli ID dei modelli e i prezzi attuali, verificati l'8 settembre 2026.<\/p>\n\n\n\n<aside class=\"cap-answer\" aria-label=\"Percorso rapido API Claude\" style=\"box-sizing:border-box;margin:28px 0;padding:20px 22px;border:1px solid #bed0c9;border-left:5px solid #0f766e;border-radius:6px;background:#f0f8f5;color:#183b34\">\n<!-- MODULE:direct-answer:START -->\n<style>\n.cap-answer{box-sizing:border-box;margin:28px 0;padding:20px 22px;border:1px solid #bed0c9;border-left:5px solid #0f766e;border-radius:6px;background:#f0f8f5;color:#183b34;font:16px\/1.6 system-ui,-apple-system,BlinkMacSystemFont,\"Segoe UI\",sans-serif;letter-spacing:0}.cap-answer strong{display:block;margin-bottom:8px;color:#15352f;font-size:18px}.cap-answer ol{display:grid;grid-template-columns:repeat(5,minmax(0,1fr));gap:8px;margin:0;padding:0;list-style:none;counter-reset:steps}.cap-answer li{min-width:0;padding:10px;border:1px solid #cbdad5;border-radius:4px;background:#fff;color:#2e443e;font-size:13px}.cap-answer li:before{counter-increment:steps;content:counter(steps);display:grid;place-items:center;width:24px;height:24px;margin-bottom:7px;border-radius:50%;background:#203a34;color:#fff;font-weight:800}@media(max-width:760px){.cap-answer{padding:17px 15px}.cap-answer ol{grid-template-columns:1fr}.cap-answer li{display:grid;grid-template-columns:30px 1fr;align-items:center}.cap-answer li:before{margin:0}}\n<\/style>\n  <strong>Il percorso della tua prima richiesta<\/strong>\n  <ol><li>Crea una chiave Console<\/li><li>Conservalo in un luogo sicuro<\/li><li>API dei messaggi delle chiamate<\/li><li>Leggi l'utilizzo dei token<\/li><li>Stima il costo<\/li><\/ol>\n<!-- MODULE:direct-answer:END -->\n<\/aside>\n\n\n\n<p class=\"globalgpt-intro wp-block-paragraph\">Una volta compreso il percorso dell\u2019API, la domanda successiva \u00e8: in che misura il tuo lavoro quotidiano richiede effettivamente un\u2019integrazione personalizzata? Per la ricerca, la scrittura, la programmazione e la produzione creativa, <a href=\"https:\/\/www.glbgpt.com\/home?inviter=hub_content_home&amp;login=1\">GlobalGPT<\/a> offre un modo pi\u00f9 economico per utilizzare Claude insieme a GPT-5.6 Sol, Gemini 3 Pro, Kimi K3 e altri modelli di punta. Un unico abbonamento riunisce i modelli e un\u2019ampia gamma di strumenti di IA in un\u2019unica dashboard, consentendo di passare dall\u2019idea al risultato finale senza dover ricorrere a servizi separati. Quando \u00e8 necessario integrare l\u2019IA nel proprio ambiente di sviluppo, la CLI di GlobalGPT collega lo stesso spazio di lavoro al terminale e agli strumenti di produzione esistenti.<\/p>\n\n\n\n<div class=\"wp-block-group is-layout-constrained wp-block-group-is-layout-constrained\">\n<figure class=\"wp-block-image size-full\"><a href=\"https:\/\/www.glbgpt.com\/home\/claude-opus-5?inviter=hub_claude5&amp;login=1\"><img alt=\"\" fetchpriority=\"high\" decoding=\"async\" width=\"973\" height=\"619\" src=\"https:\/\/wp.glbgpt.com\/wp-content\/uploads\/2026\/07\/claude-opus-5-1.webp\" class=\"wp-image-17213\" srcset=\"https:\/\/wp.glbgpt.com\/wp-content\/uploads\/2026\/07\/claude-opus-5-1.webp 973w, https:\/\/wp.glbgpt.com\/wp-content\/uploads\/2026\/07\/claude-opus-5-1-300x191.webp 300w, https:\/\/wp.glbgpt.com\/wp-content\/uploads\/2026\/07\/claude-opus-5-1-768x489.webp 768w, https:\/\/wp.glbgpt.com\/wp-content\/uploads\/2026\/07\/claude-opus-5-1-18x12.webp 18w\" sizes=\"(max-width: 973px) 100vw, 973px\" \/><\/a><\/figure>\n\n\n\n<div class=\"wp-block-buttons is-content-justification-center is-layout-flex wp-container-core-buttons-is-layout-3e41869c wp-block-buttons-is-layout-flex\">\n<div class=\"wp-block-button\"><a class=\"wp-block-button__link has-black-color has-luminous-vivid-amber-background-color has-text-color has-background has-link-color wp-element-button\" href=\"https:\/\/www.glbgpt.com\/home\/claude-opus-5?inviter=hub_claude5&amp;login=1\">Prova Claude Opus 5<\/a><\/div>\n<\/div>\n<\/div>\n\n\n\n<nav class=\"cap-toc\" aria-label=\"Indice\" style=\"box-sizing:border-box;margin:30px 0;padding:21px 23px;border-top:5px solid #d5533f;border-radius:6px;background:#202d29;color:#f5f8f6\">\n<!-- MODULE:toc:START -->\n<style>\n.cap-toc{box-sizing:border-box;margin:30px 0;padding:21px 23px;border-top:5px solid #d5533f;border-radius:6px;background:#202d29;color:#f5f8f6;font:15px\/1.5 system-ui,-apple-system,BlinkMacSystemFont,\"Segoe UI\",sans-serif;letter-spacing:0}.cap-toc strong{display:block;margin-bottom:12px;font-size:18px}.cap-toc ol{columns:2;column-gap:34px;margin:0;padding-left:21px}.cap-toc li{break-inside:avoid;margin:0 0 8px;padding-left:3px}.cap-toc a{color:#b9eee4;text-decoration-thickness:1px;text-underline-offset:3px}.cap-toc a:hover,.cap-toc a:focus{color:#fff}@media(max-width:660px){.cap-toc{padding:18px 16px}.cap-toc ol{columns:1}}\n<\/style>\n  <strong>In questa guida<\/strong>\n  <ol>\n    <li><a href=\"#what-is-claude-api\">Che cos'\u00e8 l'API Claude?<\/a><\/li>\n    <li><a href=\"#claude-api-pricing-model-ids\">Prezzi dell'API Claude e ID dei modelli attuali<\/a><\/li>\n    <li><a href=\"#claude-api-prerequisites\">Cosa ti serve prima della tua prima richiesta<\/a><\/li>\n    <li><a href=\"#claude-api-curl\">Invia la tua prima richiesta API Claude con cURL<\/a><\/li>\n    <li><a href=\"#claude-api-python\">Invia la stessa richiesta con l'SDK Python<\/a><\/li>\n    <li><a href=\"#claude-api-usage-cost\">Come interpretare i dati di consumo e calcolare i costi<\/a><\/li>\n    <li><a href=\"#claude-api-cost-calculator\">Calcolatore dei prezzi API Claude<\/a><\/li>\n    <li><a href=\"#claude-api-errors\">Errori comuni dell'API Claude e relative soluzioni<\/a><\/li>\n    <li><a href=\"#claude-api-cost-controls\">Come contenere i costi dell'API Claude<\/a><\/li>\n    <li><a href=\"#claude-api-next-steps\">Prossimi passi dopo la prima richiesta<\/a><\/li>\n    <li><a href=\"#claude-api-faq\">Domande frequenti<\/a><\/li>\n  <\/ol>\n<!-- MODULE:toc:END -->\n<\/nav>\n\n\n\n<h2 id=\"what-is-claude-api\" class=\"wp-block-heading\">Che cos'\u00e8 l'API Claude?<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">L'API Claude \u00e8 l'interfaccia per sviluppatori di Anthropic che consente di inviare richieste strutturate ai modelli Claude da un'applicazione, uno script o un servizio backend. \u00c8 possibile inviare messaggi a un endpoint HTTPS e ricevere una risposta strutturata contenente il contenuto generato oltre a metadati quali il modello, il motivo dell'interruzione e l'utilizzo del token.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Abbonamenti API Claude vs. Claude.ai<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">L'accesso all'API e gli abbonamenti a Claude.ai sono destinati a scopi diversi. Un piano Claude.ai consente di accedere al prodotto di chat di Anthropic. L\u2019API \u00e8 un accesso a consumo per sviluppatori tramite la Console Claude, con fatturazione separata in base all\u2019utilizzo. Il Centro assistenza di Anthropic precisa che Claude Pro non include l\u2019utilizzo dell\u2019API della Console.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Se hai bisogno di una distinzione pi\u00f9 ampia tra i piani per i consumatori, il codice Claude e la fatturazione a token, consulta la nostra guida completa <a href=\"https:\/\/www.glbgpt.com\/hub\/claude-ai-pricing-2026-the-ultimate-guide-to-plans-api-costs-and-limits\/\">Guida ai prezzi Claude<\/a>. Per questo tutorial, il punto fondamentale \u00e8 semplice: creare e ricaricare l'account API separatamente da qualsiasi abbonamento a Claude.ai.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Il percorso in cinque fasi per presentare una prima richiesta<\/h3>\n\n\n\n<ol class=\"wp-block-list\">\n<li>Crea una chiave API nella console Claude.<\/li>\n\n\n\n<li>Conservalo nel <code>ANTHROPIC_API_KEY<\/code> variabile d'ambiente.<\/li>\n\n\n\n<li>Invia una richiesta a <code>https:\/\/api.anthropic.com\/v1\/messages<\/code>.<\/li>\n\n\n\n<li>Leggi il contenuto restituito e <code>utilizzo<\/code> oggetto.<\/li>\n\n\n\n<li>Moltiplicare ciascuna categoria di token per la tariffa applicabile per ogni milione di token.<\/li>\n<\/ol>\n\n\n\n<h2 id=\"claude-api-pricing-model-ids\" class=\"wp-block-heading\">Prezzi dell'API Claude e ID dei modelli attuali<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Anthropic riporta i prezzi delle API in dollari statunitensi per milione di token, spesso abbreviati con MTok. Gli input e gli output vengono fatturati separatamente. La memorizzazione nella cache dei prompt prevede tariffe distinte per le scritture ogni cinque minuti, le scritture ogni ora e le letture dalla cache; pertanto, per ottenere una stima affidabile \u00e8 necessario tenere separate queste categorie.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Modelli attuali e ID API esatti<\/h3>\n\n\n\n<figure class=\"wp-block-table is-style-stripes\"><table><thead><tr><th>Modello<\/th><th>ID API<\/th><th>Input \/ MTok<\/th><th>Output \/ MTok<\/th><\/tr><\/thead><tbody><tr><td>Claude Fable 5.1<\/td><td><code>claude-favola-5-1<\/code><\/td><td>$10<\/td><td>$50<\/td><\/tr><tr><td>Claude Opus 5<\/td><td><code>claude-opus-5<\/code><\/td><td>$5<\/td><td>$25<\/td><\/tr><tr><td>Claude Sonetto 5<\/td><td><code>claude-sonnet-5<\/code><\/td><td>$2<\/td><td>$10<\/td><\/tr><tr><td>Claude Haiku 4.5<\/td><td><code>claude-haiku-4-5-20251001<\/code><\/td><td>$1<\/td><td>$5<\/td><\/tr><\/tbody><\/table><figcaption class=\"wp-element-caption\">Le tariffe API di base sono state verificate rispetto ai prezzi ufficiali e alla documentazione relativa al modello di Anthropic in data 8 settembre 2026.<\/figcaption><\/figure>\n\n\n\n<figure class=\"wp-block-image size-full\"><img decoding=\"async\" width=\"1400\" height=\"788\" src=\"https:\/\/wp.glbgpt.com\/wp-content\/uploads\/2026\/09\/claude-api-current-model-ids-2026-1.webp\" alt=\"Tabella dei modelli Anthropic che riporta i nomi attuali dei modelli Claude e gli ID API\" class=\"wp-image-19078\" srcset=\"https:\/\/wp.glbgpt.com\/wp-content\/uploads\/2026\/09\/claude-api-current-model-ids-2026-1.webp 1400w, https:\/\/wp.glbgpt.com\/wp-content\/uploads\/2026\/09\/claude-api-current-model-ids-2026-1-300x169.webp 300w, https:\/\/wp.glbgpt.com\/wp-content\/uploads\/2026\/09\/claude-api-current-model-ids-2026-1-1024x576.webp 1024w, https:\/\/wp.glbgpt.com\/wp-content\/uploads\/2026\/09\/claude-api-current-model-ids-2026-1-768x432.webp 768w, https:\/\/wp.glbgpt.com\/wp-content\/uploads\/2026\/09\/claude-api-current-model-ids-2026-1-18x10.webp 18w\" sizes=\"(max-width: 1400px) 100vw, 1400px\" \/><figcaption class=\"wp-element-caption\">ID dei modelli Claude attualmente presenti nella documentazione ufficiale di Anthropic, verificati l'8 settembre 2026.<\/figcaption><\/figure>\n\n\n\n<h3 class=\"wp-block-heading\">Quale modello dovresti usare per questo tutorial?<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">La guida rapida ufficiale utilizzata <code>claude-opus-5<\/code> al momento della verifica di questa guida, pertanto gli esempi relativi a cURL e Python riportati di seguito utilizzano lo stesso ID. Considerate Opus come punto di partenza per il tutorial, quindi scegliete il modello di produzione in base al carico di lavoro, ai requisiti di qualit\u00e0, alla latenza e al budget. Gli ID dei modelli e lo stato del ciclo di vita possono subire variazioni, pertanto vi consigliamo di ricontrollare le pagine \"Modelli\" e \"Deprecazioni\" prima di distribuire codice destinato a una lunga durata.<\/p>\n\n\n\n<figure class=\"wp-block-image size-full\"><img decoding=\"async\" width=\"1400\" height=\"788\" src=\"https:\/\/wp.glbgpt.com\/wp-content\/uploads\/2026\/09\/claude-api-official-pricing-2026-1.webp\" alt=\"Tabella ufficiale dei prezzi API Anthropic e Claude con le tariffe per categoria di token\" class=\"wp-image-19079\" srcset=\"https:\/\/wp.glbgpt.com\/wp-content\/uploads\/2026\/09\/claude-api-official-pricing-2026-1.webp 1400w, https:\/\/wp.glbgpt.com\/wp-content\/uploads\/2026\/09\/claude-api-official-pricing-2026-1-300x169.webp 300w, https:\/\/wp.glbgpt.com\/wp-content\/uploads\/2026\/09\/claude-api-official-pricing-2026-1-1024x576.webp 1024w, https:\/\/wp.glbgpt.com\/wp-content\/uploads\/2026\/09\/claude-api-official-pricing-2026-1-768x432.webp 768w, https:\/\/wp.glbgpt.com\/wp-content\/uploads\/2026\/09\/claude-api-official-pricing-2026-1-18x10.webp 18w\" sizes=\"(max-width: 1400px) 100vw, 1400px\" \/><figcaption class=\"wp-element-caption\">I prezzi dell'API Anthropic sono indicati per milione di token e possono subire variazioni; i tassi riportati sono stati verificati l'8 settembre 2026.<\/figcaption><\/figure>\n\n\n\n<figure class=\"capv-figure\" data-verified-on=\"2026-09-08\" style=\"box-sizing:border-box;width:100%;margin:30px 0;padding:25px 27px 21px;border:1px solid #c9d1cd;border-top:6px solid #d5533f;border-radius:7px;background:#fff;color:#202723\">\n<!-- MODULE:price-comparison:START -->\n<style>\n.capv-figure{box-sizing:border-box;width:100%;margin:30px 0;padding:25px 27px 21px;border:1px solid #c9d1cd;border-top:6px solid #d5533f;border-radius:7px;background:#fff;color:#202723;font:14px\/1.45 system-ui,-apple-system,BlinkMacSystemFont,\"Segoe UI\",sans-serif;letter-spacing:0}.capv-head{display:flex;justify-content:space-between;gap:20px;align-items:flex-end;margin-bottom:20px}.capv-title{margin:0 0 5px;font-size:25px;line-height:1.15;font-weight:800}.capv-head p{margin:0;color:#5d6862}.capv-key{display:flex;gap:14px;flex:0 0 auto;color:#46514c;font-size:12px;font-weight:700}.capv-key span:before{content:\"\";display:inline-block;width:11px;height:11px;margin-right:5px;border-radius:2px;vertical-align:-1px}.capv-key .input:before{background:#107469}.capv-key .output:before{background:#d5533f}.capv-rows{display:grid;gap:13px}.capv-row{display:grid;grid-template-columns:225px 1fr;gap:16px;align-items:center}.capv-name strong{display:block;font-size:15px}.capv-name code{color:#66716c;font-size:11px;overflow-wrap:anywhere}.capv-bars{display:grid;gap:6px}.capv-barline{display:grid;grid-template-columns:1fr 82px;align-items:center;gap:10px}.capv-track{height:18px;background:#edf0ee;border-radius:3px;overflow:hidden}.capv-bar{height:100%;min-width:3px;border-radius:3px}.capv-bar.input{background:#107469}.capv-bar.output{background:#d5533f}.capv-value{text-align:right;color:#2c3732;font-size:12px;font-variant-numeric:tabular-nums}.capv-foot{display:flex;justify-content:space-between;gap:18px;margin-top:20px;padding-top:12px;border-top:1px solid #e0e5e2;color:#5d6862;font-size:11px}.capv-foot a{color:#0a665d;font-weight:750}@media(max-width:680px){.capv-figure{padding:19px 15px 16px}.capv-head{display:block}.capv-title{font-size:21px}.capv-key{margin-top:10px}.capv-row{grid-template-columns:1fr;gap:5px}.capv-foot{display:block}.capv-foot span{display:block;margin-bottom:4px}}\n<\/style>\n  <header class=\"capv-head\"><div><div class=\"capv-title\" role=\"heading\" aria-level=\"3\">Prezzi dei token di base API Claude<\/div><p>USD per milione di token. La lunghezza della barra \u00e8 normalizzata rispetto al valore massimo dell'output $50.<\/p><\/div><div class=\"capv-key\" aria-label=\"Legenda\"><span class=\"input\">Ingresso<\/span><span class=\"output\">Uscita<\/span><\/div><\/header>\n  <div class=\"capv-rows\">\n    <div class=\"capv-row\"><div class=\"capv-name\"><strong>Claude Fable 5.1<\/strong><code>claude-favola-5-1<\/code><\/div><div class=\"capv-bars\"><div class=\"capv-barline\"><div class=\"capv-track\"><div class=\"capv-bar input\" style=\"width:20%\"><\/div><\/div><span class=\"capv-value\">Ingresso $10<\/span><\/div><div class=\"capv-barline\"><div class=\"capv-track\"><div class=\"capv-bar output\" style=\"width:100%\"><\/div><\/div><span class=\"capv-value\">Uscita $50<\/span><\/div><\/div><\/div>\n    <div class=\"capv-row\"><div class=\"capv-name\"><strong>Claude Opus 5<\/strong><code>claude-opus-5<\/code><\/div><div class=\"capv-bars\"><div class=\"capv-barline\"><div class=\"capv-track\"><div class=\"capv-bar input\" style=\"width:10%\"><\/div><\/div><span class=\"capv-value\">Ingresso $5<\/span><\/div><div class=\"capv-barline\"><div class=\"capv-track\"><div class=\"capv-bar output\" style=\"width:50%\"><\/div><\/div><span class=\"capv-value\">Uscita $25<\/span><\/div><\/div><\/div>\n    <div class=\"capv-row\"><div class=\"capv-name\"><strong>Claude Sonetto 5<\/strong><code>claude-sonnet-5<\/code><\/div><div class=\"capv-bars\"><div class=\"capv-barline\"><div class=\"capv-track\"><div class=\"capv-bar input\" style=\"width:4%\"><\/div><\/div><span class=\"capv-value\">Ingresso $2<\/span><\/div><div class=\"capv-barline\"><div class=\"capv-track\"><div class=\"capv-bar output\" style=\"width:20%\"><\/div><\/div><span class=\"capv-value\">Uscita $10<\/span><\/div><\/div><\/div>\n    <div class=\"capv-row\"><div class=\"capv-name\"><strong>Claude Haiku 4.5<\/strong><code>claude-haiku-4-5-20251001<\/code><\/div><div class=\"capv-bars\"><div class=\"capv-barline\"><div class=\"capv-track\"><div class=\"capv-bar input\" style=\"width:2%\"><\/div><\/div><span class=\"capv-value\">Ingresso $1<\/span><\/div><div class=\"capv-barline\"><div class=\"capv-track\"><div class=\"capv-bar output\" style=\"width:10%\"><\/div><\/div><span class=\"capv-value\">Uscita $5<\/span><\/div><\/div><\/div>\n  <\/div>\n  <figcaption class=\"capv-foot\"><span>Tariffe verificate l'8 settembre 2026. I modificatori relativi a cache, elaborazione in batch e \"solo Stati Uniti\" non sono riportati in questa tabella.<\/span><a href=\"https:\/\/platform.claude.com\/docs\/en\/about-claude\/pricing\" target=\"_blank\" rel=\"noopener\">Prezzi ufficiali Anthropic<\/a><\/figcaption>\n<!-- MODULE:price-comparison:END -->\n<\/figure>\n\n\n\n<h2 id=\"claude-api-prerequisites\" class=\"wp-block-heading\">Cosa ti serve prima della tua prima richiesta<\/h2>\n\n\n\n<h3 class=\"wp-block-heading\">Crea un account Console Claude e una chiave API<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">Apri la console Claude, crea o seleziona l'organizzazione appropriata e crea una chiave API. Anthropic avverte che una nuova chiave viene visualizzata solo una volta, quindi, quando compare, conservala in un gestore di segreti approvato o in un altro luogo sicuro. Non inserire la chiave in uno screenshot, in un documento condiviso, in un repository pubblico o in codice JavaScript lato browser.<\/p>\n\n\n\n<figure class=\"wp-block-image size-full\"><img loading=\"lazy\" decoding=\"async\" width=\"1400\" height=\"788\" src=\"https:\/\/wp.glbgpt.com\/wp-content\/uploads\/2026\/09\/claude-api-key-one-time-display-warning-1.webp\" alt=\"La documentazione relativa a Anthropic avverte che \u00e8 necessario conservare in modo sicuro una nuova chiave API Claude\" class=\"wp-image-19075\" srcset=\"https:\/\/wp.glbgpt.com\/wp-content\/uploads\/2026\/09\/claude-api-key-one-time-display-warning-1.webp 1400w, https:\/\/wp.glbgpt.com\/wp-content\/uploads\/2026\/09\/claude-api-key-one-time-display-warning-1-300x169.webp 300w, https:\/\/wp.glbgpt.com\/wp-content\/uploads\/2026\/09\/claude-api-key-one-time-display-warning-1-1024x576.webp 1024w, https:\/\/wp.glbgpt.com\/wp-content\/uploads\/2026\/09\/claude-api-key-one-time-display-warning-1-768x432.webp 768w, https:\/\/wp.glbgpt.com\/wp-content\/uploads\/2026\/09\/claude-api-key-one-time-display-warning-1-18x10.webp 18w\" sizes=\"(max-width: 1400px) 100vw, 1400px\" \/><figcaption class=\"wp-element-caption\">Conserva la chiave API in modo sicuro una volta creata; non inserirla mai nel codice del browser n\u00e9 in uno screenshot.<\/figcaption><\/figure>\n\n\n\n<h3 class=\"wp-block-heading\">Salva la chiave in una variabile d'ambiente<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">Negli esempi si presume che la variabile <code>ANTHROPIC_API_KEY<\/code>. Inserisci il valore reale solo nel tuo terminale privato o nel tuo sistema di gestione dei segreti. Il comando riportato di seguito legge il valore senza visualizzarlo sullo schermo, quindi lo esporta per la sessione corrente della shell:<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>read -s ANTHROPIC_API_KEY\nexport ANTHROPIC_API_KEY<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">Le variabili d'ambiente riducono il rischio di esposizione accidentale, ma non costituiscono una strategia completa per la gestione dei segreti. Le applicazioni di produzione dovrebbero attenersi alle procedure di archiviazione dei segreti e di controllo degli accessi previste dalla piattaforma di hosting.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Controlla l'addebito e scegli un limite di prova sicuro<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">La fatturazione dell'API \u00e8 separata dagli abbonamenti a Claude.ai. Anthropic afferma che la maggior parte delle organizzazioni prepaga i crediti di utilizzo, mentre le organizzazioni con fatturazione mensile costituiscono un'eccezione. Verifica che il tuo account Console sia in grado di effettuare richieste API, quindi effettua una prima richiesta di piccole dimensioni con <code>max_tokens: 128<\/code>. Quel campo limita l'output generato; non riserva n\u00e9 garantisce 128 token di output fatturati.<\/p>\n\n\n\n<h2 id=\"claude-api-curl\" class=\"wp-block-heading\">Invia la tua prima richiesta API Claude con cURL<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">cURL \u00e8 utile per visualizzare direttamente il contenuto della richiesta. L'esempio riportato di seguito utilizza l'endpoint Messages, il tipo di contenuto JSON, l'intestazione della chiave API, l'intestazione della versione Anthropic, l'ID verificato del modello Quickstart e un messaggio utente.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Prima di eseguire uno dei due esempi, aggiungi la tua chiave API e verifica che la fatturazione API sia abilitata per l'organizzazione. Il codice segue il formato di richiesta documentato da Anthropic e ha superato i controlli di sintassi locali, ma qui non \u00e8 inclusa alcuna risposta da un account attivo.<\/p>\n\n\n\n<section class=\"capcodebox\" aria-label=\"Esempio di cURL che pu\u00f2 essere copiato\" style=\"box-sizing:border-box;margin:28px 0;overflow:hidden;border:1px solid #bcc9c4;border-top:6px solid #d5533f;border-radius:7px;background:#fff;color:#202723\">\n<!-- MODULE:code-examples:START -->\n<style>\n.capcodebox{box-sizing:border-box;margin:28px 0;overflow:hidden;border:1px solid #bcc9c4;border-top:6px solid #d5533f;border-radius:7px;background:#fff;color:#202723;font:14px\/1.5 system-ui,-apple-system,BlinkMacSystemFont,\"Segoe UI\",sans-serif;letter-spacing:0}.capcodebox *{box-sizing:border-box}.capcodebox-head{display:flex;justify-content:space-between;gap:16px;align-items:flex-start;padding:18px 20px 14px}.capcodebox-title{font-size:20px;font-weight:800}.capcodebox-badges{display:flex;flex-wrap:wrap;justify-content:flex-end;gap:6px}.capcodebox-badge{padding:4px 7px;border:1px solid #a8c4bb;border-radius:4px;background:#edf7f4;color:#155a4f;font-size:11px;font-weight:800}.capcodebox-badge.warn{border-color:#dfbd87;background:#fff7e8;color:#70470a}.capcodebox-panel{position:relative;background:#18231f;color:#edf4f0}.capcodebox-toolbar{display:flex;justify-content:flex-end;padding:9px 12px;border-bottom:1px solid #34453f}.capcodebox-copy{min-height:34px;padding:6px 10px;border:1px solid #8ab3a7;border-radius:4px;background:#24423a;color:#fff;cursor:pointer;font-weight:750}.capcodebox-copy:focus-visible{outline:3px solid #e9ae5c;outline-offset:2px}.capcodebox pre{margin:0;padding:18px 20px;overflow-x:auto;color:#edf4f0;font:13px\/1.6 ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;white-space:pre;tab-size:2}.capcodebox-note{margin:0;padding:11px 20px;background:#f7f9f8;color:#53615b;font-size:12px}@media(max-width:640px){.capcodebox-head{display:block;padding:15px}.capcodebox-badges{justify-content:flex-start;margin-top:9px}.capcodebox pre{padding:15px;font-size:11px}.capcodebox-note{padding:10px 15px}}\n<\/style>\n  <header class=\"capcodebox-head\"><div class=\"capcodebox-title\">Prima richiesta API Claude con cURL<\/div><div class=\"capcodebox-badges\"><span class=\"capcodebox-badge\">API Messaggi<\/span><span class=\"capcodebox-badge\">Variabile d'ambiente<\/span><span class=\"capcodebox-badge warn\">Aggiungi la tua chiave per eseguire il programma<\/span><\/div><\/header>\n  <div class=\"capcodebox-panel\"><div class=\"capcodebox-toolbar\"><button class=\"capcodebox-copy\" type=\"button\" data-copy-target=\"cap-curl-code\">Copia cURL<\/button><\/div><pre id=\"cap-curl-code\"><code>curl https:\/\/api.anthropic.com\/v1\/messages \\\n  --header \"content-type: application\/json\" \\\n  --header \"x-api-key: $ANTHROPIC_API_KEY\" \\\n  --header \"anthropic-version: 2023-06-01\" \\\n  --data '{\n    \"model\": \"claude-opus-5\",\n    \"max_tokens\": 128,\n    \"messages\": [{\n \"role\": \"user\",\n \"content\": \"Rispondi con una frase che spieghi cos'\u00e8 un'API.\"\n    }]\n  }'<\/code><\/pre><\/div>\n  <p class=\"capcodebox-note\">Aggiungi la chiave della console Claude tramite la variabile d'ambiente, mantieni l'intestazione della versione e esegui il comando da un terminale privato.<\/p>\n<script>\ndocument.querySelectorAll(\".capcodebox-copy\").forEach(function(button){button.addEventListener(\"click\",function(){var target=document.getElementById(button.getAttribute(\"data-copy-target\"));if(!target)return;navigator.clipboard.writeText(target.innerText).then(function(){var old=button.textContent;button.textContent=\"Copied\";setTimeout(function(){button.textContent=old},1400)}).catch(function(){button.textContent=\"Select code to copy\"})})});\n<\/script>\n<!-- MODULE:code-examples:END -->\n<\/section>\n\n\n\n<h3 class=\"wp-block-heading\">Funzioni delle singole intestazioni e dei campi JSON<\/h3>\n\n\n\n<figure class=\"wp-block-table is-style-stripes\"><table><thead><tr><th>Parte<\/th><th>Scopo<\/th><\/tr><\/thead><tbody><tr><td><code>tipo di contenuto<\/code><\/td><td>Indica all'endpoint che il corpo della richiesta \u00e8 in formato JSON.<\/td><\/tr><tr><td><code>x-api-key<\/code><\/td><td>Autentica la richiesta utilizzando il valore memorizzato nella variabile d'ambiente.<\/td><\/tr><tr><td><code>versione antropica<\/code><\/td><td>Seleziona il contratto API documentato utilizzato dalla richiesta.<\/td><\/tr><tr><td><code>modello<\/code><\/td><td>Seleziona l'ID esatto del modello API Claude.<\/td><\/tr><tr><td><code>max_tokens<\/code><\/td><td>Imposta il numero massimo di token che Claude pu\u00f2 generare per questa risposta.<\/td><\/tr><tr><td><code>messaggi<\/code><\/td><td>Fornisce gli input ordinati della conversazione, compresi i ruoli e i valori dei contenuti.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\">Se il comando restituisce un errore, controlla lo stato HTTP e il tipo di errore prima di modificare la richiesta. Gli errori di autenticazione e di fatturazione richiedono una correzione dell'account, mentre un JSON non valido o un ID modello non corretto richiedono una modifica della richiesta.<\/p>\n\n\n\n<h2 id=\"claude-api-python\" class=\"wp-block-heading\">Invia la stessa richiesta con l'SDK Python<\/h2>\n\n\n\n<h3 class=\"wp-block-heading\">Installa l'SDK ufficiale Anthropic<\/h3>\n\n\n\n<pre class=\"wp-block-code\"><code>python -m pip install anthropic<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">Utilizza un ambiente virtuale quando questo rientra nel tuo normale flusso di lavoro in Python. L'SDK legge <code>ANTHROPIC_API_KEY<\/code> dall'ambiente quando <code>anthropic.Anthropic()<\/code> viene creato senza una chiave esplicita.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Esegui la richiesta equivalente in Python<\/h3>\n\n\n\n<section class=\"cappython\" aria-label=\"Esempio di SDK Python copiabile\" style=\"box-sizing:border-box;margin:28px 0;overflow:hidden;border:1px solid #bcc9c4;border-top:6px solid #107469;border-radius:7px;background:#fff;color:#202723\">\n<!-- MODULE:python-example:START -->\n<style>\n.cappython{box-sizing:border-box;margin:28px 0;overflow:hidden;border:1px solid #bcc9c4;border-top:6px solid #107469;border-radius:7px;background:#fff;color:#202723;font:14px\/1.5 system-ui,-apple-system,BlinkMacSystemFont,\"Segoe UI\",sans-serif;letter-spacing:0}.cappython *{box-sizing:border-box}.cappython-head{display:flex;justify-content:space-between;gap:16px;align-items:flex-start;padding:18px 20px 14px}.cappython-title{font-size:20px;font-weight:800}.cappython-badges{display:flex;flex-wrap:wrap;justify-content:flex-end;gap:6px}.cappython-badge{padding:4px 7px;border:1px solid #a8c4bb;border-radius:4px;background:#edf7f4;color:#155a4f;font-size:11px;font-weight:800}.cappython-badge.warn{border-color:#dfbd87;background:#fff7e8;color:#70470a}.cappython-panel{background:#18231f;color:#edf4f0}.cappython-toolbar{display:flex;justify-content:flex-end;padding:9px 12px;border-bottom:1px solid #34453f}.cappython-copy{min-height:34px;padding:6px 10px;border:1px solid #8ab3a7;border-radius:4px;background:#24423a;color:#fff;cursor:pointer;font-weight:750}.cappython-copy:focus-visible{outline:3px solid #e9ae5c;outline-offset:2px}.cappython pre{margin:0;padding:18px 20px;overflow-x:auto;color:#edf4f0;font:13px\/1.6 ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;white-space:pre;tab-size:2}.cappython-note{margin:0;padding:11px 20px;background:#f7f9f8;color:#53615b;font-size:12px}@media(max-width:640px){.cappython-head{display:block;padding:15px}.cappython-badges{justify-content:flex-start;margin-top:9px}.cappython pre{padding:15px;font-size:11px}.cappython-note{padding:10px 15px}}\n<\/style>\n  <header class=\"cappython-head\"><div class=\"cappython-title\">Prima richiesta API Claude con Python<\/div><div class=\"cappython-badges\"><span class=\"cappython-badge\">SDK ufficiale<\/span><span class=\"cappython-badge\">Variabile d'ambiente<\/span><span class=\"cappython-badge warn\">Utilizzo delle stampe<\/span><\/div><\/header>\n  <div class=\"cappython-panel\"><div class=\"cappython-toolbar\"><button class=\"cappython-copy\" type=\"button\" data-copy-target=\"cap-python-code\">Copia Python<\/button><\/div><pre id=\"cap-python-code\"><code>import anthropic\n\nclient = anthropic.Anthropic()\n\nmessage = client.messages.create(\n    model=\"claude-opus-5\",\n    max_tokens=128,\n    messages=[\n {\n \"role\": \"user\",\n \"content\": \"Rispondi con una frase spiegando cos'\u00e8 un'API.\",\n }\n    ],\n)\n\nfor block in message.content:\n    if block.type == \"text\":\n print(block.text)\n\nprint(message.usage)<\/code><\/pre><\/div>\n  <p class=\"cappython-note\">L'SDK legge la stessa variabile d'ambiente, restituisce blocchi di contenuto tipizzati ed espone i dati di utilizzo per il monitoraggio dei costi.<\/p>\n<script>\ndocument.querySelectorAll(\".cappython-copy\").forEach(function(button){button.addEventListener(\"click\",function(){var target=document.getElementById(button.getAttribute(\"data-copy-target\"));if(!target)return;navigator.clipboard.writeText(target.innerText).then(function(){var old=button.textContent;button.textContent=\"Copied\";setTimeout(function(){button.textContent=old},1400)}).catch(function(){button.textContent=\"Select code to copy\"})})});\n<\/script>\n<!-- MODULE:python-example:END -->\n<\/section>\n\n\n\n<figure class=\"wp-block-image size-full\"><img loading=\"lazy\" decoding=\"async\" width=\"1400\" height=\"788\" src=\"https:\/\/wp.glbgpt.com\/wp-content\/uploads\/2026\/09\/claude-api-quickstart-python-example-1.webp\" alt=\"Guida rapida ufficiale all&#039;SDK Python Anthropic per l&#039;invio di un messaggio API Claude\" class=\"wp-image-19077\" srcset=\"https:\/\/wp.glbgpt.com\/wp-content\/uploads\/2026\/09\/claude-api-quickstart-python-example-1.webp 1400w, https:\/\/wp.glbgpt.com\/wp-content\/uploads\/2026\/09\/claude-api-quickstart-python-example-1-300x169.webp 300w, https:\/\/wp.glbgpt.com\/wp-content\/uploads\/2026\/09\/claude-api-quickstart-python-example-1-1024x576.webp 1024w, https:\/\/wp.glbgpt.com\/wp-content\/uploads\/2026\/09\/claude-api-quickstart-python-example-1-768x432.webp 768w, https:\/\/wp.glbgpt.com\/wp-content\/uploads\/2026\/09\/claude-api-quickstart-python-example-1-18x10.webp 18w\" sizes=\"(max-width: 1400px) 100vw, 1400px\" \/><figcaption class=\"wp-element-caption\">La guida rapida a Python di Anthropic invia una richiesta all\u2019API Messages tramite l\u2019SDK ufficiale.<\/figcaption><\/figure>\n\n\n\n<h3 class=\"wp-block-heading\">Leggi il testo restituito in tutta sicurezza<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">Una risposta di tipo \"Message\" pu\u00f2 contenere pi\u00f9 di un blocco di contenuto, pertanto nell'esempio viene verificato il tipo di ciascun blocco prima di visualizzare il testo. Nelle applicazioni reali \u00e8 inoltre opportuno conservare l'ID della richiesta a fini di assistenza e registrazione, senza renderlo pubblico, registrare il modello restituito e il motivo dell'interruzione, nonch\u00e9 gestire in modo esplicito gli errori dell'API.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Mantieni il controllo del blocco di contenuto anche quando ti aspetti una risposta breve. In questo modo \u00e8 pi\u00f9 facile estendere l'esempio quando una risposta contiene pi\u00f9 blocchi, e la stampa <code>message.usage<\/code> ti fornisce i dati necessari per il calcolo dei costi riportato di seguito.<\/p>\n\n\n\n<h2 id=\"claude-api-usage-cost\" class=\"wp-block-heading\">Come interpretare i dati di consumo e calcolare i costi<\/h2>\n\n\n\n<h3 class=\"wp-block-heading\">Trova il testo della risposta, il modello, il motivo di interruzione e l'ID della richiesta<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">Il contratto di risposta dell'API Messages include contenuti generati, il modello che ha gestito la richiesta e il motivo dell'interruzione. La risposta HTTP contiene inoltre un identificatore della richiesta che pu\u00f2 aiutare il supporto Anthropic a tracciare un problema. Registrare con attenzione gli identificatori; non pubblicarli insieme ai contenuti o alle credenziali dei clienti.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Visualizza l'utilizzo dei token di input, output e cache<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">Il <code>utilizzo<\/code> L'oggetto riporta le categorie di token necessarie per l'analisi dei costi. Come minimo, individuare i token di input e di output. Quando si utilizza la memorizzazione nella cache dei prompt, tenere separati gli scritti in cache ogni cinque minuti, quelli ogni ora e le letture dalla cache, poich\u00e9 hanno tariffe diverse. L\u2019endpoint di conteggio dei token di Anthropic pu\u00f2 stimare i token di input prima di una richiesta, ma la stima pu\u00f2 differire leggermente dall\u2019utilizzo finale in input e ha i propri limiti di frequenza.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Convertire l'utilizzo dei token in un costo stimato<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">Calcolare ciascuna categoria separatamente, quindi sommare i risultati. In un esempio di pianificazione che utilizza Claude Opus 5 alle tariffe globali standard, 1.000 token di input non memorizzati nella cache costano <code>1.000 \u00d7 $5 \/ 1.000.000 = $0,005<\/code>, mentre 300 token di output costano <code>300 \u00d7 $25 \/ 1.000.000 = $0,0075<\/code>. Il totale stimato \u00e8 <code>$0.0125<\/code>. Sostituire questi conteggi di token a titolo esemplificativo con il <code>utilizzo<\/code> valori ricavati dalla tua risposta.<\/p>\n\n\n\n<aside class=\"capformula\" aria-label=\"Formula di calcolo del costo API Claude\" style=\"box-sizing:border-box;margin:28px 0;padding:22px;border:1px solid #c7d1cd;border-radius:6px;background:#f8faf9;color:#21322d\">\n<!-- MODULE:cost-formula:START -->\n<style>\n.capformula{box-sizing:border-box;margin:28px 0;padding:22px;border:1px solid #c7d1cd;border-radius:6px;background:#f8faf9;color:#21322d;font:15px\/1.55 system-ui,-apple-system,BlinkMacSystemFont,\"Segoe UI\",sans-serif;letter-spacing:0}.capformula strong{display:block;margin-bottom:10px;font-size:19px}.capformula code{display:block;padding:14px;border-radius:4px;background:#23332e;color:#f5f8f6;font:13px\/1.6 ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;white-space:normal;overflow-wrap:anywhere}.capformula p{margin:11px 0 0;color:#52615b;font-size:13px}\n<\/style>\n<strong>Formula di calcolo dei costi per categoria<\/strong><code>richieste \u00d7 token per richiesta \u00d7 tasso effettivo della categoria \/ 1.000.000<\/code><p>Applicare il fattore di lotto 50% e il fattore 1,1x (valido solo per gli Stati Uniti) a ciascuna categoria di token prima di sommare i totali.<\/p>\n<!-- MODULE:cost-formula:END -->\n<\/aside>\n\n\n\n<h2 id=\"claude-api-cost-calculator\" class=\"wp-block-heading\">Calcolatore dei prezzi API Claude<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Utilizza il calcolatore per modificare il modello, il numero di richieste, le categorie di token, la modalit\u00e0 di fatturazione e l'area geografica di inferenza. L'elaborazione in batch applica alle utilizzazioni idonee tariffe standard pari a 50%. L'inferenza limitata agli Stati Uniti applica un fattore di 1,1x a tutte le categorie di token per i modelli idonei Claude 4.6+; il modello Claude Haiku 4.5 non \u00e8 idoneo, pertanto tale combinazione restituisce uno stato non supportato.<\/p>\n\n\n\n<section class=\"capc-shell\" id=\"calculator\" data-calc-state=\"default\" style=\"box-sizing:border-box;width:100%;margin:28px 0;background:#fff;color:#1f2623;border:1px solid #cfd6d2;border-top:5px solid #d5533f;border-radius:7px;box-shadow:0 14px 34px rgba(24,34,29,.08);overflow:hidden\">\n<!-- MODULE:calculator:START -->\n<style>\n.capc-shell{box-sizing:border-box;width:100%;margin:28px 0;background:#fff;color:#1f2623;border:1px solid #cfd6d2;border-top:5px solid #d5533f;border-radius:7px;box-shadow:0 14px 34px rgba(24,34,29,.08);overflow:hidden;font:15px\/1.45 system-ui,-apple-system,BlinkMacSystemFont,\"Segoe UI\",sans-serif;letter-spacing:0}.capc-shell *{box-sizing:border-box}.capc-head{display:flex;align-items:flex-start;justify-content:space-between;gap:24px;padding:20px 22px 14px;border-bottom:1px solid #e1e6e3}.capc-title{margin:0 0 4px;font-size:25px;line-height:1.15;font-weight:800}.capc-head p{margin:0;color:#58635e}.capc-date{flex:0 0 auto;padding:5px 8px;border:1px solid #b8c5bf;border-radius:4px;color:#34403a;font-size:12px;font-weight:700;white-space:nowrap}.capc-form{padding:16px 22px 18px}.capc-top-grid{display:grid;grid-template-columns:1.4fr 1fr 1fr;gap:12px;margin-bottom:12px}.capc-token-grid{display:grid;grid-template-columns:repeat(3,minmax(0,1fr));gap:10px;margin-bottom:14px}.capc-field{min-width:0}.capc-field label,.capc-legend{display:block;margin:0 0 5px;color:#2c3732;font-size:12px;font-weight:750}.capc-field input,.capc-field select{width:100%;height:38px;padding:7px 9px;border:1px solid #aeb9b4;border-radius:4px;background:#fff;color:#1f2623;font:inherit}.capc-field input:focus,.capc-field select:focus,.capc-segment input:focus+label,.capc-button:focus-visible{outline:3px solid rgba(16,116,105,.28);outline-offset:2px;border-color:#107469}.capc-field [aria-invalid=\"true\"]{border-color:#b42318;background:#fff7f6}.capc-help{display:block;margin-top:3px;color:#68736d;font-size:11px}.capc-field-error{min-height:16px;margin:2px 0 0;color:#a61b12;font-size:11px}.capc-mode{margin:0;padding:0;border:0;min-width:0}.capc-segment{display:grid;grid-template-columns:1fr 1fr}.capc-segment input{position:absolute;opacity:0;pointer-events:none}.capc-segment label{display:grid;place-items:center;height:38px;margin:0;border:1px solid #aeb9b4;background:#fff;color:#35403b;cursor:pointer;font-weight:700}.capc-segment label:first-of-type{border-radius:4px 0 0 4px}.capc-segment label:last-of-type{border-left:0;border-radius:0 4px 4px 0}.capc-segment input:checked+label{background:#1f322d;color:#fff;border-color:#1f322d}.capc-actions{display:flex;gap:9px;margin-bottom:14px}.capc-button{min-height:38px;padding:8px 14px;border:1px solid #1f322d;border-radius:4px;background:#1f322d;color:#fff;cursor:pointer;font:inherit;font-weight:750}.capc-button.secondary{background:#fff;color:#29342f;border-color:#9da9a3}.capc-status{min-height:42px;display:flex;align-items:center;gap:9px;margin-bottom:12px;padding:9px 11px;border-left:4px solid #107469;background:#edf7f4;color:#21433b;font-weight:650}.capc-shell[data-calc-state=\"invalid\"] .capc-status,.capc-shell[data-calc-state=\"unsupported\"] .capc-status{border-left-color:#b42318;background:#fff0ee;color:#721c15}.capc-shell[data-calc-state=\"zero\"] .capc-status{border-left-color:#c17b19;background:#fff8e9;color:#63430f}.capc-results{display:grid;grid-template-columns:.72fr 1.28fr;gap:14px;align-items:stretch}.capc-totals{display:grid;grid-template-columns:1fr 1fr;gap:8px;align-content:start}.capc-total{padding:11px;border:1px solid #c7d0cc;border-radius:5px;background:#f8faf9}.capc-total strong{display:block;margin-top:2px;font-size:22px;color:#101713}.capc-total span{color:#59655f;font-size:11px;font-weight:700;text-transform:uppercase}.capc-meta{grid-column:1\/-1;margin:0;padding:9px 0 0;color:#58635e;font-size:12px}.capc-table-wrap{overflow-x:auto;border:1px solid #c7d0cc;border-radius:5px}.capc-table{width:100%;border-collapse:collapse;min-width:530px}.capc-table th,.capc-table td{padding:7px 9px;border-bottom:1px solid #e1e6e3;text-align:right;font-size:12px}.capc-table th:first-child,.capc-table td:first-child{text-align:left}.capc-table th{background:#263631;color:#fff}.capc-table tr:last-child td{border-bottom:0}.capc-foot{display:flex;justify-content:space-between;gap:20px;padding:11px 22px 13px;border-top:1px solid #e1e6e3;background:#f8faf9;color:#59655f;font-size:11px}.capc-foot p{margin:0}.capc-foot a{color:#0a665d;font-weight:750}@media(max-width:760px){.capc-head{display:block;padding:17px 16px 12px}.capc-title{font-size:22px}.capc-date{display:inline-block;margin-top:9px}.capc-form{padding:13px 16px 16px}.capc-top-grid,.capc-token-grid,.capc-results{grid-template-columns:1fr}.capc-token-grid{gap:7px}.capc-foot{display:block;padding:10px 16px}.capc-foot p+p{margin-top:5px}}@media(max-width:420px){.capc-actions{display:grid;grid-template-columns:1fr}.capc-total strong{font-size:19px}.capc-form{padding-left:12px;padding-right:12px}}\n<\/style>\n  <header class=\"capc-head\"><div><div class=\"capc-title\" role=\"heading\" aria-level=\"3\">Calcolatore dei prezzi API Claude<\/div><p>Stima del token di base in USD. Sono esclusi gli addebiti specifici dell'account.<\/p><\/div><div class=\"capc-date\">Tariffe verificate l'8 settembre 2026<\/div><\/header>\n  <form class=\"capc-form\" id=\"calc-form\" novalidate action=\"\">\n    <div class=\"capc-top-grid\">\n      <div class=\"capc-field\"><label for=\"model\">Modello<\/label><select id=\"model\" name=\"model\"><option value=\"claude-fable-5-1\">Claude Fable 5.1<\/option><option value=\"claude-opus-5\" selected>Claude Opus 5<\/option><option value=\"claude-sonnet-5\">Claude Sonetto 5<\/option><option value=\"claude-haiku-4-5-20251001\">Claude Haiku 4.5<\/option><\/select><\/div>\n      <fieldset class=\"capc-mode\"><legend class=\"capc-legend\">Modalit\u00e0 di fatturazione<\/legend><div class=\"capc-segment\"><input type=\"radio\" id=\"mode-standard\" name=\"mode\" value=\"standard\" checked><label for=\"mode-standard\">Standard<\/label><input type=\"radio\" id=\"mode-batch\" name=\"mode\" value=\"batch\"><label for=\"mode-batch\">Lotto<\/label><\/div><\/fieldset>\n      <div class=\"capc-field\"><label for=\"geo\">Geografia inferenziale<\/label><select id=\"geo\" name=\"geo\"><option value=\"global\" selected>Globale<\/option><option value=\"us\">Solo per gli Stati Uniti<\/option><\/select><\/div>\n    <\/div>\n    <div class=\"capc-token-grid\">\n      <div class=\"capc-field\"><label for=\"requests\">Richieste<\/label><input id=\"requests\" name=\"requests\" type=\"number\" value=\"1\" min=\"1\" max=\"1000000\" step=\"1\" inputmode=\"numeric\" aria-describedby=\"requests-help requests-error\"><small class=\"capc-help\" id=\"requests-help\">Da 1 a 1.000.000<\/small><p class=\"capc-field-error\" id=\"requests-error\"><\/p><\/div>\n      <div class=\"capc-field\"><label for=\"inputTokens\">Input \/ richiesta non memorizzata nella cache<\/label><input id=\"inputTokens\" name=\"inputTokens\" type=\"number\" value=\"1000\" min=\"0\" max=\"100000000\" step=\"1\" inputmode=\"numeric\" aria-describedby=\"inputTokens-error\"><p class=\"capc-field-error\" id=\"inputTokens-error\"><\/p><\/div>\n      <div class=\"capc-field\"><label for=\"outputTokens\">Output \/ richiesta<\/label><input id=\"outputTokens\" name=\"outputTokens\" type=\"number\" value=\"300\" min=\"0\" max=\"100000000\" step=\"1\" inputmode=\"numeric\" aria-describedby=\"outputTokens-error\"><p class=\"capc-field-error\" id=\"outputTokens-error\"><\/p><\/div>\n      <div class=\"capc-field\"><label for=\"cache5m\">5 m di scrittura nella cache \/ richiesta<\/label><input id=\"cache5m\" name=\"cache5m\" type=\"number\" value=\"0\" min=\"0\" max=\"100000000\" step=\"1\" inputmode=\"numeric\" aria-describedby=\"cache5m-error\"><p class=\"capc-field-error\" id=\"cache5m-error\"><\/p><\/div>\n      <div class=\"capc-field\"><label for=\"cache1h\">1 ora di scrittura nella cache \/ richiesta<\/label><input id=\"cache1h\" name=\"cache1h\" type=\"number\" value=\"0\" min=\"0\" max=\"100000000\" step=\"1\" inputmode=\"numeric\" aria-describedby=\"cache1h-error\"><p class=\"capc-field-error\" id=\"cache1h-error\"><\/p><\/div>\n      <div class=\"capc-field\"><label for=\"cacheRead\">Lettura \/ richiesta dalla cache<\/label><input id=\"cacheRead\" name=\"cacheRead\" type=\"number\" value=\"0\" min=\"0\" max=\"100000000\" step=\"1\" inputmode=\"numeric\" aria-describedby=\"cacheRead-error\"><p class=\"capc-field-error\" id=\"cacheRead-error\"><\/p><\/div>\n    <\/div>\n    <div class=\"capc-actions\"><button class=\"capc-button\" type=\"submit\">Calcola<\/button><button class=\"capc-button secondary\" type=\"button\" id=\"reset-button\">Ripristina impostazioni predefinite<\/button><\/div>\n    <div class=\"capc-status\" id=\"status\" role=\"status\" aria-live=\"polite\">Stima predefinita: Claude Opus 5, Standard, Globale.<\/div>\n    <section class=\"capc-results\" aria-label=\"Preventivo dei costi\"><div class=\"capc-totals\"><div class=\"capc-total\"><span>Su richiesta<\/span><strong id=\"per-request\" data-raw-value=\"0.0125\">$0.012500<\/strong><\/div><div class=\"capc-total\"><span>Carico di lavoro totale<\/span><strong id=\"total-cost\" data-raw-value=\"0.0125\">$0.012500<\/strong><\/div><p class=\"capc-meta\" id=\"active-meta\">claude-opus-5 | Standard | Globale<\/p><\/div><div class=\"capc-table-wrap\" style=\"overflow-x:auto;border:1px solid #c7d0cc;border-radius:5px\"><table class=\"capc-table\" style=\"width:100%;min-width:530px;border-collapse:collapse\"><thead><tr><th>Categoria<\/th><th>Token per richiesta<\/th><th>Con effetto a partire da $\/MTok<\/th><th>Totale<\/th><\/tr><\/thead><tbody id=\"breakdown\"><\/tbody><\/table><\/div><\/section>\n  <input type=\"hidden\" name=\"trp-form-language\" value=\"it\"\/><\/form>\n  <footer class=\"capc-foot\"><p>Il preventivo non include le imposte, le tariffe negoziate, la modalit\u00e0 Fast Mode, i costi relativi agli strumenti del server e la conversione valutaria.<\/p><p><a href=\"https:\/\/platform.claude.com\/docs\/en\/about-claude\/pricing\" target=\"_blank\" rel=\"noopener\">Prezzi ufficiali Anthropic<\/a><\/p><\/footer>\n  <noscript><div style=\"padding:16px 22px;border-top:1px solid #cfd6d2;background:#fff8e9;color:#4c350e\">JavaScript \u00e8 disattivato. Per ogni categoria, moltiplicare il numero di richieste per i token per richiesta per la tariffa ufficiale, quindi dividere per 1.000.000. L'utilizzo in batch viene addebitato a 50% rispetto ai prezzi standard. Per l'inferenza limitata agli Stati Uniti su modelli idonei Claude 4.6+, si applica un moltiplicatore di 1,1x a ogni categoria di token. Tariffe verificate l'8 settembre 2026.<\/div><\/noscript>\n<script>\n(function(){\"use strict\";var RATE_DATE=\"2026-09-08\",BATCH_FACTOR=.5,US_ONLY_FACTOR=1.1,MAX_REQUESTS=1000000,MAX_TOKENS=100000000;var RATES=Object.freeze({\"claude-fable-5-1\":{\"label\":\"Claude Fable 5.1\",\"input\":10,\"output\":50,\"cache5mWrite\":12.5,\"cache1hWrite\":20,\"cacheRead\":.25,\"usOnlyEligible\":true},\"claude-opus-5\":{\"label\":\"Claude Opus 5\",\"input\":5,\"output\":25,\"cache5mWrite\":6.25,\"cache1hWrite\":10,\"cacheRead\":.5,\"usOnlyEligible\":true},\"claude-sonnet-5\":{\"label\":\"Claude Sonnet 5\",\"input\":2,\"output\":10,\"cache5mWrite\":2.5,\"cache1hWrite\":4,\"cacheRead\":.2,\"usOnlyEligible\":true},\"claude-haiku-4-5-20251001\":{\"label\":\"Claude Haiku 4.5\",\"input\":1,\"output\":5,\"cache5mWrite\":1.25,\"cache1hWrite\":2,\"cacheRead\":.1,\"usOnlyEligible\":false}});var categories=[{field:\"inputTokens\",label:\"Uncached input\",rate:\"input\"},{field:\"outputTokens\",label:\"Output\",rate:\"output\"},{field:\"cache5m\",label:\"5m cache write\",rate:\"cache5mWrite\"},{field:\"cache1h\",label:\"1h cache write\",rate:\"cache1hWrite\"},{field:\"cacheRead\",label:\"Cache read\",rate:\"cacheRead\"}];var shell=document.getElementById(\"calculator\"),form=document.getElementById(\"calc-form\"),model=document.getElementById(\"model\"),geo=document.getElementById(\"geo\"),status=document.getElementById(\"status\"),breakdown=document.getElementById(\"breakdown\"),perRequest=document.getElementById(\"per-request\"),totalCost=document.getElementById(\"total-cost\"),activeMeta=document.getElementById(\"active-meta\"),resetButton=document.getElementById(\"reset-button\"),pristine=true;function money(value){if(value===0)return\"$0.000000\";if(value<.01)return\"$\"+value.toFixed(6);if(value<1)return\"$\"+value.toFixed(4);return\"$\"+value.toFixed(2)}function clearErrors(){[\"requests\"].concat(categories.map(function(item){return item.field})).forEach(function(id){var field=document.getElementById(id);field.removeAttribute(\"aria-invalid\");document.getElementById(id+\"-error\").textContent=\"\"})}function readInteger(id,min,max,blankIsZero){var field=document.getElementById(id),raw=field.value.trim(),value=raw===\"\"&#038;&#038;blankIsZero?0:Number(raw),message=\"\";if(raw===\"\"&#038;&#038;!blankIsZero)message=\"Enter a request count.\";else if(!Number.isFinite(value))message=\"Enter a finite number.\";else if(!Number.isInteger(value))message=\"Use a whole number.\";else if(value<min)message=\"Minimum: \"+min.toLocaleString()+\".\";else if(value>max)message=\"Maximum: \"+max.toLocaleString()+\".\";if(message){field.setAttribute(\"aria-invalid\",\"true\");document.getElementById(id+\"-error\").textContent=message;return{ok:false,value:0}}return{ok:true,value:value}}function setState(name,message){shell.dataset.calcState=name;status.textContent=message}function setTotals(per,total){perRequest.dataset.rawValue=String(per);totalCost.dataset.rawValue=String(total);perRequest.textContent=money(per);totalCost.textContent=money(total)}function render(){clearErrors();var requests=readInteger(\"requests\",1,MAX_REQUESTS,false),tokenValues={},valid=requests.ok;categories.forEach(function(item){var result=readInteger(item.field,0,MAX_TOKENS,true);tokenValues[item.field]=result.value;valid=valid&&result.ok});var selectedMode=form.elements.mode.value,selectedRate=RATES[model.value],batchFactor=selectedMode===\"batch\"?BATCH_FACTOR:1,geoFactor=geo.value===\"us\"?US_ONLY_FACTOR:1;activeMeta.textContent=model.value+\" | \"+(selectedMode===\"batch\"?\"Batch\":\"Standard\")+\" | \"+(geo.value===\"us\"?\"US-only\":\"Global\");if(!valid){setState(\"invalid\",\"Fix the highlighted value before calculating.\");setTotals(0,0);breakdown.innerHTML=\"\";return}if(geo.value===\"us\"&&!selectedRate.usOnlyEligible){setState(\"unsupported\",selectedRate.label+\" does not support US-only inference. Choose Global or a Claude 4.6+ model.\");setTotals(0,0);breakdown.innerHTML=\"\";return}var tokenTotal=categories.reduce(function(sum,item){return sum+tokenValues[item.field]},0);if(tokenTotal===0){setState(\"zero\",\"All token inputs are zero. Add at least one token category to estimate cost.\");setTotals(0,0);breakdown.innerHTML=\"\";return}var per=0,rows=categories.map(function(item){var tokens=tokenValues[item.field],effectiveRate=selectedRate[item.rate]*batchFactor*geoFactor,categoryPerRequest=tokens*effectiveRate\/1000000,categoryTotal=categoryPerRequest*requests.value;per+=categoryPerRequest;return\"<tr><td>\"+item.label+\"<\/td><td>\"+tokens.toLocaleString()+\"<\/td><td>$\"+effectiveRate.toFixed(3)+\"<\/td><td>\"+money(categoryTotal)+\"<\/td><\/tr>\"}),total=per*requests.value;breakdown.innerHTML=rows.join(\"\");setTotals(per,total);if(pristine)setState(\"default\",\"Default estimate: \"+selectedRate.label+\", Standard, Global. \"+money(total)+\" total.\");else setState(\"valid\",\"Estimate updated using \"+(selectedMode===\"batch\"?\"50% Batch pricing\":\"standard pricing\")+\" and \"+(geo.value===\"us\"?\"1.1x US-only\":\"global routing\")+\". \"+money(total)+\" total.\")}form.addEventListener(\"submit\",function(event){event.preventDefault();pristine=false;render()});form.addEventListener(\"input\",function(){pristine=false;render()});form.addEventListener(\"change\",function(){pristine=false;render()});resetButton.addEventListener(\"click\",function(){form.reset();pristine=true;render()});render();window.__CAPC_TEST__=Object.freeze({RATE_DATE:RATE_DATE,RATES:RATES,BATCH_FACTOR:BATCH_FACTOR,US_ONLY_FACTOR:US_ONLY_FACTOR})})();\n<\/script>\n<!-- MODULE:calculator:END -->\n<\/section>\n\n\n\n<p class=\"wp-block-paragraph\">Il preventivo \u00e8 uno strumento di pianificazione, non una fattura. Non include tasse, conversione valutaria, condizioni negoziate, Fast Mode, costi relativi agli strumenti server e condizioni specifiche dell'account. I prezzi e i requisiti di idoneit\u00e0 possono subire variazioni; pertanto, si raccomanda di ricontrollare la pagina ufficiale dei prezzi prima di prendere qualsiasi decisione relativa all'acquisto o all'architettura.<\/p>\n\n\n\n<p class=\"globalgpt-cost-bridge wp-block-paragraph\">Il calcolatore qui sopra mostra l'andamento dei costi delle chiamate API Claude programmabili e a consumo. Per le attivit\u00e0 quotidiane che coinvolgono diversi modelli e funzionalit\u00e0 di intelligenza artificiale, <a href=\"https:\/\/www.glbgpt.com\/home?inviter=hub_content_home&amp;login=1\">GlobalGPT<\/a> offre un valore aggiunto di altro tipo: un unico abbonamento riunisce diversi modelli e strumenti di uso comune in un\u2019unica dashboard, rendendo pi\u00f9 facile prevedere i costi ed evitando al contempo che attivit\u00e0 quali ricerca, scrittura, programmazione e lavoro creativo richiedano abbonamenti separati e si svolgano su interfacce disparate. La sua CLI estende la stessa piattaforma allo sviluppo basato su terminale e agli strumenti di produzione che gi\u00e0 utilizzi. La nostra guida a <a href=\"https:\/\/www.glbgpt.com\/hub\/all-in-one-ai-models\/\">lavorare con pi\u00f9 modelli di IA in un unico posto<\/a> mostra come si incastrano tra loro i vari elementi della piattaforma nel suo complesso.<\/p>\n\n\n\n<h2 id=\"claude-api-errors\" class=\"wp-block-heading\">Errori comuni dell'API Claude e relative soluzioni<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Inizia dall'status HTTP e dal tipo di errore Anthropic, quindi esamina la richiesta senza rivelare la chiave. Il significato ufficiale restringe il campo di ricerca; la causa probabile dipende comunque dal tuo account, dal modello selezionato, dalla struttura della richiesta e dal traffico.<\/p>\n\n\n\n<figure class=\"wp-block-image size-full\"><img loading=\"lazy\" decoding=\"async\" width=\"1400\" height=\"788\" src=\"https:\/\/wp.glbgpt.com\/wp-content\/uploads\/2026\/09\/claude-api-common-errors-400-413-1.webp\" alt=\"Documentazione API Anthropic relativa agli errori client da 400 a 413\" class=\"wp-image-19080\" srcset=\"https:\/\/wp.glbgpt.com\/wp-content\/uploads\/2026\/09\/claude-api-common-errors-400-413-1.webp 1400w, https:\/\/wp.glbgpt.com\/wp-content\/uploads\/2026\/09\/claude-api-common-errors-400-413-1-300x169.webp 300w, https:\/\/wp.glbgpt.com\/wp-content\/uploads\/2026\/09\/claude-api-common-errors-400-413-1-1024x576.webp 1024w, https:\/\/wp.glbgpt.com\/wp-content\/uploads\/2026\/09\/claude-api-common-errors-400-413-1-768x432.webp 768w, https:\/\/wp.glbgpt.com\/wp-content\/uploads\/2026\/09\/claude-api-common-errors-400-413-1-18x10.webp 18w\" sizes=\"(max-width: 1400px) 100vw, 1400px\" \/><figcaption class=\"wp-element-caption\">Anthropic distingue tra errori relativi a richieste non valide, autenticazione, credito, autorizzazioni, risorse mancanti, conflitti e dimensioni della richiesta.<\/figcaption><\/figure>\n\n\n\n<figure class=\"wp-block-table is-style-stripes\"><table><thead><tr><th>Stato<\/th><th>Confine ufficiale<\/th><th>Cosa controllare dopo<\/th><th>Riprovare?<\/th><\/tr><\/thead><tbody><tr><td>400<\/td><td>Richiesta non valida<\/td><td>Verifica la validit\u00e0 del JSON, dei nomi dei campi, dei ruoli, dell\u2019ID del modello e delle combinazioni di parametri.<\/td><td>Solo dopo aver corretto la richiesta.<\/td><\/tr><tr><td>401<\/td><td>Errore di autenticazione<\/td><td>Verificare che la chiave esista, sia attiva e raggiunga il server tramite <code>x-api-key<\/code>. Non stamparlo mai.<\/td><td>Non effettuare un nuovo tentativo alla cieca; risolvere prima il problema di autenticazione.<\/td><\/tr><tr><td>402<\/td><td>Requisiti di fatturazione o di credito<\/td><td>Verifica nella Console la fatturazione relativa all'API dell'organizzazione e i crediti di utilizzo disponibili.<\/td><td>Una volta risolta la questione relativa alla fatturazione.<\/td><\/tr><tr><td>403<\/td><td>Errore di autorizzazione<\/td><td>Verifica se la chiave e l'organizzazione possono utilizzare la risorsa o il modello richiesti.<\/td><td>Non riprovare alla cieca; prima correggi l'accesso.<\/td><\/tr><tr><td>404<\/td><td>Risorsa non trovata<\/td><td>Verifica l'endpoint, l'identificatore della risorsa, il ciclo di vita del modello e l'ortografia.<\/td><td>Solo dopo aver corretto il bersaglio.<\/td><\/tr><tr><td>413<\/td><td>Richiesta troppo grande<\/td><td>Ridurre la dimensione della richiesta o suddividere l'input; non limitarsi ad aumentare <code>max_tokens<\/code>.<\/td><td>Dopo aver ridotto la richiesta.<\/td><\/tr><tr><td>429<\/td><td>Limite di velocit\u00e0 superato<\/td><td>Controlla le intestazioni relative alla limitazione della frequenza e il tuo livello di Console, riduci la concorrenza e applica il backoff.<\/td><td>S\u00ec, con backoff controllato.<\/td><\/tr><tr><td>500<\/td><td>Errore API interno<\/td><td>Registrare l'ID della richiesta, garantire l'idempotenza e verificare le informazioni sullo stato Anthropic.<\/td><td>Di solito, con backoff limitato.<\/td><\/tr><tr><td>504<\/td><td>Timeout del gateway<\/td><td>Verifica se la richiesta era insolitamente lunga e se un nuovo tentativo potrebbe comportare un doppio lavoro.<\/td><td>Spesso, se \u00e8 sicuro riprovare l'operazione.<\/td><\/tr><tr><td>529<\/td><td>API temporaneamente sovraccarica<\/td><td>Ridurre i picchi di traffico e riprovare dopo un periodo di attesa; non considerare il sovraccarico come un errore di autenticazione.<\/td><td>S\u00ec, con backoff limitato.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<figure class=\"wp-block-image size-full\"><img loading=\"lazy\" decoding=\"async\" width=\"1400\" height=\"788\" src=\"https:\/\/wp.glbgpt.com\/wp-content\/uploads\/2026\/09\/claude-api-common-errors-429-529-1.webp\" alt=\"Documentazione API Anthropic relativa agli errori di limite e di server da 429 a 529\" class=\"wp-image-19076\" srcset=\"https:\/\/wp.glbgpt.com\/wp-content\/uploads\/2026\/09\/claude-api-common-errors-429-529-1.webp 1400w, https:\/\/wp.glbgpt.com\/wp-content\/uploads\/2026\/09\/claude-api-common-errors-429-529-1-300x169.webp 300w, https:\/\/wp.glbgpt.com\/wp-content\/uploads\/2026\/09\/claude-api-common-errors-429-529-1-1024x576.webp 1024w, https:\/\/wp.glbgpt.com\/wp-content\/uploads\/2026\/09\/claude-api-common-errors-429-529-1-768x432.webp 768w, https:\/\/wp.glbgpt.com\/wp-content\/uploads\/2026\/09\/claude-api-common-errors-429-529-1-18x10.webp 18w\" sizes=\"(max-width: 1400px) 100vw, 1400px\" \/><figcaption class=\"wp-element-caption\">I limiti di frequenza, i guasti del server, i timeout e le risposte sovraccariche richiedono decisioni diverse in merito ai tentativi di riprova.<\/figcaption><\/figure>\n\n\n\n<h3 class=\"wp-block-heading\">Un ordine di debug sicuro<\/h3>\n\n\n\n<ol class=\"wp-block-list\">\n<li>Registra lo stato, il tipo di errore, il timestamp e l'ID della richiesta senza registrare la chiave API.<\/li>\n\n\n\n<li>Verifica l'endpoint, le intestazioni, la sintassi JSON, l'ID del modello e il limite di dimensione della richiesta.<\/li>\n\n\n\n<li>Verificare la fatturazione dell'organizzazione, le autorizzazioni, le intestazioni di limitazione della frequenza e il ciclo di vita attuale del modello.<\/li>\n\n\n\n<li>Riprovare solo per gli errori che possono ragionevolmente essere temporanei, utilizzando un backoff esponenziale limitato e un jitter.<\/li>\n\n\n\n<li>Se l'errore persiste, riduci la richiesta al caso riproducibile pi\u00f9 semplice prima di contattare l'assistenza.<\/li>\n<\/ol>\n\n\n\n<p class=\"wp-block-paragraph\">Gli SDK ufficiali di Anthropic effettuano di default due tentativi di riconnessione in caso di errori di connessione, risposte 429 e risposte 5xx. La logica di riprova a livello di applicazione richiede comunque l\u2019impostazione di limiti e il rispetto dell\u2019idempotenza, specialmente quando una richiesta pu\u00f2 attivare strumenti o altre azioni esterne.<\/p>\n\n\n\n<h2 id=\"claude-api-cost-controls\" class=\"wp-block-heading\">Come contenere i costi dell'API Claude<\/h2>\n\n\n\n<h3 class=\"wp-block-heading\">Impostare limiti di output prudenti<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">Inizia dal pi\u00f9 piccolo <code>max_tokens<\/code> valore che pu\u00f2 comunque fornire una risposta utile. Misurate l'utilizzo effettivo dell'output prima di aumentarlo. Prompt pi\u00f9 brevi possono essere d'aiuto, ma eliminare le istruzioni che impediscono i tentativi ripetuti, gli errori o l'output inutilizzabile pu\u00f2 comportare un costo complessivo maggiore.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Utilizza la memorizzazione nella cache dei prompt e l'elaborazione in batch solo quando sono appropriate<\/h3>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Utilizzare la memorizzazione nella cache dei prompt quando si ripete un prefisso di prompt significativo e la durata della cache \u00e8 in linea con il flusso di lavoro.<\/li>\n\n\n\n<li>Utilizza Batch per le attivit\u00e0 che possono essere completate in modo asincrono; l'utilizzo di Batch idoneo viene fatturato a 50% secondo le tariffe standard.<\/li>\n\n\n\n<li>Mantenere separate le operazioni di scrittura e lettura nella cache nei report, in modo che il risparmio sia visibile anzich\u00e9 presunto.<\/li>\n\n\n\n<li>Utilizzare l\u2019inferenza limitata agli Stati Uniti solo quando il requisito di residenza giustifica il suo fattore di prezzo dei token pari a 1,1x e il modello selezionato \u00e8 idoneo.<\/li>\n<\/ul>\n\n\n\n<h3 class=\"wp-block-heading\">Monitoraggio dell'utilizzo, dei limiti di velocit\u00e0 e dei limiti di spesa<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">Tieni traccia del numero di richieste, dell\u2019ID del modello, dell\u2019utilizzo in entrata e in uscita, delle categorie di cache, dei tentativi di ripetizione e degli errori. Imposta gli avvisi o i controlli di spesa disponibili per la tua organizzazione, ma non dare per scontato che il livello o il limite di un altro account si applichi al tuo. La nostra guida approfondita su <a href=\"https:\/\/www.glbgpt.com\/hub\/claude-ai-pricing-2026-the-ultimate-guide-to-plans-api-costs-and-limits\/\">Piani Claude, costi API e limiti<\/a> copre i percorsi di fatturazione pi\u00f9 ampi.<\/p>\n\n\n\n<h2 id=\"claude-api-next-steps\" class=\"wp-block-heading\">Prossimi passi dopo la prima richiesta<\/h2>\n\n\n\n<h3 class=\"wp-block-heading\">Scegli il percorso giusto per il tuo prossimo progetto<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">Per l'implementazione, consulta la guida ufficiale all'API Messages di Anthropic, le linee guida sullo streaming, la documentazione sull'uso degli strumenti, le pagine dedicate al ciclo di vita dei modelli e il tuo piano di registrazione e valutazione. Definisci con attenzione una strategia per i modelli, gestisci gli errori prima di aumentare il traffico e calcola i costi in base all'utilizzo effettivo piuttosto che alla sola lunghezza dei prompt.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Se la programmazione \u00e8 la tua attivit\u00e0 principale, la nostra guida a <a href=\"https:\/\/www.glbgpt.com\/hub\/how-to-use-claude-ai-for-coding\/\">utilizzare Claude AI per la codifica<\/a> illustra alcuni metodi pratici per passare da un\u2019attivit\u00e0 di programmazione interattiva a un flusso di lavoro ripetibile per gli sviluppatori.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Quando uno spazio di lavoro multimodello \u00e8 lo strumento pi\u00f9 adatto<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">L'accesso diretto tramite API \u00e8 la soluzione ideale quando \u00e8 necessaria un'integrazione a livello di codice, la fatturazione per gli sviluppatori, i metadati delle richieste o i controlli ufficiali della piattaforma. Se il tuo obiettivo \u00e8 la scrittura interattiva, la ricerca, la pianificazione o il confronto dei risultati tra diversi fornitori senza dover sviluppare un'applicazione, un'area di lavoro multimodello potrebbe rivelarsi pi\u00f9 pratica.<\/p>\n\n\n\n<aside class=\"capdecision\" aria-label=\"Scegli tra l&#039;accesso diretto all&#039;API e il flusso di lavoro GlobalGPT\" style=\"box-sizing:border-box;margin:28px 0;padding:22px;border:1px solid #c9d2ce;border-radius:6px;background:#fff;color:#23332e\">\n<!-- MODULE:decision-boundary:START -->\n<style>\n.capdecision{box-sizing:border-box;margin:28px 0;padding:22px;border:1px solid #c9d2ce;border-radius:6px;background:#fff;color:#23332e;font:15px\/1.55 system-ui,-apple-system,BlinkMacSystemFont,\"Segoe UI\",sans-serif;letter-spacing:0}.capdecision-grid{display:grid;grid-template-columns:1fr 1fr;gap:12px}.capdecision-item{padding:16px;border-radius:5px;background:#f4f7f5}.capdecision-item strong{display:block;margin-bottom:6px;font-size:17px}.capdecision a{display:inline-flex;margin-top:11px;padding:9px 13px;border-radius:4px;background:#1f3a33;color:#fff;text-decoration:none;font-weight:800}.capdecision small{display:block;margin-top:10px;color:#59665f}@media(max-width:640px){.capdecision{padding:16px}.capdecision-grid{grid-template-columns:1fr}}\n<\/style>\n<div class=\"capdecision-grid\"><div class=\"capdecision-item\"><strong>Sviluppo con l'API Claude<\/strong>Trasforma un prompt collaudato in una funzionalit\u00e0 del prodotto, automatizza un flusso di lavoro back-end, analizza i dati di utilizzo e gestisci le richieste tramite codice.<\/div><div class=\"capdecision-item\"><strong>Integra GlobalGPT nel tuo flusso di lavoro<\/strong>Utilizza un unico abbonamento per Claude e altri modelli di punta all\u2019interno di un ampio suite di strumenti di intelligenza artificiale, quindi collega la CLI allo sviluppo basato su terminale e agli strumenti di produzione esistenti.<br><a href=\"https:\/\/www.glbgpt.com\/home?inviter=hub_content_home&amp;login=1\">Inserisci GlobalGPT nel tuo flusso di lavoro<\/a><\/div><\/div><small>Utilizza le chiamate API a consumo per l\u2019automazione programmabile, oppure integra il toolkit multimodello di GlobalGPT nelle attivit\u00e0 di ricerca, scrittura, programmazione e produzione in corso.<\/small>\n<!-- MODULE:decision-boundary:END -->\n<\/aside>\n\n\n\n<h2 id=\"claude-api-faq\" class=\"wp-block-heading\">Domande frequenti<\/h2>\n\n\n\n<h3 class=\"wp-block-heading\">L'API Claude \u00e8 gratuita?<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">Non viene garantita alcuna quota gratuita universale per l'API. L'utilizzo dell'API Claude viene fatturato separatamente tramite la Console Claude e, secondo Anthropic, la maggior parte delle organizzazioni finanzia tale utilizzo con crediti prepagati, mentre le organizzazioni con fatturazione mensile costituiscono un'eccezione. Verificate le informazioni aggiornate disponibili nella Console e i prezzi ufficiali relativi alla vostra organizzazione prima di inviare richieste.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Come posso ottenere una chiave API Claude?<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">Creare una chiave nella console Claude per l'organizzazione corrispondente. Anthropic avverte che la nuova chiave viene visualizzata una sola volta, pertanto \u00e8 necessario conservarla in modo sicuro quando appare. Caricarla tramite una variabile d'ambiente lato server o un gestore di segreti e non esporla mai nel codice del browser, negli screenshot o in un repository pubblico.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Quale ID del modello Claude devo utilizzare?<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">Questo tutorial utilizza <code>claude-opus-5<\/code> poich\u00e9 quello era il modello indicato nella guida ufficiale \u201cQuickstart\u201d di Anthropic al momento della verifica, effettuata l\u20198 settembre 2026. Scegliete il modello pi\u00f9 adatto al vostro carico di lavoro e al vostro budget, e ricontrollate le pagine \u201cModelli\u201d e \u201cModelli obsoleti\u201d di Anthropic, poich\u00e9 gli ID dei modelli, gli alias e lo stato del ciclo di vita possono subire variazioni.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Quale endpoint utilizza l'API Claude?<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">La prima richiesta descritta in questa guida utilizza l'endpoint Messages all'indirizzo https:\/\/api.anthropic.com\/v1\/messages. Invia un oggetto JSON con le intestazioni content-type, x-api-key e anthropic-version. Anthropic offre anche altre funzionalit\u00e0 API, quindi consulta la pagina di riferimento relativa all'operazione che stai implementando.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Claude Pro include crediti API?<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">Il Centro assistenza di Anthropic precisa che Claude Pro non include l'utilizzo tramite la Console Claude. L'abbonamento a Claude.ai e la fatturazione API sono prodotti distinti. Configura la fatturazione API nella Console per le richieste degli sviluppatori e utilizza il nostro <a href=\"https:\/\/www.glbgpt.com\/hub\/claude-ai-pricing-2026-the-ultimate-guide-to-plans-api-costs-and-limits\/\">Guida ai prezzi Claude<\/a> per un confronto pi\u00f9 ampio tra i piani.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Quanto costa una richiesta API Claude?<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">Il costo dipende dal modello selezionato, dai token in ingresso, dai token in uscita, dalle scritture in cache, dalle letture in cache, dalla modalit\u00e0 batch e dall'area geografica idonea per l'inferenza. Per calcolare il costo di ciascuna categoria, moltiplicare il numero di richieste per il numero di token per la tariffa effettiva per milione di token, dividere il risultato per un milione, quindi sommare le singole categorie. Utilizzare il calcolatore qui sopra per ottenere una stima.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Perch\u00e9 ricevo un errore 401?<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">Il codice 401 indica un errore di autenticazione. Verifica che la chiave API esista, sia attiva, appartenga all'organizzazione desiderata e raggiunga il server nel <code>x-api-key<\/code> Intestazione. Non stampare n\u00e9 condividere la chiave durante il debug. I ripetuti tentativi non consentiranno di correggere una credenziale mancante o non valida.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Perch\u00e9 mi compare l'errore 429?<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">Il codice 429 indica che la richiesta ha superato un limite di frequenza. I limiti possono variare a seconda dell'organizzazione e del livello di utilizzo, pertanto \u00e8 opportuno esaminare le intestazioni relative ai limiti di frequenza restituite, nonch\u00e9 la Console o la documentazione aggiornata. Ridurre il numero di richieste simultanee, rispettare i tempi di riprova e utilizzare un backoff esponenziale limitato con jitter, anzich\u00e9 ripetere immediatamente la stessa sequenza di richieste.<\/p>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<p class=\"claude-api-source-note wp-block-paragraph\"><strong>Nota sulla provenienza e sulla freschezza:<\/strong> Gli ID dei modelli, i prezzi, il comportamento dell'API e le politiche di assistenza sono stati verificati sulla base della documentazione ufficiale di Anthropic in data 8 settembre 2026. Si consiglia di consultare le pagine aggiornate relative ai modelli e ai prezzi prima dell'utilizzo in produzione, quindi di eseguire gli esempi utilizzando la propria chiave della console Claude, le impostazioni di fatturazione e l'accesso all'account.<\/p>\n\n\n\n<!-- MODULE:faq-schema:START -->\n<script type=\"application\/ld+json\">{\n    \"@context\": \"https:\\\/\\\/schema.org\",\n    \"@type\": \"FAQPage\",\n    \"mainEntity\": [\n        {\n            \"@type\": \"Question\",\n            \"name\": \"Is the Claude API free?\",\n            \"acceptedAnswer\": {\n                \"@type\": \"Answer\",\n                \"text\": \"No universal free API allowance is promised here. Claude API usage is billed separately through Claude Console, and Anthropic says most organizations fund usage with prepaid credits, while monthly-invoiced organizations are an exception. Check the current Console and official pricing information for your organization before sending requests.\"\n            }\n        },\n        {\n            \"@type\": \"Question\",\n            \"name\": \"How do I get a Claude API key?\",\n            \"acceptedAnswer\": {\n                \"@type\": \"Answer\",\n                \"text\": \"Create a key in Claude Console for the appropriate organization. Anthropic warns that the new key is displayed only once, so store it securely when it appears. Load it through a server-side environment variable or secret manager, and never expose it in browser code, screenshots, or a public repository.\"\n            }\n        },\n        {\n            \"@type\": \"Question\",\n            \"name\": \"Which Claude model ID should I use?\",\n            \"acceptedAnswer\": {\n                \"@type\": \"Answer\",\n                \"text\": \"This tutorial uses claude-opus-5 because that was the model in Anthropic's official Quickstart when verified on September 8, 2026. Choose the model that fits your workload and budget, and recheck Anthropic's Models and deprecations pages because model IDs, aliases, and lifecycle status can change.\"\n            }\n        },\n        {\n            \"@type\": \"Question\",\n            \"name\": \"What endpoint does the Claude API use?\",\n            \"acceptedAnswer\": {\n                \"@type\": \"Answer\",\n                \"text\": \"The first request in this guide uses the Messages endpoint at https:\\\/\\\/api.anthropic.com\\\/v1\\\/messages. It sends JSON with content-type, x-api-key, and anthropic-version headers. Anthropic provides other API capabilities too, so use the reference page for the operation you are implementing.\"\n            }\n        },\n        {\n            \"@type\": \"Question\",\n            \"name\": \"Does Claude Pro include API credits?\",\n            \"acceptedAnswer\": {\n                \"@type\": \"Answer\",\n                \"text\": \"No. Anthropic's Help Center states that Claude Pro does not include usage through Claude Console. A Claude.ai subscription and API billing are separate products. Set up API billing in Console for developer requests, and use our Claude pricing guide for the wider plan comparison.\"\n            }\n        },\n        {\n            \"@type\": \"Question\",\n            \"name\": \"How much does one Claude API request cost?\",\n            \"acceptedAnswer\": {\n                \"@type\": \"Answer\",\n                \"text\": \"Cost depends on the selected model, input tokens, output tokens, cache writes, cache reads, Batch mode, and eligible inference geography. Calculate each category as requests multiplied by tokens multiplied by its effective per-million-token rate, divided by one million, then add the categories. Use the calculator above for an estimate.\"\n            }\n        },\n        {\n            \"@type\": \"Question\",\n            \"name\": \"Why am I getting a 401 error?\",\n            \"acceptedAnswer\": {\n                \"@type\": \"Answer\",\n                \"text\": \"A 401 is an authentication error. Confirm that the API key exists, remains active, belongs to the intended organization, and reaches the server in the x-api-key header. Do not print or share the key while debugging. Repeated retries will not repair a missing or invalid credential.\"\n            }\n        },\n        {\n            \"@type\": \"Question\",\n            \"name\": \"Why am I getting a 429 error?\",\n            \"acceptedAnswer\": {\n                \"@type\": \"Answer\",\n                \"text\": \"A 429 means the request exceeded a rate limit. Limits can vary by organization and usage tier, so inspect the returned rate-limit headers and current Console or documentation. Reduce concurrency, respect retry timing, and use bounded exponential backoff with jitter instead of immediately repeating the same burst.\"\n            }\n        }\n    ]\n}<\/script>\n<!-- MODULE:faq-schema:END -->","protected":false},"excerpt":{"rendered":"<p>Per effettuare la tua prima richiesta API Claude, crea una chiave della Console Claude, salvala in una variabile d\u2019ambiente, chiama l\u2019endpoint Messages, leggi i campi relativi all\u2019utilizzo restituiti e calcola il costo del token. Questa guida illustra la procedura da seguire utilizzando gli ID dei modelli e i prezzi attuali verificati l\u20198 settembre 2026. Percorso per la prima richiesta: crea una Console [\u2026]<\/p>","protected":false},"author":7,"featured_media":19073,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"_seopress_robots_primary_cat":"","_seopress_titles_title":"Claude API Guide: Pricing, Setup & First Request","_seopress_titles_desc":"Learn Claude API pricing, create a secure API key, send your first cURL and Python requests, estimate token costs, and fix common errors.","_seopress_robots_index":"","footnotes":""},"categories":[7],"tags":[],"class_list":["post-19043","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-ai-chat"],"acf":[],"_links":{"self":[{"href":"https:\/\/wp.glbgpt.com\/it\/wp-json\/wp\/v2\/posts\/19043","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/wp.glbgpt.com\/it\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/wp.glbgpt.com\/it\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/wp.glbgpt.com\/it\/wp-json\/wp\/v2\/users\/7"}],"replies":[{"embeddable":true,"href":"https:\/\/wp.glbgpt.com\/it\/wp-json\/wp\/v2\/comments?post=19043"}],"version-history":[{"count":3,"href":"https:\/\/wp.glbgpt.com\/it\/wp-json\/wp\/v2\/posts\/19043\/revisions"}],"predecessor-version":[{"id":19081,"href":"https:\/\/wp.glbgpt.com\/it\/wp-json\/wp\/v2\/posts\/19043\/revisions\/19081"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/wp.glbgpt.com\/it\/wp-json\/wp\/v2\/media\/19073"}],"wp:attachment":[{"href":"https:\/\/wp.glbgpt.com\/it\/wp-json\/wp\/v2\/media?parent=19043"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/wp.glbgpt.com\/it\/wp-json\/wp\/v2\/categories?post=19043"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/wp.glbgpt.com\/it\/wp-json\/wp\/v2\/tags?post=19043"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}