Panoramica
Claude Code SDK è stato rinominato in Claude Agent SDK e la sua documentazione è stata riorganizzata. Questo cambiamento riflette le capacità più ampie dell’SDK per la creazione di agenti AI oltre ai soli compiti di codifica. State migrando da OpenAI Agents SDK? La ricetta di migrazione da OpenAI Agents SDK mappa ogni primitiva su Claude Agent SDK attraverso un singolo esempio pratico.Cosa è Cambiato
Passaggi di migrazione
Migrare un progetto TypeScript o JavaScript
1. Disinstalla il vecchio pacchetto:@anthropic-ai/claude-code a @anthropic-ai/claude-agent-sdk:
@anthropic-ai/claude-code è ancora elencato nel tuo package.json, sostituiscilo con @anthropic-ai/claude-agent-sdk e aggiorna anche l’intervallo di versione, ad esempio da "^0.0.42" a "^0.3.0".
5. Consulta le modifiche di rilievo
Apporta le modifiche al codice necessarie per completare la migrazione.
Migrare un progetto Python
1. Disinstalla il vecchio pacchetto:WARNING: Skipping claude-code-sdk as it is not installed. Questo è previsto e puoi continuare al passaggio successivo.
2. Installa il nuovo pacchetto:
claude-code-sdk è elencato nel tuo requirements.txt o pyproject.toml, sostituiscilo con claude-agent-sdk.
3. Aggiorna gli import:
Modifica tutti gli import da claude_code_sdk a claude_agent_sdk:
Modifiche di rilievo
Python: ClaudeCodeOptions rinominato in ClaudeAgentOptions
Cosa è cambiato: Il tipo SDK PythonClaudeCodeOptions è stato rinominato in ClaudeAgentOptions.
Migrazione:
System prompt non è più predefinito
Cosa è cambiato: L’SDK non utilizza più il system prompt di Claude Code per impostazione predefinita. Migrazione:Impostazioni predefinite delle origini
Questa impostazione predefinita è stata brevemente modificata in v0.1.0 per non caricare alcuna impostazione del file system e successivamente ripristinata, quindi non è necessaria alcuna azione di migrazione. Comportamento attuale: OmettendosettingSources su query() vengono caricate le impostazioni del file system dell’utente, del progetto e locale, corrispondendo alla CLI. Ciò include ~/.claude/settings.json, .claude/settings.json, .claude/settings.local.json, file CLAUDE.md e comandi personalizzati.
Per eseguire l’isolamento dalle impostazioni del file system, passare settingSources: [], oppure setting_sources=[] in Python. Vedere Controlla le impostazioni del filesystem con settingSources per informazioni su cosa carica ogni origine.
L’isolamento è particolarmente importante per le pipeline CI/CD, le applicazioni distribuite, gli ambienti di test e i sistemi multi-tenant in cui le personalizzazioni locali non dovrebbero trapelare.
Python SDK 0.1.59 e versioni precedenti hanno trattato un elenco vuoto allo stesso modo dell’omissione dell’opzione, quindi eseguire l’aggiornamento prima di fare affidamento su
setting_sources=[]. Vedere Cosa settingSources non controlla per gli input che vengono letti anche quando settingSources è [].Passaggi successivi
- Esplorare la Panoramica di Agent SDK per conoscere le funzionalità disponibili
- Consultare il Riferimento SDK TypeScript per la documentazione dettagliata dell’API
- Rivedere il Riferimento SDK Python per la documentazione specifica di Python
- Scopri di più su Strumenti personalizzati e Integrazione MCP