---
title: Inicio rápido de la CLI
url: https://platform.claude.com/docs/es/cli-sdks-libraries/cli/quickstart
description: Instala la herramienta de línea de comandos ant, autentícate y envía tu primera solicitud a la Claude API.
---

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.

<Frame caption="La CLI ant en acción.">
  <video aria-label="Grabación de pantalla de la CLI ant ejecutándose en una 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>

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.

<Info>
  Para los parámetros específicos de cada endpoint y los esquemas de respuesta, consulta la [referencia de la API](https://platform.claude.com/docs/es/api/cli/messages/create). Esta página te lleva a un comando funcional. Para todo lo demás que hace la CLI, consulta [Uso de la CLI](https://platform.claude.com/docs/es/cli-sdks-libraries/cli/using) y [Scripting y automatización con la CLI](https://platform.claude.com/docs/es/cli-sdks-libraries/cli/scripting).
</Info>

## Instalación

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

  <Tab title="curl (Linux/WSL)">
    Para entornos Linux, descarga el binario de la versión directamente.

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

    Puedes encontrar todas las versiones en la [página de releases de GitHub](https://github.com/anthropics/anthropic-cli/releases).
  </Tab>

  <Tab title="Go">
    También puedes instalar la CLI desde el código fuente usando `go install`. Requiere Go 1.25 o posterior.

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

    El binario se coloca en `$(go env GOPATH)/bin`. Agrégalo a tu `PATH` si aún no lo está:

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

Verifica la instalación:

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

```bash CLI
ant auth login
```

<Note>
  Para otras formas de autenticarte (variable de entorno de clave de API, hosts sin interfaz gráfica, múltiples espacios de trabajo, perfiles con nombre y Workload Identity Federation), consulta [Opciones de autenticación de la CLI](https://platform.claude.com/docs/es/cli-sdks-libraries/cli/authentication).
</Note>

## Envía tu primera solicitud

Con el binario instalado y autenticado, llama a la [Messages API](https://platform.claude.com/docs/es/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 /*, ... */ }
}
```

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:

<Tabs>
  <Tab title="zsh">
    ```bash
    ant @completion zsh > "${fpath[1]}/_ant"
    # Reinicia tu shell o ejecuta: 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 sesiones:
    # ant @completion powershell >> $PROFILE
    ```
  </Tab>
</Tabs>

## Próximos pasos

<CardGroup cols={3}>
  <Card title="Opciones de autenticación de la CLI" icon="lock" href="https://platform.claude.com/docs/es/cli-sdks-libraries/cli/authentication">
    Claves de API, hosts sin interfaz gráfica, múltiples espacios de trabajo y perfiles con nombre
  </Card>

  <Card title="Uso de la CLI" icon="terminal" href="https://platform.claude.com/docs/es/cli-sdks-libraries/cli/using">
    Estructura de comandos, formatos de salida, transformaciones GJSON y cuerpos de solicitud
  </Card>

  <Card title="Scripting y automatización con la CLI" icon="code" href="https://platform.claude.com/docs/es/cli-sdks-libraries/cli/scripting">
    Controla versiones de recursos de la API, patrones de scripting y uso desde Claude Code
  </Card>
</CardGroup>
