CLI, SDKs y bibliotecasCLI ant

Scripting y automatización con la CLI

Controla versiones de recursos de la API como YAML, encadena comandos de la CLI ant en scripts y opera sobre recursos desde Claude Code.

Esta página cubre flujos de trabajo orientados a tareas construidos sobre la CLI ant. Para conocer los flags subyacentes y las opciones de salida, consulta Uso de la CLI.

Control de versiones de recursos de la API

Puedes usar la CLI para controlar versiones de recursos de la API como skills, agentes, entornos o despliegues en forma de archivos YAML en tu repositorio y mantenerlos sincronizados con la API de Claude.

Para obtener más información sobre estos recursos, consulta Agentes gestionados.

Define tu agente

Escribe la definición del agente en summarizer.agent.yaml:

summarizer.agent.yaml

name: Summarizer
model: claude-sonnet-4-6
system: |
  You are a helpful assistant that writes concise summaries.
tools:
  - type: agent_toolset_20260401

Crea el agente
ant beta:agents create < summarizer.agent.yaml
Output
{ "id": "agent_011CYm1BLqPXpQRk5khsSXrs", "version": 1, "name": "Summarizer", "model": "claude-sonnet-4-6" /* ... */ }
Toma nota del id de la respuesta. Lo pasarás al comando de creación de sesión en un paso posterior.
Agrega summarizer.agent.yaml a tu repositorio y mantenlo sincronizado con la API en tu pipeline de CI. El comando de actualización necesita el ID del agente y la versión actual como flags:
CLI
ant beta:agents update --agent-id agent_011CYm1BLqPXpQRk5khsSXrs --version 1 < summarizer.agent.yaml
Define el entorno
Una sesión se ejecuta en un entorno, que define el sandbox en el que se ejecuta. Escribe la definición del entorno en summarizer.environment.yaml:
summarizer.environment.yaml
name: summarizer-env config: type: cloud networking: type: unrestricted
Crea el entorno
ant beta:environments create < summarizer.environment.yaml
Output
{ "id": "env_01595EKxaaTTGwwY3kyXdtbs", "name": "summarizer-env" /* ... */ }
Toma nota del id de la respuesta. Lo pasarás al comando de creación de sesión en un paso posterior.
Agrega summarizer.environment.yaml a tu repositorio y mantenlo sincronizado con la API en tu pipeline de CI. El comando de actualización necesita el ID del entorno como flag:
CLI
ant beta:environments update --environment-id env_01595EKxaaTTGwwY3kyXdtbs < summarizer.environment.yaml

Inicia una sesión

Pega el id del agente y el id del entorno de las salidas anteriores en el comando de creación de sesión:

ant beta:sessions create \
  --agent agent_011CYm1BLqPXpQRk5khsSXrs \
  --environment-id env_01595EKxaaTTGwwY3kyXdtbs \
  --title "Summarization task"

Output

{
  "id": "session_01JZCh78XvmxJjiXVy3oSi7K",
  "status": "running"
  /* ... */
}

Envía un mensaje de usuario

Copia el id de la sesión de la salida anterior en --session-id:

ant beta:sessions:events send \
  --session-id session_01JZCh78XvmxJjiXVy3oSi7K \
  --event '{type: user.message, content: [{type: text, text: "Summarize the benefits of type safety in one sentence."}]}'

Lee la conversación
--transform se ejecuta sobre cada evento listado, por lo que esto imprime el texto de cada mensaje en orden. --format auto anula el explorador interactivo que los comandos de listado abren de forma predeterminada en una terminal:
ant beta:sessions:events list \ --session-id session_01JZCh78XvmxJjiXVy3oSi7K \ --transform 'content.0.text' --format auto --raw-output
Output
```
Summarize the benefits of type safety in one sentence.
Type safety catches errors at compile time rather than runtime, reducing bugs, improving code clarity, enabling better tooling support, and making codebases easier to maintain and refactor with confidence.
```
Para observar una sesión mientras se ejecuta, usa ant beta:sessions:events stream --session-id session_01JZCh78XvmxJjiXVy3oSi7K. Los eventos se escriben en stdout a medida que llegan.

Patrones de scripting

La CLI está diseñada para componerse con herramientas estándar de shell.

Encadenar la salida de un listado a un segundo comando

--transform id --raw-output en un endpoint de listado emite un ID sin formato por línea, por lo que herramientas estándar como head y xargs se aplican directamente. Captura el primer resultado y luego pásalo a un comando posterior:

FIRST_AGENT=$(ant beta:agents list \
  --transform id --raw-output | head -1)

ant beta:agents:versions list \
  --agent-id "$FIRST_AGENT" \
  --transform "{version,created_at}" --format jsonl

Inspeccionar errores

Los flags --transform-error y --format-error aplican el mismo filtrado a las respuestas de error. --raw-output no se aplica a los errores, así que usa --format-error yaml para obtener un escalar sin comillas. Extrae solo el mensaje de error:

ant beta:agents retrieve --agent-id bogus \
  --transform-error error.message --format-error yaml 2>&1

Output

GET "https://api.anthropic.com/v1/agents/bogus?beta=true": 404 Not Found
Agent not found.

Usar la CLI desde Claude Code

Claude Code puede usar la CLI ant de forma nativa. Con la CLI instalada y autenticada, puedes pedirle a Claude Code que opere directamente sobre tus recursos de la API. Por ejemplo:

"Lista mis sesiones de agente recientes y resume cuáles tuvieron errores."
"Sube cada PDF en ./reports a la API de Files e imprime los IDs resultantes."
"Obtén los eventos de la sesión session_01... y dime dónde se atascó el agente."

Claude Code ejecuta ant en el shell, analiza la salida estructurada y razona sobre los resultados (no se requiere código de integración personalizado).

Was this page helpful?

CLI, SDKs y bibliotecasCLI ant

Scripting y automatización con la CLI

Controla versiones de recursos de la API como YAML, encadena comandos de la CLI ant en scripts y opera sobre recursos desde Claude Code.

Esta página cubre flujos de trabajo orientados a tareas construidos sobre la CLI ant. Para conocer los flags subyacentes y las opciones de salida, consulta Uso de la CLI.

Control de versiones de recursos de la API

Para obtener más información sobre estos recursos, consulta Agentes gestionados.

Define tu agente

Escribe la definición del agente en summarizer.agent.yaml:

summarizer.agent.yaml

name: Summarizer
model: claude-sonnet-4-6
system: |
  You are a helpful assistant that writes concise summaries.
tools:
  - type: agent_toolset_20260401

Crea el agente
ant beta:agents create < summarizer.agent.yaml
Output
{ "id": "agent_011CYm1BLqPXpQRk5khsSXrs", "version": 1, "name": "Summarizer", "model": "claude-sonnet-4-6" /* ... */ }
Toma nota del id de la respuesta. Lo pasarás al comando de creación de sesión en un paso posterior.
Agrega summarizer.agent.yaml a tu repositorio y mantenlo sincronizado con la API en tu pipeline de CI. El comando de actualización necesita el ID del agente y la versión actual como flags:
CLI
ant beta:agents update --agent-id agent_011CYm1BLqPXpQRk5khsSXrs --version 1 < summarizer.agent.yaml
Define el entorno
Una sesión se ejecuta en un entorno, que define el sandbox en el que se ejecuta. Escribe la definición del entorno en summarizer.environment.yaml:
summarizer.environment.yaml
name: summarizer-env config: type: cloud networking: type: unrestricted
Crea el entorno
ant beta:environments create < summarizer.environment.yaml
Output
{ "id": "env_01595EKxaaTTGwwY3kyXdtbs", "name": "summarizer-env" /* ... */ }
Toma nota del id de la respuesta. Lo pasarás al comando de creación de sesión en un paso posterior.
Agrega summarizer.environment.yaml a tu repositorio y mantenlo sincronizado con la API en tu pipeline de CI. El comando de actualización necesita el ID del entorno como flag:
CLI
ant beta:environments update --environment-id env_01595EKxaaTTGwwY3kyXdtbs < summarizer.environment.yaml

Inicia una sesión

Pega el id del agente y el id del entorno de las salidas anteriores en el comando de creación de sesión:

ant beta:sessions create \
  --agent agent_011CYm1BLqPXpQRk5khsSXrs \
  --environment-id env_01595EKxaaTTGwwY3kyXdtbs \
  --title "Summarization task"

Output

{
  "id": "session_01JZCh78XvmxJjiXVy3oSi7K",
  "status": "running"
  /* ... */
}

Envía un mensaje de usuario

Copia el id de la sesión de la salida anterior en --session-id:

ant beta:sessions:events send \
  --session-id session_01JZCh78XvmxJjiXVy3oSi7K \
  --event '{type: user.message, content: [{type: text, text: "Summarize the benefits of type safety in one sentence."}]}'

Lee la conversación
--transform se ejecuta sobre cada evento listado, por lo que esto imprime el texto de cada mensaje en orden. --format auto anula el explorador interactivo que los comandos de listado abren de forma predeterminada en una terminal:
ant beta:sessions:events list \ --session-id session_01JZCh78XvmxJjiXVy3oSi7K \ --transform 'content.0.text' --format auto --raw-output
Output
```
Summarize the benefits of type safety in one sentence.
Type safety catches errors at compile time rather than runtime, reducing bugs, improving code clarity, enabling better tooling support, and making codebases easier to maintain and refactor with confidence.
```
Para observar una sesión mientras se ejecuta, usa ant beta:sessions:events stream --session-id session_01JZCh78XvmxJjiXVy3oSi7K. Los eventos se escriben en stdout a medida que llegan.

Patrones de scripting

La CLI está diseñada para componerse con herramientas estándar de shell.

Encadenar la salida de un listado a un segundo comando

FIRST_AGENT=$(ant beta:agents list \
  --transform id --raw-output | head -1)

ant beta:agents:versions list \
  --agent-id "$FIRST_AGENT" \
  --transform "{version,created_at}" --format jsonl

Inspeccionar errores

ant beta:agents retrieve --agent-id bogus \
  --transform-error error.message --format-error yaml 2>&1

Output

GET "https://api.anthropic.com/v1/agents/bogus?beta=true": 404 Not Found
Agent not found.

Usar la CLI desde Claude Code

Claude Code puede usar la CLI ant de forma nativa. Con la CLI instalada y autenticada, puedes pedirle a Claude Code que opere directamente sobre tus recursos de la API. Por ejemplo:

"Lista mis sesiones de agente recientes y resume cuáles tuvieron errores."
"Sube cada PDF en ./reports a la API de Files e imprime los IDs resultantes."
"Obtén los eventos de la sesión session_01... y dime dónde se atascó el agente."

Claude Code ejecuta ant en el shell, analiza la salida estructurada y razona sobre los resultados (no se requiere código de integración personalizado).

Was this page helpful?