Descripción general
El Claude Code SDK ha sido renombrado a Claude Agent SDK y su documentación ha sido reorganizada. Este cambio refleja las capacidades más amplias del SDK para construir agentes de IA más allá de solo tareas de codificación. ¿Está migrando desde el OpenAI Agents SDK? La receta de migración de OpenAI Agents SDK asigna cada primitiva al Claude Agent SDK a través de un único ejemplo trabajado.Qué ha cambiado
Pasos de migración
Migrar un proyecto de TypeScript o JavaScript
1. Desinstala el paquete antiguo:@anthropic-ai/claude-code a @anthropic-ai/claude-agent-sdk:
@anthropic-ai/claude-code aún aparece en tu package.json, reemplázalo con @anthropic-ai/claude-agent-sdk y actualiza también el rango de versión, por ejemplo de "^0.0.42" a "^0.3.0".
5. Revisa los cambios importantes
Realiza los cambios de código necesarios para completar la migración.
Migrar un proyecto de Python
1. Desinstala el paquete antiguo:WARNING: Skipping claude-code-sdk as it is not installed. Esto es esperado y puedes continuar con el siguiente paso.
2. Instala el nuevo paquete:
claude-code-sdk aparece en tu requirements.txt o pyproject.toml, reemplázalo con claude-agent-sdk.
3. Actualiza tus importaciones:
Cambia todas las importaciones de claude_code_sdk a claude_agent_sdk:
Cambios importantes
Python: ClaudeCodeOptions renombrado a ClaudeAgentOptions
Qué cambió: El tipoClaudeCodeOptions del SDK de Python ha sido renombrado a ClaudeAgentOptions.
Migración:
El prompt del sistema ya no es predeterminado
Qué cambió: El SDK ya no utiliza el prompt del sistema de Claude Code de forma predeterminada. Migración:Predeterminado de fuentes de configuración
Este predeterminado fue brevemente cambiado en v0.1.0 para no cargar ninguna configuración del sistema de archivos y luego fue revertido, por lo que no se necesita ninguna acción de migración. Comportamiento actual: OmitirsettingSources en query() carga la configuración del usuario, proyecto y sistema de archivos local, coincidiendo con la CLI. Esto incluye ~/.claude/settings.json, .claude/settings.json, .claude/settings.local.json, archivos CLAUDE.md y comandos personalizados.
Para ejecutarse aislado de la configuración del sistema de archivos, pase settingSources: [], o setting_sources=[] en Python. Consulte Controlar la configuración del sistema de archivos con settingSources para ver qué carga cada fuente.
El aislamiento es especialmente importante para canalizaciones de CI/CD, aplicaciones implementadas, entornos de prueba y sistemas multiinquilino donde las personalizaciones locales no deben filtrarse.
Python SDK 0.1.59 y anteriores trataban una lista vacía igual que omitir la opción, así que actualice antes de confiar en
setting_sources=[]. Consulte Qué settingSources no controla para ver las entradas que se leen incluso cuando settingSources es [].Próximos pasos
- Explore la Descripción general de Agent SDK para aprender sobre las características disponibles
- Consulte la Referencia de SDK de TypeScript para documentación detallada de la API
- Revise la Referencia de SDK de Python para documentación específica de Python
- Aprenda sobre Herramientas personalizadas e Integración MCP