Repolode
Enviar
anthropics

anthropics/claude-agent-sdk-python

SDK de Python para crear agentes sobre Claude Code, con query(), un cliente interactivo, herramientas personalizadas en proceso y hooks.

Ver en GitHub
Estrellas
8,304
Forks
1,363
Issues abiertos
571
Último commit
ayer

¿Qué es?

Claude Agent SDK para Python permite que las aplicaciones Python controlen Claude Code mediante programación. Instálalo con pip y llama a query() para enviar un prompt y recorrer los mensajes de respuesta transmitidos en streaming, o usa ClaudeSDKClient para mantener conversaciones bidireccionales de varios turnos.

El paquete incluye Claude Code CLI, por lo que, de forma predeterminada, no es necesario instalarlo por separado, aunque se puede configurar una instalación global o una ruta específica a la CLI. De forma predeterminada, Claude tiene acceso a todo el conjunto de herramientas de Claude Code, como Read, Write, Edit y Bash; allowed_tools, disallowed_tools y permission_mode controlan las aprobaciones.

Con ClaudeSDKClient puedes definir herramientas personalizadas como funciones de Python que se ejecutan como servidores MCP en proceso, y registrar hooks que se ejecutan en distintos puntos del ciclo del agente, por ejemplo, para bloquear un comando de Bash antes de que se ejecute. Se proporcionan opciones tipadas, clases de mensajes y clases de errores para gestionar los resultados.

Funciones clave

  • 01Transmitir en streaming las respuestas de Claude Code desde una función asíncrona query().
  • 02Ejecutar sesiones interactivas de varios turnos con ClaudeSDKClient.
  • 03Definir herramientas personalizadas como servidores MCP en proceso mediante un decorador de Python.
  • 04Registrar hooks de Python que se ejecutan en distintos puntos del ciclo del agente.
  • 05Controlar los permisos de las herramientas con listas de herramientas permitidas y no permitidas, y modos de permisos.

Casos de uso

  • Integrar un agente de programación de Claude en una aplicación Python o una herramienta interna.
  • Añadir funciones de Python específicas del dominio como herramientas que Claude pueda invocar.
  • Aplicar políticas, como bloquear determinados comandos de shell con hooks.
  • Crear flujos de trabajo automatizados que ejecuten Claude Code en un directorio de proyecto.

Inicio rápido

  1. 1

    Instala el SDK desde PyPI

    pip install claude-agent-sdk
  2. 2

    Guarda el código de inicio rápido del README en un archivo Python y ejecútalo con anyio

Antes de usarlo

  • El uso se rige por las Commercial Terms of Service de Anthropic, no solo por la licencia MIT.
  • Se requiere Python 3.10 o posterior.
  • Para consultar a Claude, necesitas acceso al servicio de Anthropic y credenciales.

Temas

#ai#agent#llm#claude#python-sdk#mcp#anthropic

Preguntas frecuentes

¿Qué es claude-agent-sdk-python?
SDK de Python para crear agentes sobre Claude Code, con query(), un cliente interactivo, herramientas personalizadas en proceso y hooks. Claude Agent SDK para Python permite que las aplicaciones Python controlen Claude Code mediante programación. Instálalo con pip y llama a query() para enviar un prompt y recorrer los mensajes de respuesta transmitidos en streaming, o usa ClaudeSDKClient para mantener conversaciones bidireccionales de varios turnos.
¿claude-agent-sdk-python es gratuito? ¿Qué licencia tiene?
claude-agent-sdk-python es open source bajo la licencia MIT. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿claude-agent-sdk-python sigue mantenido?
Mantenimiento activo. El último commit de claude-agent-sdk-python fue el 19 oct 2026.
¿Para qué puedo usar claude-agent-sdk-python?
Integrar un agente de programación de Claude en una aplicación Python o una herramienta interna. Añadir funciones de Python específicas del dominio como herramientas que Claude pueda invocar. Aplicar políticas, como bloquear determinados comandos de shell con hooks. Crear flujos de trabajo automatizados que ejecuten Claude Code en un directorio de proyecto.
¿Cómo se instala claude-agent-sdk-python?
Instala el SDK desde PyPI: pip install claude-agent-sdk Guarda el código de inicio rápido del README en un archivo Python y ejecútalo con anyio
¿Dónde consigo claude-agent-sdk-python?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/anthropics/claude-agent-sdk-python

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados