Source: https://aiprimetech.io/it/claude-code/sdk/

[Home](/it/) › [Claude Code](/it/claude-code/) › Agent SDK

[Panoramica](/it/claude-code/)[Installazione](/it/claude-code/install/)[riferimento della CLI](/it/claude-code/cli/)[Prezzi e limiti](/it/claude-code/pricing/)[Agent SDK](/it/claude-code/sdk/)[Skill e plugin](/it/claude-code/skills/)[GitHub](/it/claude-code/github/)[Web, desktop e IDE](/it/claude-code/web-and-desktop/)[Modelli](/it/claude-code/models/)[Errori](/it/claude-code/errors/)[È open source?](/it/claude-code/open-source/)[Tutorial](/it/claude-code/tutorial/)[Per studenti](/it/claude-code/for-students/)[Automazione QA](/it/claude-code/qa-automation/)[Confronto con Cursor](/it/claude-code/vs-cursor/)[Confronto con Codex e OpenCode](/it/claude-code/vs-codex/)[Subagenti](/it/claude-code/subagents/)[Hook](/it/claude-code/hooks/)[MCP](/it/claude-code/mcp/)[Ecosistema](/it/claude-code/ecosystem/)[VS Code](/it/claude-code/vscode/)[OpenRouter](/it/claude-code/openrouter/)[Limiti di frequenza](/it/claude-code/rate-limits/)[Guida in cinese](/claude-code/zh/)

Ultimo aggiornamento: 11 ottobre 2026

# L'SDK di Claude Code, ora Claude Agent SDK

Lo stesso ciclo dell'agente che viene eseguito nel tuo terminale è disponibile come libreria. Anthropic ha rinominato Claude Code SDK in Claude Agent SDK quando è diventato chiaro che le persone lo usavano per creare molto più che strumenti di programmazione.

## TLDR
- Python: pip install claude-agent-sdk; TypeScript: npm install @anthropic-ai/claude-agent-sdk.
- Ottieni l'agente completo — strumenti per i file, bash, sottoagenti, MCP — controllato dal codice, con callback per le autorizzazioni.
- L'SDK legge ANTHROPIC_BASE_URL e ANTHROPIC_API_KEY come fa la CLI, quindi si applica la fatturazione del gateway.

## Due modi per automatizzare Claude Code 

La via più leggera è la modalità di stampa della CLI — claude -p da qualsiasi linguaggio, con output JSON. L'approccio completo è l'Agent SDK, che espone il ciclo, l'insieme degli strumenti, gli hook e le autorizzazioni come oggetti sotto il tuo controllo. 

## Python 

```
import anyio
from claude_agent_sdk import query, ClaudeAgentOptions

async def main():
    options = ClaudeAgentOptions(
        allowed_tools=["Read", "Edit", "Bash"],
        max_turns=8,
    )
    async for message in query(
        prompt="add type hints to utils.py and run the tests",
        options=options,
    ):
        print(message)

anyio.run(main)
```

## TypeScript 

```
import { query } from "@anthropic-ai/claude-agent-sdk";

for await (const message of query({
  prompt: "find and fix the flaky test in this repo",
  options: { allowedTools: ["Read", "Edit", "Bash"], maxTurns: 8 },
})) {
  console.log(message);
}
```

## Esecuzione tramite il gateway 

```
export ANTHROPIC_BASE_URL=https://aiprimetech.io
export ANTHROPIC_API_KEY=your_gateway_key
python agent.py
```

L'SDK avvia lo stesso runtime di Claude Code, quindi gli bastano le variabili d'ambiente. È con gli agenti di lunga durata che i prezzi del gateway contano di più: un ciclo autonomo può effettuare centinaia di chiamate all'ora e un piano a tariffa fissa trasforma una stima dei costi in un importo fisso. 

## Cosa aggiunge l'SDK rispetto alla modalità print 
- Callback di autorizzazione: approva o nega ogni chiamata a uno strumento dal tuo codice.
- Strumenti personalizzati tramite server MCP nello stesso processo, così l'agente può chiamare le tue funzioni.
- Hook per gli eventi degli strumenti, il ciclo di vita della sessione e gli errori.
- Subagenti e output strutturato, senza eseguire comandi tramite shell e analizzare testo.

## Provalo prima gratuitamente

I nuovi account ricevono $5 di credito API gratuito con il codice CLAUDECODE — abbastanza per una serata con Claude Code su Sonnet — poi crediti pari a 7.69231× il valore nominale.

```
export ANTHROPIC_BASE_URL=https://aiprimetech.io
export ANTHROPIC_API_KEY=your_key
```

[Crea un account con il codice CLAUDECODE](/register?promo=CLAUDECODE)

## Domande frequenti

Il Claude Code SDK è la stessa cosa dell'SDK di Anthropic?

No. L'SDK di Anthropic chiama direttamente la Messages API. Il Claude Agent SDK (in precedenza Claude Code SDK) esegue l'intero agente — strumenti, file, bash, subagenti — appoggiandosi a questa API.Quali linguaggi supporta l'Agent SDK?

Ufficialmente Python e TypeScript; qualsiasi altro linguaggio può pilotare la modalità print della CLI con output JSON.L'SDK funziona con un URL di base personalizzato?

Sì. Eredita ANTHROPIC_BASE_URL e ANTHROPIC_API_KEY dall'ambiente, esattamente come la CLI.

## Esegui Claude Code sul gateway

Stessi modelli, due variabili d'ambiente, crediti pari a 7.69231× il valore nominale — oppure un piano illimitato a tariffa fissa. Nuovi account: $5 di credito API gratuito con il codice CLAUDECODE.[Ottieni una chiave API](/register?promo=CLAUDECODE) [Scopri i piani illimitati](/it/plans/)

AI Prime Tech è un gateway API indipendente e non è affiliato ad Anthropic, né approvato o sponsorizzato da Anthropic. «Claude» e «Claude Code» sono marchi di Anthropic. Le funzionalità di Claude Code descritte qui rispecchiano la documentazione pubblica di Anthropic al momento della stesura e cambiano frequentemente; i prezzi e gli elenchi dei modelli presenti in questa pagina vengono letti dalle impostazioni attuali di questo gateway.

## Altre guide su Claude Code

[Claude Code: la guida completa](/it/claude-code/)[Come installare Claude Code](/it/claude-code/install/)[Documentazione della CLI di Claude Code: comandi e flag](/it/claude-code/cli/)[Prezzi e limiti di Claude Code, spiegati](/it/claude-code/pricing/)[Skill e plugin di Claude Code](/it/claude-code/skills/)[Claude Code in GitHub: App, Action e @claude](/it/claude-code/github/)[Claude Code ha un'interfaccia web? Le versioni web, desktop e per IDE spiegate](/it/claude-code/web-and-desktop/)[Quale modello usa Claude Code e come cambiarlo](/it/claude-code/models/)[Errori di Claude Code e come risolverli](/it/claude-code/errors/)[Claude Code è open source?](/it/claude-code/open-source/)[Tutorial di Claude Code: la tua prima sessione reale](/it/claude-code/tutorial/)[Claude per studenti: Claude Code, l'API e ciò che offre davvero il settore education](/it/claude-code/for-students/)[Come usare Claude Code per l'automazione QA](/it/claude-code/qa-automation/)[Claude Code e Cursor a confronto: quale scegliere, quando — e come usarli entrambi](/it/claude-code/vs-cursor/)[Claude Code vs Codex vs OpenCode: confronto tra gli agenti da terminale](/it/claude-code/vs-codex/)[Subagenti di Claude Code: come funzionano, come definirli e team di agenti](/it/claude-code/subagents/)[Hook di Claude Code: controllo deterministico su ciò che fa l'agente](/it/claude-code/hooks/)[MCP in Claude Code: connessione ai server, ambiti, MCP remoto ed esempi concreti](/it/claude-code/mcp/)[L'ecosistema Claude Code: router, framework, plugin e gli elenchi che li raccolgono](/it/claude-code/ecosystem/)[Claude Code in VS Code: l'estensione, l'uso dal terminale e gli errori](/it/claude-code/vscode/)[Come usare OpenRouter in Claude Code (e quando evitarlo)](/it/claude-code/openrouter/)[Errore di limite di frequenza di Claude: cosa significa "Errore API: limite di frequenza raggiunto" e come risolverlo](/it/claude-code/rate-limits/)[Come usare Claude Code: dall'installazione all'uso quotidiano](/claude-code/zh/)