Inicio rápido de la CLI

La CLI ant proporciona acceso a la Claude API desde tu terminal. Cada recurso de la API se expone como un subcomando, con formato de salida, filtrado de respuestas y entrada de archivos YAML o JSON.

En comparación con curl, ant construye los cuerpos de las solicitudes a partir de flags tipados o YAML canalizado en lugar de JSON escrito a mano, e inserta el contenido de archivos en campos de cadena con una referencia @path. Extrae campos de la respuesta con una consulta --transform integrada, por lo que no necesitas una herramienta separada como jq, y pagina los endpoints de listado automáticamente.

Instalación

brew install anthropics/tap/ant

VERSION=1.42.0
OS=$(uname -s | tr '[:upper:]' '[:lower:]')
case $(uname -m) in
  x86_64) ARCH=amd64 ;;
  aarch64) ARCH=arm64 ;;
esac
curl -fsSL "https://github.com/anthropics/anthropic-cli/releases/download/v${VERSION}/ant_${VERSION}_${OS}_${ARCH}.tar.gz" \
  | sudo tar -xz -C /usr/local/bin ant

go install github.com/anthropics/anthropic-cli/cmd/ant@latest

export PATH="$PATH:$(go env GOPATH)/bin"

Verifica la instalación:

ant --version

Autenticación

ant auth login abre un flujo OAuth basado en navegador contra la Claude Console y almacena las credenciales resultantes localmente, de modo que puedes llamar a la API sin crear ni administrar una "API key" (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-5-5 \
  --max-tokens 1024 \
  --message '{role: user, content: "Hello, Claude"}'

{
  "model": "claude-opus-5-5",
  "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 del shell

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

ant @completion zsh > "${fpath[1]}/_ant"
# Reinicia tu shell o ejecuta: autoload -U compinit && compinit

ant @completion bash > /etc/bash_completion.d/ant

ant @completion fish > ~/.config/fish/completions/ant.fish

ant @completion powershell | Out-String | Invoke-Expression
# Para persistir entre sesiones:
# ant @completion powershell >> $PROFILE

Próximos pasos