Source: https://aiprimetech.io/es/claude-code/sdk/

[Inicio](/es/) › [Claude Code](/es/claude-code/) › SDK de agentes

[Descripción general](/es/claude-code/)[Instalación](/es/claude-code/install/)[referencia de la CLI](/es/claude-code/cli/)[Precios y límites](/es/claude-code/pricing/)[Agent SDK](/es/claude-code/sdk/)[Habilidades y plugins](/es/claude-code/skills/)[GitHub](/es/claude-code/github/)[Web, escritorio e IDE](/es/claude-code/web-and-desktop/)[Modelos](/es/claude-code/models/)[Errores](/es/claude-code/errors/)[¿Código abierto?](/es/claude-code/open-source/)[Tutorial](/es/claude-code/tutorial/)[Para estudiantes](/es/claude-code/for-students/)[Automatización de QA](/es/claude-code/qa-automation/)[Comparación con Cursor](/es/claude-code/vs-cursor/)[Comparación con Codex y OpenCode](/es/claude-code/vs-codex/)[Subagentes](/es/claude-code/subagents/)[Hooks](/es/claude-code/hooks/)[MCP](/es/claude-code/mcp/)[Ecosistema](/es/claude-code/ecosystem/)[VS Code](/es/claude-code/vscode/)[OpenRouter](/es/claude-code/openrouter/)[Límites de solicitudes](/es/claude-code/rate-limits/)[Guía en chino](/claude-code/zh/)

Última actualización: 11 de octubre de 2026

# El SDK de Claude Code, ahora Claude Agent SDK

El mismo ciclo de agente que se ejecuta en tu terminal está disponible como biblioteca. Anthropic cambió el nombre de Claude Code SDK a Claude Agent SDK cuando quedó claro que la gente lo usaba para crear mucho más que herramientas de programación.

## TLDR
- Python: pip install claude-agent-sdk; TypeScript: npm install @anthropic-ai/claude-agent-sdk.
- Obtienes el agente completo —herramientas de archivos, bash, subagentes y MCP— controlado desde código, con callbacks de permisos.
- El SDK lee ANTHROPIC_BASE_URL y ANTHROPIC_API_KEY igual que la CLI, por lo que se aplica la facturación de la pasarela.

## Dos formas de automatizar Claude Code 

La opción más ligera es el modo de impresión de la CLI — claude -p desde cualquier lenguaje, con salida en JSON. La opción completa es el Agent SDK, que expone el bucle, el conjunto de herramientas, los hooks y los permisos como objetos que controlas. 

## Python 

```
import anyio
from claude_agent_sdk import query, ClaudeAgentOptions

async def main():
    options = ClaudeAgentOptions(
        allowed_tools=["Read", "Edit", "Bash"],
        max_turns=8,
    )
    async for message in query(
        prompt="add type hints to utils.py and run the tests",
        options=options,
    ):
        print(message)

anyio.run(main)
```

## TypeScript 

```
import { query } from "@anthropic-ai/claude-agent-sdk";

for await (const message of query({
  prompt: "find and fix the flaky test in this repo",
  options: { allowedTools: ["Read", "Edit", "Bash"], maxTurns: 8 },
})) {
  console.log(message);
}
```

## Ejecución a través de la pasarela 

```
export ANTHROPIC_BASE_URL=https://aiprimetech.io
export ANTHROPIC_API_KEY=your_gateway_key
python agent.py
```

El SDK inicia el mismo entorno de ejecución de Claude Code, por lo que solo necesita las variables de entorno. Los agentes de larga duración son donde más importa el precio de la pasarela: un bucle autónomo puede realizar cientos de llamadas por hora, y un plan de tarifa plana convierte esa estimación de costes en una cifra fija. 

## Qué añade el SDK al modo de impresión 
- Callbacks de permisos: aprueba o rechaza cada llamada a una herramienta desde tu propio código.
- Herramientas personalizadas mediante servidores MCP dentro del proceso, para que el agente pueda llamar a tus funciones.
- Hooks para eventos de herramientas, el ciclo de vida de las sesiones y errores.
- Subagentes y salida estructurada, sin ejecutar comandos externos ni analizar texto.

## Pruébalo gratis primero

Las cuentas nuevas reciben $5 de crédito gratuito para la API con el código CLAUDECODE — suficiente para una tarde de Claude Code con Sonnet — y después créditos por 7.69231× su valor nominal.

```
export ANTHROPIC_BASE_URL=https://aiprimetech.io
export ANTHROPIC_API_KEY=your_key
```

[Crea una cuenta con el código CLAUDECODE](/register?promo=CLAUDECODE)

## Preguntas frecuentes

¿Es el Claude Code SDK lo mismo que el SDK de Anthropic?

No. El SDK de Anthropic llama directamente a la API de Messages. El Claude Agent SDK (antes Claude Code SDK) ejecuta el agente completo —herramientas, archivos, bash y subagentes— sobre ella.¿Qué lenguajes admite el Agent SDK?

Python y TypeScript oficialmente; cualquier otro puede controlar el modo de impresión de la CLI con salida en JSON.¿Funciona el SDK con una URL base personalizada?

Sí. Hereda ANTHROPIC_BASE_URL y ANTHROPIC_API_KEY del entorno, exactamente igual que la CLI.

## Ejecuta Claude Code con la pasarela

Los mismos modelos, dos variables de entorno y créditos por 7.69231× su valor nominal, o un plan ilimitado de tarifa plana. Cuentas nuevas: $5 de crédito gratuito para la API con el código CLAUDECODE.[Obtener una clave de API](/register?promo=CLAUDECODE) [Ver planes ilimitados](/es/plans/)

AI Prime Tech es una pasarela API independiente y no está afiliada a Anthropic, ni cuenta con su respaldo o patrocinio. «Claude» y «Claude Code» son marcas comerciales de Anthropic. Las funciones de Claude Code descritas aquí se basan en la documentación pública de Anthropic en el momento de la redacción y cambian con frecuencia; los precios y las listas de modelos de esta página se obtienen de la configuración actual de esta pasarela.

## Más guías de Claude Code

[Claude Code: la guía completa](/es/claude-code/)[Cómo instalar Claude Code](/es/claude-code/install/)[Documentación de la CLI de Claude Code: comandos y opciones](/es/claude-code/cli/)[Precios y límites de Claude Code, explicados](/es/claude-code/pricing/)[Habilidades y plugins de Claude Code](/es/claude-code/skills/)[Claude Code en GitHub: la App, la Action y @claude](/es/claude-code/github/)[¿Claude Code tiene una interfaz web? Explicación de las versiones web, de escritorio y para IDE](/es/claude-code/web-and-desktop/)[Qué modelo utiliza Claude Code y cómo cambiarlo](/es/claude-code/models/)[Errores de Claude Code y cómo solucionarlos](/es/claude-code/errors/)[¿Claude Code es de código abierto?](/es/claude-code/open-source/)[Tutorial de Claude Code: tu primera sesión real](/es/claude-code/tutorial/)[Claude para estudiantes: Claude Code, la API y qué ofrece realmente el ámbito educativo](/es/claude-code/for-students/)[Cómo usar Claude Code para automatizar QA](/es/claude-code/qa-automation/)[Claude Code frente a Cursor: cuál usar, cuándo y cómo ejecutar ambos](/es/claude-code/vs-cursor/)[Claude Code vs Codex vs OpenCode: comparativa de los agentes de terminal](/es/claude-code/vs-codex/)[Subagentes de Claude Code: cómo funcionan, cómo definirlos y equipos de agentes](/es/claude-code/subagents/)[Hooks de Claude Code: control determinista sobre lo que hace el agente](/es/claude-code/hooks/)[MCP en Claude Code: conexión de servidores, ámbitos, MCP remoto y ejemplos reales](/es/claude-code/mcp/)[El ecosistema de Claude Code: enrutadores, frameworks, plugins y las listas que los recopilan](/es/claude-code/ecosystem/)[Claude Code en VS Code: la extensión, el uso desde la terminal y los errores](/es/claude-code/vscode/)[Cómo usar OpenRouter en Claude Code (y cuándo no hacerlo)](/es/claude-code/openrouter/)[Error de límite de solicitudes de Claude: qué significa «Error de API: se ha alcanzado el límite de solicitudes» y cómo solucionarlo](/es/claude-code/rate-limits/)[Cómo usar Claude Code: desde la instalación hasta el uso diario](/claude-code/zh/)