Übersicht
Das Claude Code SDK wurde in das Claude Agent SDK umbenannt und seine Dokumentation wurde neu organisiert. Diese Änderung spiegelt die umfassenderen Funktionen des SDK für die Erstellung von KI-Agenten über reine Codierungsaufgaben hinaus wider. Migrieren Sie stattdessen vom OpenAI Agents SDK? Das OpenAI Agents SDK-Migrationskochbuch ordnet jedes Primitive dem Claude Agent SDK durch ein einzelnes durchgearbeitetes Beispiel zu.Was hat sich geändert
Migrationsschritte
Ein TypeScript- oder JavaScript-Projekt migrieren
1. Deinstallieren Sie das alte Paket:@anthropic-ai/claude-code zu @anthropic-ai/claude-agent-sdk:
@anthropic-ai/claude-code noch in Ihrer package.json aufgelistet ist, ersetzen Sie es durch @anthropic-ai/claude-agent-sdk und aktualisieren Sie auch den Versionsbereich, zum Beispiel von "^0.0.42" zu "^0.3.0".
5. Überprüfen Sie Breaking Changes
Nehmen Sie alle erforderlichen Codeänderungen vor, um die Migration abzuschließen.
Ein Python-Projekt migrieren
1. Deinstallieren Sie das alte Paket:WARNING: Skipping claude-code-sdk as it is not installed. aus. Das ist zu erwarten und Sie können zum nächsten Schritt übergehen.
2. Installieren Sie das neue Paket:
claude-code-sdk in Ihrer requirements.txt oder pyproject.toml aufgelistet ist, ersetzen Sie es durch claude-agent-sdk.
3. Aktualisieren Sie Ihre Importe:
Ändern Sie alle Importe von claude_code_sdk zu claude_agent_sdk:
Grundlegende Änderungen
Python: ClaudeCodeOptions in ClaudeAgentOptions umbenannt
Was hat sich geändert: Der Python SDK-TypClaudeCodeOptions wurde in ClaudeAgentOptions umbenannt.
Migration:
System-Eingabeaufforderung ist nicht mehr Standard
Was hat sich geändert: Das SDK verwendet nicht mehr standardmäßig die System-Eingabeaufforderung von Claude Code. Migration:Standardwerte für Einstellungsquellen
Dieser Standard wurde in v0.1.0 kurzzeitig geändert, um keine Dateisystem-Einstellungen zu laden, und wurde dann zurückgesetzt, daher ist keine Migrationsaktion erforderlich. Aktuelles Verhalten: Das Weglassen vonsettingSources bei query() lädt Benutzer-, Projekt- und lokale Dateisystem-Einstellungen, was der CLI entspricht. Dies umfasst ~/.claude/settings.json, .claude/settings.json, .claude/settings.local.json, CLAUDE.md-Dateien und benutzerdefinierte Befehle.
Um isoliert von Dateisystem-Einstellungen zu laufen, übergeben Sie settingSources: [] oder setting_sources=[] in Python. Siehe Dateisystem-Einstellungen mit settingSources steuern, um zu erfahren, welche Quellen jeweils geladen werden.
Die Isolation ist besonders wichtig für CI/CD-Pipelines, bereitgestellte Anwendungen, Testumgebungen und Multi-Tenant-Systeme, in denen lokale Anpassungen nicht durchsickern sollten.
Python SDK 0.1.59 und früher behandelten eine leere Liste genauso wie das Weglassen der Option, daher sollten Sie ein Upgrade durchführen, bevor Sie sich auf
setting_sources=[] verlassen. Siehe Was settingSources nicht steuert, um zu erfahren, welche Eingaben auch dann gelesen werden, wenn settingSources auf [] gesetzt ist.Nächste Schritte
- Erkunden Sie die Agent SDK-Übersicht, um mehr über verfügbare Funktionen zu erfahren
- Schauen Sie sich die TypeScript SDK-Referenz für detaillierte API-Dokumentation an
- Überprüfen Sie die Python SDK-Referenz für Python-spezifische Dokumentation
- Erfahren Sie mehr über Benutzerdefinierte Tools und MCP-Integration