Skip to main content

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:
2. Instala el nuevo paquete:
3. Actualiza tus importaciones: Cambia todas las importaciones de @anthropic-ai/claude-code a @anthropic-ai/claude-agent-sdk:
4. Actualiza package.json: Si @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:
Si el paquete antiguo no está instalado, pip imprime 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:
Si 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:
4. Revisa los cambios importantes Realiza los cambios de código necesarios para completar la migración.

Cambios importantes

Para mejorar el aislamiento y la configuración explícita, Claude Agent SDK v0.1.0 introduce cambios importantes para los usuarios que migran desde Claude Code SDK.

Python: ClaudeCodeOptions renombrado a ClaudeAgentOptions

Qué cambió: El tipo ClaudeCodeOptions 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: Omitir settingSources 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