Source: https://aiprimetech.io/it/learn/how-to-get-a-claude-api-key/ [Home](/it/) / [Impara](/it/learn/) / Come ottenere una chiave API Claude # Come ottenere una chiave API Claude Puoi ottenere una chiave API Claude dalla Claude Console di Anthropic per accedere direttamente alle API, oppure creare un account AI Prime Tech per accedere tramite questo gateway indipendente. Scegli prima il fornitore: la chiave, la fatturazione e l'URL di base devono corrispondere. I passaggi seguenti descrivono entrambe le opzioni e mostrano come verificare una chiave del gateway prima di inviare una prima richiesta. ## Scegli dove ottenere la tua chiave API Claude Una chiave API identifica l'account o il progetto a cui vengono addebitate le richieste. Le credenziali di accesso alla chat di Claude e una chiave API hanno scopi diversi. Se desideri l'interfaccia di chat o le funzionalità dell'abbonamento, confronta [accesso API e abbonamenti di Claude](/it/learn/claude-api-vs-subscription/) prima di acquistare l'utilizzo delle API. | Modalità di accesso | Dove creare una chiave | Fatturazione ed endpoint | Accesso diretto ad Anthropic | [Claude Console](https://platform.claude.com/) | Account Anthropic e fatturazione API; api.anthropic.com | AI Prime Tech | [Crea un account](/register), quindi apri Chiavi API nella dashboard | Crediti del gateway o un piano a tempo idoneo; aiprimetech.io AI Prime Tech è gestito in modo indipendente e non è affiliato ad Anthropic né approvato da Anthropic. Usa l'opzione che soddisfa le tue esigenze di integrazione, fatturazione e assistenza; gli account e le chiavi sono separati. ## Ottieni una chiave dalla Claude Console ufficiale - Accedi alla [Claude Console](https://platform.claude.com/) e seleziona lo spazio di lavoro che utilizzerai. - Esamina la fatturazione API e i limiti di utilizzo dell'account. Completa tutte le configurazioni richieste dalla Console per il tuo account. - Apri [Chiavi API](https://platform.claude.com/settings/keys), crea una chiave per la tua applicazione e conservala in modo sicuro quando viene visualizzata. - Segui la [guida rapida ufficiale](https://platform.claude.com/docs/en/get-started) di Anthropic per le richieste dirette. Mantieni l'endpoint ufficiale per questa opzione; l'esempio del gateway riportato di seguito usa una chiave AI Prime Tech. ## Crea una chiave AI Prime Tech - [Registrati su AI Prime Tech](/register) e completa la verifica mostrata durante la registrazione. - Scegli [crediti API prepagati](/it/topup/) per la fatturazione a consumo oppure esamina i [piani a tempo di Claude](/it/plans/). Controlla l'offerta attuale, i modelli idonei e i limiti prima di pagare. Se vuoi prima valutare il servizio, la [guida alla prova](/it/learn/claude-api-free-trial/) mostra le eventuali offerte di benvenuto attuali e le relative condizioni. - Apri Chiavi API nella dashboard e crea una chiave per questa applicazione. Controlla il gruppo selezionato e le eventuali restrizioni della chiave affinché corrispondano all'accesso a Claude che hai acquistato. - Copia la chiave in una variabile d'ambiente locale o in un gestore di segreti. Usa una chiave separata per ogni applicazione, così da poter identificare l'utilizzo e sostituire una chiave senza modificare tutte le integrazioni. La creazione della chiave e il pagamento non dimostrano che un'integrazione funzioni. Controlla prima il catalogo dei modelli con quella chiave, quindi invia una piccola richiesta al modello che intendi usare. ## Verifica la chiave e gli ID dei modelli disponibili Su macOS, Linux o WSL, imposta la chiave del gateway nel terminale corrente. Sostituisci localmente il segnaposto con la tua chiave; non inserirla in script condivisi o screenshot. Copia ``` export ANTHROPIC_API_KEY="YOUR_GATEWAY_KEY" ``` Su Windows PowerShell, usa questa sintassi per la variabile d'ambiente: Copia ``` $env:ANTHROPIC_API_KEY = "YOUR_GATEWAY_KEY" ``` Richiedi l'elenco dei modelli. Si tratta di una richiesta al catalogo; non genera una risposta da un modello. Il comando seguente è per una shell compatibile con Bash: Copia ``` curl --fail-with-body --silent --show-error \ https://aiprimetech.io/v1/models \ -H "Authorization: Bearer $ANTHROPIC_API_KEY" ``` Per PowerShell: Copia ``` $headers = @{ Authorization = "Bearer $env:ANTHROPIC_API_KEY" } (Invoke-RestMethod "https://aiprimetech.io/v1/models" -Headers $headers).data | Select-Object id ``` Una risposta riuscita elenca gli ID dei modelli disponibili per la chiave. Scegli un modello Claude e copia il suo id esattamente in CLAUDE_MODEL. L'accesso ai modelli può dipendere dal gruppo e dalle autorizzazioni della chiave; una risposta del catalogo, da sola, non garantisce che un modello a monte completi una richiesta. Copia ``` export CLAUDE_MODEL="PASTE_A_CLAUDE_MODEL_ID_FROM_THE_RESPONSE" # PowerShell alternative: # $env:CLAUDE_MODEL = "PASTE_A_CLAUDE_MODEL_ID_FROM_THE_RESPONSE" ``` Prima di collegare un agente, verifica che la chiave usi il gruppo corrispondente all'accesso scelto. La [checklist di configurazione dell'agente](/it/agents/) collega questa verifica alla guida dello strumento appropriato. ## Invia la tua prima richiesta Python Installa l'SDK Python di Anthropic nell'ambiente del tuo progetto, salva l'esempio come test_claude.pyed eseguilo dal terminale in cui hai impostato la chiave e il modello. Questa richiesta usa il modello selezionato ed è soggetta alla fatturazione o al piano del tuo account. Copia ``` python -m pip install anthropic ``` test_claude.pyCopia ``` import os import anthropic # Set CLAUDE_MODEL to an exact Claude model ID returned for your key. client = anthropic.Anthropic( api_key=os.environ["ANTHROPIC_API_KEY"], base_url="https://aiprimetech.io", ) message = client.messages.create( model=os.environ["CLAUDE_MODEL"], max_tokens=64, messages=[{"role": "user", "content": "Reply with hello."}], ) for block in message.content: if block.type == "text": print(block.text) ``` Copia ``` python test_claude.py ``` Per questo SDK, l'URL di base del gateway è https://aiprimetech.io senza /v1; l'SDK costruisce il percorso della Messages API. I client che usano il formato compatibile con OpenAI generalmente usano https://aiprimetech.io/v1. Consulta la [guida all'SDK Python di Anthropic](/it/learn/anthropic-python-sdk/) o [guida all'API compatibile con OpenAI](/it/learn/openai-compatible-claude-api/) nel formato richiesto dalla tua applicazione. Dopo aver ricevuto la risposta, controlla i dettagli delle richieste e dell'utilizzo nella dashboard. Per la CLI, prosegui con [la configurazione della chiave API di Claude Code](/it/learn/claude-code-api-key-setup/); per un IDE, segui la [guida a Cursor](/it/learn/unlimited-cursor-claude-api/). ## Se la tua chiave API di Claude non funziona | Sintomo | Cosa controllare | 401 o API_KEY_REQUIRED | Verifica che la variabile d'ambiente sia impostata in questo terminale e che la richiesta invii la chiave al provider che l'ha emessa. | 403 o accesso negato | Controlla lo stato della chiave, il gruppo selezionato, le autorizzazioni dell'account e il modello richiesto. | Modello non trovato o non supportato | Copia l'ID esatto dall'elenco dei modelli della tua chiave. Se è presente nell'elenco ma continua a non funzionare, contatta l'assistenza indicando l'errore della richiesta e l'ID, senza includere la chiave. | Saldo insufficiente o nessun piano idoneo | Controlla il saldo nella dashboard, il periodo del piano e il gruppo di accesso della chiave. | 404 o una risposta HTML | Controlla il nome host, il formato API e il percorso. Non duplicare /v1 quando un client lo aggiunge autonomamente. | 429, 500 o 529 | Esamina la risposta, riduci la concorrenza dove necessario e segui la [guida agli errori API](/it/learn/claude-api-errors-troubleshooting/). ## Dove trovare e gestire la tua chiave Apri Chiavi API nella dashboard del provider che ha emesso la chiave. Usa i controlli disponibili per copiarla, mostrarla e revocarla. Se non riesci a recuperare un segreto utilizzabile, crea una chiave sostitutiva e revoca quella precedente dopo aver aggiornato la tua applicazione. Non inserire le chiavi nel controllo di versione, nelle segnalazioni pubbliche o nel JavaScript eseguito nel browser. Se una chiave viene esposta, sostituiscila e controllane l'utilizzo. Un cookie di sessione del browser non sostituisce una chiave API. ## Una chiave API di Claude è gratuita? Creare una chiave e pagare per l'utilizzo dei modelli sono passaggi distinti. Le condizioni attuali dell'account Anthropic sono riportate nella sua Console. Su AI Prime Tech, la [guida alla prova](/it/learn/claude-api-free-trial/) mostra le eventuali offerte di benvenuto disponibili; i [pagina di ricarica](/it/topup/) e [pagina pubblica dei piani](/it/plans/) mostrano le opzioni a pagamento continuative. Verifica i requisiti di idoneità e l'offerta mostrata durante la registrazione. Un credito temporaneo o una prova non garantiscono un utilizzo gratuito a tempo indeterminato. ## Domande frequenti Come posso ottenere una chiave API di Claude? Crea una chiave nella [Claude Console](https://platform.claude.com/settings/keys) per accedere direttamente ad Anthropic, oppure [registrati su AI Prime Tech](/register), scegli l'accesso al gateway appropriato e crea una chiave nella dashboard. Usa l'endpoint del provider che l'ha emessa. Dove trovo la mia chiave API di Claude? Apri Chiavi API nella dashboard del provider emittente e usa i controlli disponibili per la gestione delle chiavi. Conserva il segreto in modo sicuro; se non riesci a recuperarlo, crea una chiave sostitutiva e revoca quella precedente. Posso ottenere una chiave API di Claude gratuita? La creazione di una chiave non finanzia di per sé le richieste API. Controlla le condizioni attuali del provider emittente. La [guida alla prova](/it/learn/claude-api-free-trial/) di AI Prime Tech elenca le eventuali offerte di benvenuto attuali e le relative condizioni. Un abbonamento Claude Pro o Max copre i costi di questo gateway? No. AI Prime Tech ha un account, chiavi e fatturazione propri. Consulta [Accesso API e abbonamenti a confronto](/it/learn/claude-api-vs-subscription/) per scegliere il prodotto di cui hai bisogno. Quale ID modello devo usare? Esegui una richiesta GET /v1/models con la tua chiave del gateway e scegli un ID modello Claude esatto tra quelli restituiti per quella chiave. Esegui una piccola richiesta Messages per verificare che il modello funzioni con il tuo accesso. Inizia a usare Claude in pochi minuti Ottieni una chiave API: non servono un account Anthropic né una lista d'attesa.[Ottieni la tua chiave API](/register) AI Prime Tech è un gateway API indipendente. Non è affiliato ad Anthropic, non è approvato da Anthropic e non è un suo rivenditore. Claude e i nomi dei modelli correlati sono marchi dei rispettivi proprietari. ## Altre guide all'API di Claude [I prezzi dell'API Claude, spiegati](/it/learn/claude-api-pricing-explained/)[Il modo più economico per usare l'API Claude](/it/learn/cheapest-way-to-use-claude-api/)[Cursor illimitato con l'API Claude](/learn/use-claude-api-with-cursor/)[Accesso illimitato a Claude Code](/it/learn/use-claude-api-with-claude-code/)[Gateway API Claude e accesso diretto ad Anthropic a confronto](/it/learn/claude-api-vs-anthropic-direct/)[Usa Claude con l'SDK OpenAI: endpoint compatibile con OpenAI, streaming, strumenti e limiti](/it/learn/openai-compatible-claude-api/)[I modelli Claude spiegati: un confronto tra Claude Opus, Sonnet, Haiku e Fable — tutti i modelli API Claude, i nomi dei modelli Anthropic e i prezzi (2026)](/it/learn/claude-api-models-compared/)[Pagare l'API Claude con criptovalute](/it/learn/claude-api-with-crypto-payment/)[Accesso all'API Claude senza lista d'attesa](/it/learn/claude-api-without-waitlist/)[Come ridurre l'utilizzo dei token di Claude](/it/learn/how-to-reduce-claude-token-usage/)[Cline illimitato con l'API Claude](/it/learn/use-claude-api-with-cline/)[Roo Code illimitato con l'API Claude](/it/learn/use-claude-api-with-roo-code/)[Claude illimitato negli IDE JetBrains](/it/learn/use-claude-api-with-jetbrains/)[Aider con Claude tramite un gateway: ANTHROPIC_API_BASE, file di configurazione, modalità architect e soluzioni ai problemi](/it/learn/use-claude-api-with-aider/)[Claude illimitato in VS Code](/it/learn/use-claude-api-with-vscode/)[Configurazione di OpenCode per Claude: impostazione di opencode.json, modelli ed errori comuni](/it/learn/use-claude-api-with-opencode/)[Hermes Agent con Claude tramite un gateway: configurazione di un provider personalizzato, controllo dei costi e soluzioni ai problemi](/it/learn/run-hermes-agent-with-claude-api/)[Eseguire OpenClaw senza limiti con Claude](/it/learn/run-openclaw-with-claude-api/)[Cosa significa un'API compatibile con Anthropic](/it/learn/anthropic-compatible-api/)[Chiave API di Claude Code — ANTHROPIC_API_KEY: come ottenerla, configurarla e quando usare invece claude setup-token](/it/learn/claude-code-api-key-setup/)[Costi dell'API di Claude Code — Prezzi e come ridurli](/it/learn/claude-code-api-costs/)[Gli errori dell'API Claude spiegati: errore del server 500, sovraccarico 529, limite di frequenza 429, richiesta non valida 400 — e la soluzione per ciascuno](/it/learn/claude-api-errors-troubleshooting/)[Come acquistare crediti API di Claude](/it/learn/buy-claude-api-credits/)[API Claude gratuita: esiste una chiave API di Claude gratuita e che cosa è davvero gratuito nel 2026?](/it/learn/claude-api-free-trial/)[API Claude e abbonamento Claude Pro/Max a confronto — Quale scegliere](/it/learn/claude-api-vs-subscription/)[Codex CLI con un provider personalizzato: config.toml, modelli GPT e Claude, estensione IDE e soluzioni ai problemi](/it/learn/use-claude-api-with-codex/)[Collegare Claude a n8n](/it/learn/use-claude-api-with-n8n/)[Instradare LiteLLM verso Claude](/it/learn/use-claude-api-with-litellm/)[Usare Claude in Kilo Code](/it/learn/use-claude-api-with-kilo-code/)[GitHub Copilot Chat con Claude tramite un gateway: configurazione di Custom Endpoint, modalità agente e soluzioni ai problemi](/it/learn/use-claude-api-with-github-copilot/)[Collega Zed a Claude tramite il gateway](/it/learn/use-claude-api-with-zed/)[Collega Cherry Studio a Claude](/it/learn/use-claude-api-with-cherry-studio/)[ChatAnthropic in LangChain: importazione, base_url, streaming, strumenti ed errori](/it/learn/use-claude-api-with-langchain/)[SDK Python di Anthropic: installazione, configurazione di base_url, streaming e gestione degli errori](/it/learn/anthropic-python-sdk/)[Claude con Vercel AI SDK: baseURL di createAnthropic, streaming e soluzioni ai problemi](/it/learn/use-claude-api-with-vercel-ai-sdk/)[Esegui Factory Droid con Claude](/it/learn/use-claude-api-with-factory-droid/)[L'API di Claude Code spiegata](/it/learn/claude-code-api/)[Integrare l'API di Claude nella tua applicazione](/it/learn/claude-api-integration/)[Come ottenere un uso illimitato di Claude](/it/learn/get-unlimited-claude-usage/)[Cosa significa accesso illimitato all'API di Claude](/it/learn/unlimited-claude-api-access/)