Framework · Anthropic
Claude Agent SDK de un vistazo
El SDK de Anthropic incorpora el harness de Claude Code, con herramientas de archivos y shell, permisos, hooks, subagentes y skills, en tu propio programa de Python o TypeScript. A diferencia del resto de esta lista, solo funciona con modelos Claude y su uso se rige por las Condiciones Comerciales de Anthropic.
Ideal para: Aplicaciones en las que Claude debe realizar tareas reales en un sistema de archivos, con permisos de herramientas que controlas.
Datos clave
- Mantenedor
- Anthropic
- Lenguajes
- Python, TypeScript
- Licencia
- Anthropic Commercial Terms
- Última versión
Python 0.2.163 / TypeScript 0.3.286· 30 de septiembre de 2026- Repositorio
- anthropics/claude-agent-sdk-python
- Opción alojada
- Claude Managed Agents
Inicio rápido
Instala el paquete, configura las credenciales y ejecuta el agente más sencillo de la documentación oficial. Los ID de modelo son los que usa la documentación y puede que no estén habilitados en tu cuenta.
Python
pip install claude-agent-sdkimport asyncio
from claude_agent_sdk import query, ClaudeAgentOptions
async def main():
async for message in query(
prompt="Find and fix the bug in auth.py",
options=ClaudeAgentOptions(allowed_tools=["Read", "Edit", "Bash"]),
):
print(message) # Claude reads the file, finds the bug, edits it
asyncio.run(main())TypeScript
npm install @anthropic-ai/claude-agent-sdkimport { query } from "@anthropic-ai/claude-agent-sdk";
for await (const message of query({
prompt: "Find and fix the bug in auth.ts",
options: { allowedTools: ["Read", "Edit", "Bash"] }
})) {
console.log(message); // Claude reads the file, finds the bug, edits it
}Funciones
| Cualquier modelo | No | Solo Claude, mediante Anthropic, Bedrock, Google Cloud o Foundry |
|---|---|---|
| Cliente MCP | Sí | Opción mcpServers; los plugins pueden incluir servidores MCP |
| Servidor MCP | Sin confirmar | |
| Multiagente | Sí | Los subagentes se encargan de subtareas concretas |
| Ejecuciones duraderas | Sin confirmar | Las sesiones se pueden reanudar o bifurcar; no hay motor de durabilidad |
| Aprobación humana | Sí | Los modos de permisos determinan qué herramientas requieren aprobación |
| Trazas | Sí | Exportación de OpenTelemetry; las trazas están en beta |
| Evaluaciones | No |
Cambios recientes
- Cambió de nombre desde Claude Code SDK; hay una guía de migración disponible.
- Ambos SDK ahora incluyen un binario nativo de Claude Code.
- Desde el 15 June 2026, el uso del SDK en planes de suscripción consume un crédito mensual independiente de Agent SDK.
- Las aplicaciones de terceros no pueden ofrecer el inicio de sesión con claude.ai sin la aprobación de Anthropic.