Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
El SDK de Claude Code 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.
| Aspecto | Anterior | Nuevo |
|---|---|---|
| Nombre del paquete (TS/JS) | @anthropic-ai/claude-code | @anthropic-ai/claude-agent-sdk |
| Paquete de Python | claude-code-sdk | claude-agent-sdk |
| Ubicación de la documentación | Documentación de Claude Code | Guía de API → Sección Agent SDK |
Cambios en la documentación: La documentación del Agent SDK se ha movido de los documentos de Claude Code a la Guía de API bajo una sección dedicada Agent SDK. Los documentos de Claude Code ahora se enfocan en la herramienta CLI y características de automatización.
1. Desinstala el paquete anterior:
npm uninstall @anthropic-ai/claude-code2. Instala el nuevo paquete:
npm install @anthropic-ai/claude-agent-sdk3. Actualiza tus importaciones:
Cambia todas las importaciones de @anthropic-ai/claude-code a @anthropic-ai/claude-agent-sdk:
// Antes
import { query, tool, createSdkMcpServer } from "@anthropic-ai/claude-code";
// Después
import {
query,
tool,
createSdkMcpServer,
} from "@anthropic-ai/claude-agent-sdk";4. Actualiza las dependencias de package.json:
Si tienes el paquete listado en tu package.json, actualízalo:
// Antes
{
"dependencies": {
"@anthropic-ai/claude-code": "^1.0.0"
}
}
// Después
{
"dependencies": {
"@anthropic-ai/claude-agent-sdk": "^0.1.0"
}
}¡Eso es todo! No se requieren otros cambios de código.
1. Desinstala el paquete anterior:
pip uninstall claude-code-sdk2. Instala el nuevo paquete:
pip install claude-agent-sdk3. Actualiza tus importaciones:
Cambia todas las importaciones de claude_code_sdk a claude_agent_sdk:
# Antes
from claude_code_sdk import query, ClaudeCodeOptions
# Después
from claude_agent_sdk import query, ClaudeAgentOptions4. Actualiza los nombres de tipos:
Cambia ClaudeCodeOptions a ClaudeAgentOptions:
# Antes
from claude_agent_sdk import query, ClaudeCodeOptions
options = ClaudeCodeOptions(
model="claude-sonnet-4-5"
)
# Después
from claude_agent_sdk import query, ClaudeAgentOptions
options = ClaudeAgentOptions(
model="claude-sonnet-4-5"
)5. Revisa cambios importantes
Realiza los cambios de código necesarios para completar la migración.
Para mejorar el aislamiento y la configuración explícita, Claude Agent SDK v0.1.0 introduce cambios importantes para usuarios que migran desde Claude Code SDK. Revisa esta sección cuidadosamente antes de migrar.
Qué cambió: El tipo de SDK de Python ClaudeCodeOptions ha sido renombrado a ClaudeAgentOptions.
Migración:
# ANTES (v0.0.x)
from claude_agent_sdk import query, ClaudeCodeOptions
options = ClaudeCodeOptions(
model="claude-sonnet-4-5",
permission_mode="acceptEdits"
)
# DESPUÉS (v0.1.0)
from claude_agent_sdk import query, ClaudeAgentOptions
options = ClaudeAgentOptions(
model="claude-sonnet-4-5",
permission_mode="acceptEdits"
)Por qué cambió: El nombre del tipo ahora coincide con la marca "Claude Agent SDK" y proporciona consistencia en las convenciones de nomenclatura del SDK.
Qué cambió: El SDK ya no utiliza el mensaje del sistema de Claude Code de forma predeterminada.
Migración:
// ANTES (v0.0.x) - Utilizaba el mensaje del sistema de Claude Code de forma predeterminada
const result = query({ prompt: "Hello" });
// DESPUÉS (v0.1.0) - Utiliza un mensaje del sistema vacío de forma predeterminada
// Para obtener el comportamiento anterior, solicita explícitamente el preajuste de Claude Code:
const result = query({
prompt: "Hello",
options: {
systemPrompt: { type: "preset", preset: "claude_code" }
}
});
// O utiliza un mensaje del sistema personalizado:
const result = query({
prompt: "Hello",
options: {
systemPrompt: "You are a helpful coding assistant"
}
});Por qué cambió: Proporciona mejor control e aislamiento para aplicaciones SDK. Ahora puedes construir agentes con comportamiento personalizado sin heredar las instrucciones enfocadas en CLI de Claude Code.
Qué cambió: El SDK ya no lee la configuración del sistema de archivos (CLAUDE.md, settings.json, comandos de barra, etc.) de forma predeterminada.
Migración:
// ANTES (v0.0.x) - Cargaba toda la configuración automáticamente
const result = query({ prompt: "Hello" });
// Leería desde:
// - ~/.claude/settings.json (usuario)
// - .claude/settings.json (proyecto)
// - .claude/settings.local.json (local)
// - Archivos CLAUDE.md
// - Comandos de barra personalizados
// DESPUÉS (v0.1.0) - No se carga configuración de forma predeterminada
// Para obtener el comportamiento anterior:
const result = query({
prompt: "Hello",
options: {
settingSources: ["user", "project", "local"]
}
});
// O carga solo fuentes específicas:
const result = query({
prompt: "Hello",
options: {
settingSources: ["project"] // Solo configuración del proyecto
}
});Por qué cambió: Garantiza que las aplicaciones SDK tengan un comportamiento predecible independiente de las configuraciones del sistema de archivos local. Esto es especialmente importante para:
Compatibilidad hacia atrás: Si tu aplicación dependía de la configuración del sistema de archivos (comandos de barra personalizados, instrucciones de CLAUDE.md, etc.), agrega settingSources: ['user', 'project', 'local'] a tus opciones.
El SDK de Claude Code fue diseñado originalmente para tareas de codificación, pero ha evolucionado hacia un marco poderoso para construir todo tipo de agentes de IA. El nuevo nombre "Claude Agent SDK" refleja mejor sus capacidades:
Si encuentras problemas durante la migración:
Para TypeScript/JavaScript:
@anthropic-ai/claude-agent-sdknpm install para asegurar que las dependencias se actualicenPara Python:
claude_agent_sdkpip install claude-agent-sdk para asegurar que el paquete esté instalado