---
title: Início rápido da CLI
url: https://platform.claude.com/docs/pt-BR/cli-sdks-libraries/cli/quickstart
description: Instale a ferramenta de linha de comando ant, autentique-se e envie sua primeira requisição para a Claude API.
---

A CLI `ant` fornece acesso à Claude API a partir do seu terminal. Cada recurso da API é exposto como um subcomando, com formatação de saída, filtragem de respostas e entrada de arquivos YAML ou JSON.

<Frame caption="A CLI ant em ação.">
  <video aria-label="Gravação de tela da CLI ant sendo executada em um terminal.">
    <source src="https://platform.claude.com/docs/videos/ant-cli-demo.webm" type="video/webm" />
    <source src="https://platform.claude.com/docs/videos/ant-cli-demo.mp4" type="video/mp4" />
  </video>
</Frame>

Em comparação com o `curl`, o `ant` constrói corpos de requisição a partir de flags tipadas ou YAML via pipe em vez de JSON escrito à mão, e insere o conteúdo de arquivos em campos de string com uma referência `@path`. Ele extrai campos da resposta com uma consulta `--transform` integrada, de modo que você não precisa de uma ferramenta separada como o `jq`, e pagina endpoints de listagem automaticamente.

<Info>
  Para parâmetros específicos de cada endpoint e esquemas de resposta, consulte a [referência da API](https://platform.claude.com/docs/pt-BR/api/cli/messages/create). Esta página leva você a um comando funcional. Para tudo o mais que a CLI faz, consulte [Usando a CLI](https://platform.claude.com/docs/pt-BR/cli-sdks-libraries/cli/using) e [Scripts e automação com a CLI](https://platform.claude.com/docs/pt-BR/cli-sdks-libraries/cli/scripting).
</Info>

## Instalação

<Tabs>
  <Tab title="Homebrew (macOS)">
    ```bash
    brew install anthropics/tap/ant
    ```
  </Tab>

  <Tab title="curl (Linux/WSL)">
    Para ambientes Linux, baixe o binário da release diretamente.

    ```bash
    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
    ```

    Você pode encontrar todas as releases na [página de releases do GitHub](https://github.com/anthropics/anthropic-cli/releases).
  </Tab>

  <Tab title="Go">
    Você também pode instalar a CLI a partir do código-fonte usando `go install`. Requer Go 1.25 ou posterior.

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

    O binário é colocado em `$(go env GOPATH)/bin`. Adicione-o ao seu `PATH` se ainda não estiver:

    ```bash
    export PATH="$PATH:$(go env GOPATH)/bin"
    ```
  </Tab>
</Tabs>

Verifique a instalação:

```bash
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 "API key" (chave de API).

```bash CLI
ant auth login
```

<Note>
  Para outras formas de autenticação (variável de ambiente de chave de API, hosts headless, múltiplos workspaces, perfis nomeados e Workload Identity Federation), consulte [Opções de autenticação da CLI](https://platform.claude.com/docs/pt-BR/cli-sdks-libraries/cli/authentication).
</Note>

## Envie sua primeira requisição

Com o binário instalado e autenticado, chame a [Messages API](https://platform.claude.com/docs/pt-BR/api/cli/messages/create):

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

```text Output wrap
{
  "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 /*, ... */ }
}
```

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

## Autocompletar no shell

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

<Tabs>
  <Tab title="zsh">
    ```bash
    ant @completion zsh > "${fpath[1]}/_ant"
    # Reinicie seu shell ou execute: autoload -U compinit && compinit
    ```
  </Tab>

  <Tab title="bash">
    ```bash
    ant @completion bash > /etc/bash_completion.d/ant
    ```
  </Tab>

  <Tab title="fish">
    ```bash
    ant @completion fish > ~/.config/fish/completions/ant.fish
    ```
  </Tab>

  <Tab title="PowerShell">
    ```powershell
    ant @completion powershell | Out-String | Invoke-Expression
    # Para persistir entre sessões:
    # ant @completion powershell >> $PROFILE
    ```
  </Tab>
</Tabs>

## Próximos passos

<CardGroup cols={3}>
  <Card title="Opções de autenticação da CLI" icon="lock" href="https://platform.claude.com/docs/pt-BR/cli-sdks-libraries/cli/authentication">
    Chaves de API, hosts headless, múltiplos workspaces e perfis nomeados
  </Card>

  <Card title="Usando a CLI" icon="terminal" href="https://platform.claude.com/docs/pt-BR/cli-sdks-libraries/cli/using">
    Estrutura de comandos, formatos de saída, transformações GJSON e corpos de requisição
  </Card>

  <Card title="Scripts e automação com a CLI" icon="code" href="https://platform.claude.com/docs/pt-BR/cli-sdks-libraries/cli/scripting">
    Controle de versão de recursos da API, padrões de scripting e uso a partir do Claude Code
  </Card>
</CardGroup>