Inicio › Claude Code › SDK de agentes
Descripción generalInstalaciónreferencia de la CLIPrecios y límitesAgent SDKHabilidades y pluginsGitHubWeb, escritorio e IDEModelosErrores¿Código abierto?TutorialPara estudiantesAutomatización de QAComparación con CursorComparación con Codex y OpenCodeSubagentesHooksMCPEcosistemaVS CodeOpenRouterLímites de solicitudesGuía en chino
Ú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

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 Ver planes ilimitados

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 completaCómo instalar Claude CodeDocumentación de la CLI de Claude Code: comandos y opcionesPrecios y límites de Claude Code, explicadosHabilidades y plugins de Claude CodeClaude Code en GitHub: la App, la Action y @claude¿Claude Code tiene una interfaz web? Explicación de las versiones web, de escritorio y para IDEQué modelo utiliza Claude Code y cómo cambiarloErrores de Claude Code y cómo solucionarlos¿Claude Code es de código abierto?Tutorial de Claude Code: tu primera sesión realClaude para estudiantes: Claude Code, la API y qué ofrece realmente el ámbito educativoCómo usar Claude Code para automatizar QAClaude Code frente a Cursor: cuál usar, cuándo y cómo ejecutar ambosClaude Code vs Codex vs OpenCode: comparativa de los agentes de terminalSubagentes de Claude Code: cómo funcionan, cómo definirlos y equipos de agentesHooks de Claude Code: control determinista sobre lo que hace el agenteMCP en Claude Code: conexión de servidores, ámbitos, MCP remoto y ejemplos realesEl ecosistema de Claude Code: enrutadores, frameworks, plugins y las listas que los recopilanClaude Code en VS Code: la extensión, el uso desde la terminal y los erroresCómo usar OpenRouter en Claude Code (y cuándo no hacerlo)Error de límite de solicitudes de Claude: qué significa «Error de API: se ha alcanzado el límite de solicitudes» y cómo solucionarloCómo usar Claude Code: desde la instalación hasta el uso diario