Inicio rápido de la CLI

La CLI ant proporciona acceso a la API de Claude desde tu terminal. Cada recurso de la API se expone como un subcomando, con formato de salida, filtrado de respuestas y compatibilidad con entrada de archivos YAML o JSON, lo que la hace práctica tanto para la exploración interactiva como para la automatización.

En comparación con llamar a la API con curl, ant te permite construir cuerpos de solicitud a partir de flags tipados o YAML canalizado en lugar de JSON escrito a mano, insertar contenidos de archivos en campos de cadena con una referencia @path y extraer campos de la respuesta con una consulta --transform integrada (sin necesidad de herramientas JSON adicionales). Los endpoints de lista paginan automáticamente. Claude Code tiene compatibilidad nativa con ant.

Instalación

Verifica la instalación:

ant --version

Autenticación

ant auth login abre un flujo OAuth basado en navegador contra Claude Console y almacena las credenciales resultantes localmente, de modo que puedes llamar a la API sin crear ni gestionar una clave de API.

ant auth login

Envía tu primera solicitud

Con el binario instalado y autenticado, llama a la Messages API:

ant messages create \
  --model claude-opus-4-8 \
  --max-tokens 1024 \
  --message '{role: user, content: "Hello, Claude"}'

{
  "model": "claude-opus-4-8",
  "id": "msg_01YMmR5XodC5nTqMxLZMKaq6",
  "type": "message",
  "role": "assistant",
  "content": [
    {
      "type": "text",
      "text": "Hello! How are you doing today? Is there something I can help you with?"
    }
  ],
  "stop_reason": "end_turn",
  "usage": { "input_tokens": 27, "output_tokens": 20 /*, ... */ }
}

La respuesta es el objeto completo de la API, con formato legible porque stdout es una terminal.

Autocompletado de shell

La CLI incluye scripts de autocompletado para bash, zsh, fish y PowerShell. Genera e instala uno para tu shell:

Próximos pasos

• Opciones de autenticación de la CLI: claves de API, hosts sin interfaz gráfica, múltiples workspaces y perfiles con nombre
• Uso de la CLI: estructura de comandos, formatos de salida, transformaciones GJSON y cuerpos de solicitud
• Scripting y automatización con la CLI: control de versiones de recursos de la API, patrones de scripting y uso desde Claude Code