L'SDK di Claude Code, ora Claude Agent SDK

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.

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

Domande frequenti

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.