Scripting y automatización con la CLI

Esta página cubre flujos de trabajo orientados a tareas construidos sobre la CLI ant. Para los flags y opciones de salida subyacentes, 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 como archivos YAML en tu repositorio y mantenerlos sincronizados con la API de Claude.



Patrones de scripting

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



Encadena la salida de un listado en 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 de seguimiento:

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



Inspecciona 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

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



Usa la CLI desde Claude Code

Claude Code puede usar la CLI ant de forma inmediata. 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 Files API 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 invoca ant desde el shell, analiza la salida estructurada y razona sobre los resultados (sin necesidad de código de integración personalizado).



Autentica solicitudes curl con credenciales de la CLI

Los scripts que llaman a la API con curl u otro cliente HTTP pueden usar las credenciales almacenadas por ant auth login en lugar de una clave de API estática. El token de acceso OAuth va en el encabezado Authorization como un token bearer; el encabezado x-api-key es solo para claves de API estáticas.

ant auth print-credentials --access-token imprime el token de acceso del perfil activo, actualizándolo primero si está expirado o cerca de expirar:

curl https://api.anthropic.com/v1/messages \
  -H "Authorization: Bearer $(ant auth print-credentials --access-token)" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-opus-5",
    "max_tokens": 256,
    "messages": [{"role": "user", "content": "hi"}]
  }'

Ejecuta ant auth status para confirmar en qué organización y workspace has iniciado sesión; te advierte cuando una variable de entorno está anulando tu inicio de sesión.