Zum Hauptinhalt springen

Ü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 SDKs für die Erstellung von KI-Agenten über reine Codierungsaufgaben hinaus wider.

Was hat sich geändert

Dokumentationsänderungen: Die Agent SDK-Dokumentation wurde aus der Claude Code-Dokumentation in den API-Leitfaden unter einem dedizierten Agent SDK-Bereich verschoben. Die Claude Code-Dokumentation konzentriert sich nun auf das CLI-Tool und Automatisierungsfunktionen.

Migrationsschritte

Für TypeScript/JavaScript-Projekte

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 die package.json-Abhängigkeiten: Wenn Sie das Paket in Ihrer package.json aufgelistet haben, aktualisieren Sie es: Vorher:
Nachher:
5. Überprüfen Sie Breaking Changes Nehmen Sie alle erforderlichen Codeänderungen vor, um die Migration abzuschließen.

Für Python-Projekte

1. Deinstallieren Sie das alte Paket:
2. Installieren Sie das neue Paket:
3. Aktualisieren Sie Ihre Importe: Ändern Sie alle Importe von claude_code_sdk zu claude_agent_sdk:
4. Aktualisieren Sie die Typnamen: Ändern Sie ClaudeCodeOptions zu ClaudeAgentOptions:
5. Überprüfen Sie Breaking Changes Nehmen Sie alle erforderlichen Codeänderungen vor, um die Migration abzuschließen.

Breaking Changes

Um die Isolation und explizite Konfiguration zu verbessern, führt Claude Agent SDK v0.1.0 Breaking Changes für Benutzer ein, die vom Claude Code SDK migrieren. Überprüfen Sie diesen Abschnitt sorgfältig vor der Migration.

Python: ClaudeCodeOptions in ClaudeAgentOptions umbenannt

Was hat sich geändert: Der Python SDK-Typ ClaudeCodeOptions wurde in ClaudeAgentOptions umbenannt. Migration:
Warum sich das geändert hat: Der Typname entspricht nun dem Branding „Claude Agent SDK” und bietet Konsistenz in den Namenskonventionen des SDKs.

System-Prompt ist nicht mehr Standard

Was hat sich geändert: Das SDK verwendet nicht mehr standardmäßig Claude Codes System-Prompt. Migration:
Warum sich das geändert hat: Bietet bessere Kontrolle und Isolation für SDK-Anwendungen. Sie können nun Agenten mit benutzerdefiniertem Verhalten erstellen, ohne Claude Codes CLI-fokussierte Anweisungen zu erben.

Einstellungsquellen-Standard

Dieser Standard wurde kurzzeitig in v0.1.0 geändert und dann rückgängig gemacht, daher ist keine Migrationsaktion erforderlich. Aktuelles Verhalten: Das Weglassen von settingSources auf query() lädt Benutzer-, Projekt- und lokale Dateisystem-Einstellungen, was dem 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 ein leeres Array:
Isolation ist besonders wichtig für CI/CD-Pipelines, bereitgestellte Anwendungen, Testumgebungen und Multi-Tenant-Systeme, in denen lokale Anpassungen nicht eindringen sollten.
SDK v0.1.0 standardmäßig kurzzeitig auf keine geladenen Einstellungen; dies wurde in nachfolgenden Versionen rückgängig gemacht. Python SDK 0.1.59 und früher behandelten eine leere Liste genauso wie das Weglassen der Option, daher aktualisieren Sie vor dem Verlassen auf setting_sources=[]. Siehe Was settingSources nicht kontrolliert für Eingaben, die auch gelesen werden, wenn settingSources [] ist.

Warum die Umbenennung?

Das Claude Code SDK wurde ursprünglich für Codierungsaufgaben entwickelt, hat sich aber zu einem leistungsstarken Framework für die Erstellung aller Arten von KI-Agenten entwickelt. Der neue Name „Claude Agent SDK” spiegelt seine Funktionen besser wider:
  • Erstellung von Business-Agenten (Rechtsassistenten, Finanzberater, Kundensupport)
  • Erstellung spezialisierter Codierungs-Agenten (SRE-Bots, Sicherheitsprüfer, Code-Review-Agenten)
  • Entwicklung benutzerdefinierter Agenten für jede Domäne mit Tool-Nutzung, MCP-Integration und mehr

Hilfe erhalten

Wenn Sie während der Migration auf Probleme stoßen: Für TypeScript/JavaScript:
  1. Überprüfen Sie, dass alle Importe aktualisiert wurden, um @anthropic-ai/claude-agent-sdk zu verwenden
  2. Überprüfen Sie, dass Ihre package.json den neuen Paketnamen hat
  3. Führen Sie npm install aus, um sicherzustellen, dass die Abhängigkeiten aktualisiert werden
Für Python:
  1. Überprüfen Sie, dass alle Importe aktualisiert wurden, um claude_agent_sdk zu verwenden
  2. Überprüfen Sie, dass Ihre requirements.txt oder pyproject.toml den neuen Paketnamen hat
  3. Führen Sie pip install claude-agent-sdk aus, um sicherzustellen, dass das Paket installiert ist

Nächste Schritte