Inicio rápido

Configuración

Crear una carpeta de proyecto

Cree un nuevo directorio para este inicio rápido:

mkdir my-agent
cd my-agent

Para sus propios proyectos, puede ejecutar el SDK desde cualquier carpeta; tendrá acceso a los archivos en ese directorio y sus subdirectorios de forma predeterminada.

Instalar el SDK

Instale el paquete del SDK de Agent para su idioma:

TypeScript (nuevo proyecto)
TypeScript (proyecto existente)
Python (uv)
Python (pip)

npm init -y
npm pkg set type=module
npm install @anthropic-ai/claude-agent-sdk
npm install --save-dev tsx

Establecer "type": "module" en package.json permite que su script de agente use await de nivel superior, y tsx ejecuta archivos TypeScript directamente. npm imprime added N packages cuando la instalación se realiza correctamente.

npm install @anthropic-ai/claude-agent-sdk
npm install --save-dev tsx

tsx ejecuta archivos TypeScript directamente. Si su proyecto usa CommonJS, nombre su script de agente agent.mts en lugar de agent.ts. La extensión .mts hace que tsx trate el archivo como un módulo ES, por lo que await de nivel superior funciona sin convertir todo su proyecto a módulos ES. Use agent.mts en lugar de agent.ts en los pasos de creación y ejecución posteriores en este inicio rápido.

Instale uv, un gestor de paquetes de Python rápido que maneja automáticamente los entornos virtuales. Luego inicialice un proyecto y agregue el SDK:

uv init
uv add claude-agent-sdk

Cree y active un entorno virtual, luego instale el paquete.En macOS o Linux:

python3 -m venv .venv
source .venv/bin/activate
pip install claude-agent-sdk

En Windows:

Agent SDK

Crear agentes

Conceptos básicos

Entrada y salida

Amplía con herramientas

Personalizar comportamiento

Control y observabilidad

Despliegue

Referencias del SDK

Requisitos previos

Configuración

​Requisitos previos

​Configuración

Requisitos previos

Configuración