Skip to main content

Ü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:
2. Installieren Sie das neue Paket:
3. Aktualisieren Sie Ihre Importe: Ändern Sie alle Importe von @anthropic-ai/claude-code zu @anthropic-ai/claude-agent-sdk:
4. Aktualisieren Sie package.json: Wenn @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:
Wenn das alte Paket nicht installiert ist, gibt pip 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:
Wenn 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:
4. Überprüfen Sie Breaking Changes Nehmen Sie alle erforderlichen Codeänderungen vor, um die Migration abzuschließen.

Grundlegende Änderungen

Um die Isolation zu verbessern und die explizite Konfiguration zu ermöglichen, führt Claude Agent SDK v0.1.0 grundlegende Änderungen für Benutzer ein, die von Claude Code SDK migrieren.

Python: ClaudeCodeOptions in ClaudeAgentOptions umbenannt

Was hat sich geändert: Der Python SDK-Typ ClaudeCodeOptions 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 von settingSources 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