Claude Platform Docs

Scripting y automatización con la CLI

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

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 como archivos YAML en tu repositorio y mantenerlos sincronizados con la Claude API.

  1. Define tu agente

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

    summarizer.agent.yaml
    name: Summarizer
model: claude-opus-5
system: |
  You are a helpful assistant that writes concise summaries.
tools:
  - type: agent_toolset_20260401

  2. Crea el agente

    ant beta:agents create < summarizer.agent.yaml
    Output
    {
  "id": "agent_011CYm1BLqPXpQRk5khsSXrs",
  "version": 1,
  "name": "Summarizer",
  "model": "claude-opus-5"
  /* ... */
}

    Toma nota del id de la respuesta. Lo pasarás al comando de creación de sesión en un paso posterior.

  3. 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

  4. 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.

  5. 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"
  /* ... */
}

  6. 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."}]}'

  7. 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 por defecto 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.

Patrones de scripting

La CLI está diseñada para combinarse con las herramientas estándar del 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 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

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
Output
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 sin configuración adicional. 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 quedó atascado el agente."

Claude Code invoca ant desde el shell, analiza la salida estructurada y razona sobre los resultados (no se requiere 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 "API key" (clave de API) estática. El token de acceso OAuth va en el encabezado Authorization como bearer token; 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á vencido o próximo a vencer:

cURL
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 espacio de trabajo has iniciado sesión; te advierte cuando una variable de entorno está anulando tu inicio de sesión.

Was this page helpful?