Framework · Anthropic
Claude Agent SDK in breve
L'SDK di Anthropic mette a disposizione l'harness di Claude Code, con tool per file e shell, autorizzazioni, hook, subagenti e skill, all'interno del tuo programma Python o TypeScript. A differenza degli altri elementi di questo elenco, funziona solo con i modelli Claude e il suo utilizzo è disciplinato dai Termini commerciali di Anthropic.
Ideale per: App in cui Claude deve svolgere attività reali su un filesystem, con autorizzazioni per i tool sotto il tuo controllo.
Informazioni principali
- Responsabile
- Anthropic
- Linguaggi
- Python, TypeScript
- Licenza
- Anthropic Commercial Terms
- Ultima versione
Python 0.2.163 / TypeScript 0.3.286· 30 settembre 2026- Repository
- anthropics/claude-agent-sdk-python
- Opzione hosted
- Claude Managed Agents
Guida rapida
Installa il pacchetto, configura le credenziali, quindi esegui l'agente più semplice indicato nella documentazione ufficiale. Gli ID dei modelli sono quelli usati nella documentazione e potrebbero non essere abilitati per il tuo account.
Python
pip install claude-agent-sdkimport asyncio
from claude_agent_sdk import query, ClaudeAgentOptions
async def main():
async for message in query(
prompt="Find and fix the bug in auth.py",
options=ClaudeAgentOptions(allowed_tools=["Read", "Edit", "Bash"]),
):
print(message) # Claude reads the file, finds the bug, edits it
asyncio.run(main())TypeScript
npm install @anthropic-ai/claude-agent-sdkimport { query } from "@anthropic-ai/claude-agent-sdk";
for await (const message of query({
prompt: "Find and fix the bug in auth.ts",
options: { allowedTools: ["Read", "Edit", "Bash"] }
})) {
console.log(message); // Claude reads the file, finds the bug, edits it
}Funzionalità
| Qualsiasi modello | No | Solo Claude, tramite Anthropic, Bedrock, Google Cloud o Foundry |
|---|---|---|
| Client MCP | Sì | Opzione mcpServers; i plugin possono includere server MCP |
| Server MCP | Non confermato | |
| Multi-agent | Sì | I subagenti gestiscono sottoattività specifiche |
| Esecuzioni durevoli | Non confermato | Le sessioni possono essere riprese o ramificate; nessun motore di durabilità |
| Approvazione umana | Sì | Le modalità di autorizzazione stabiliscono quali tool richiedono approvazione |
| Tracing | Sì | Esportazione OpenTelemetry; le trace sono in beta |
| Valutazioni | No |
Modifiche recenti
- Rinominato da Claude Code SDK; è disponibile una guida alla migrazione.
- Ora entrambi gli SDK includono un binario nativo di Claude Code.
- Dal 15 giugno 2026, l'utilizzo dell'SDK con i piani in abbonamento viene conteggiato separatamente e usa un credito mensile Agent SDK dedicato.
- Le app di terze parti non possono offrire l'accesso con claude.ai senza l'approvazione di Anthropic.