Skip to main content

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:
2. Installa il nuovo pacchetto:
3. Aggiorna gli import: Modifica tutti gli import da @anthropic-ai/claude-code a @anthropic-ai/claude-agent-sdk:
4. Aggiorna package.json: Se @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:
Se il vecchio pacchetto non è installato, pip stampa WARNING: Skipping claude-code-sdk as it is not installed. Questo è previsto e puoi continuare al passaggio successivo. 2. Installa il nuovo pacchetto:
Se 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:
4. Consulta le modifiche di rilievo Apporta le modifiche al codice necessarie per completare la migrazione.

Modifiche di rilievo

Per migliorare l’isolamento e la configurazione esplicita, Claude Agent SDK v0.1.0 introduce modifiche di rilievo per gli utenti che eseguono la migrazione da Claude Code SDK.

Python: ClaudeCodeOptions rinominato in ClaudeAgentOptions

Cosa è cambiato: Il tipo SDK Python ClaudeCodeOptions è 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: Omettendo settingSources 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