Início rápido da CLI

A CLI ant fornece acesso à API do Claude a partir do seu terminal. Cada recurso da API é exposto como um subcomando, com formatação de saída, filtragem de respostas e suporte para entrada de arquivos YAML ou JSON, o que a torna prática tanto para exploração interativa quanto para automação.

Em comparação com chamar a API usando curl, o ant permite que você construa corpos de requisição a partir de flags tipadas ou YAML via pipe em vez de JSON escrito manualmente, insira conteúdos de arquivos em campos de string com uma referência @path e extraia campos da resposta com uma consulta --transform integrada (sem necessidade de ferramentas JSON separadas). Endpoints de listagem paginam automaticamente. O Claude Code tem suporte nativo para ant.

Instalação

Verifique a instalação:

ant --version

Autenticação

ant auth login abre um fluxo OAuth baseado em navegador no Claude Console e armazena as credenciais resultantes localmente, para que você possa chamar a API sem criar ou gerenciar uma chave de API.

ant auth login

Envie sua primeira requisição

Com o binário instalado e autenticado, chame a 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 /*, ... */ }
}

A resposta é o objeto completo da API, formatado de forma legível porque stdout é um terminal.

Autocompletar do shell

A CLI inclui scripts de autocompletar para bash, zsh, fish e PowerShell. Gere e instale um para o seu shell:

Próximos passos

• Opções de autenticação da CLI: chaves de API, hosts headless, múltiplos workspaces e perfis nomeados
• Usando a CLI: estrutura de comandos, formatos de saída, transformações GJSON e corpos de requisição
• Scripting e automação com a CLI: controle de versão de recursos da API, padrões de scripting e uso a partir do Claude Code