---
title: Démarrage rapide de la CLI
url: https://platform.claude.com/docs/fr/cli-sdks-libraries/cli/quickstart
description: Installez l'outil en ligne de commande ant, authentifiez-vous et envoyez votre première requête à l'API Claude.
---

La CLI `ant` donne accès à l'API Claude depuis votre terminal. Chaque ressource de l'API est exposée sous forme de sous-commande, avec formatage de la sortie, filtrage des réponses et saisie de fichiers YAML ou JSON.

<Frame caption="La CLI ant en action.">
  <video aria-label="Enregistrement d'écran de la CLI ant exécutée dans un 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>

Par rapport à `curl`, `ant` construit les corps de requête à partir d'options typées ou de YAML transmis par pipe plutôt qu'à partir de JSON écrit à la main, et insère le contenu des fichiers dans les champs de type chaîne grâce à une référence `@path`. Il extrait les champs de réponse avec une requête `--transform` intégrée, de sorte que vous n'avez pas besoin d'un outil distinct tel que `jq`, et il pagine automatiquement les points de terminaison de liste.

<Info>
  Pour les paramètres propres à chaque point de terminaison et les schémas de réponse, consultez la [référence de l'API](https://platform.claude.com/docs/fr/api/cli/messages/create). Cette page vous amène à une commande fonctionnelle. Pour tout ce que la CLI fait d'autre, consultez [Utilisation de la CLI](https://platform.claude.com/docs/fr/cli-sdks-libraries/cli/using) et [Scripts et automatisation avec la CLI](https://platform.claude.com/docs/fr/cli-sdks-libraries/cli/scripting).
</Info>

## Installation

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

  <Tab title="curl (Linux/WSL)">
    Pour les environnements Linux, téléchargez directement le binaire de la version publiée.

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

    Vous trouverez toutes les versions sur la [page des versions GitHub](https://github.com/anthropics/anthropic-cli/releases).
  </Tab>

  <Tab title="Go">
    Vous pouvez également installer la CLI à partir des sources avec `go install`. Nécessite Go 1.25 ou une version ultérieure.

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

    Le binaire est placé dans `$(go env GOPATH)/bin`. Ajoutez-le à votre `PATH` si ce n'est pas déjà fait :

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

Vérifiez l'installation :

```bash
ant --version
```

## Authentification

`ant auth login` ouvre un flux OAuth dans le navigateur auprès de la Claude Console et stocke localement les identifiants obtenus, ce qui vous permet d'appeler l'API sans créer ni gérer de « API key » (clé API).

```bash CLI
ant auth login
```

<Note>
  Pour les autres méthodes d'authentification (variable d'environnement de clé API, hôtes sans interface, espaces de travail multiples, profils nommés et Workload Identity Federation), consultez [Options d'authentification de la CLI](https://platform.claude.com/docs/fr/cli-sdks-libraries/cli/authentication).
</Note>

## Envoyer votre première requête

Une fois le binaire installé et authentifié, appelez l'[API Messages](https://platform.claude.com/docs/fr/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 réponse est l'objet API complet, mis en forme lisiblement car stdout est un terminal.

## Complétion du shell

La CLI fournit des scripts de complétion pour bash, zsh, fish et PowerShell. Générez et installez celui qui correspond à votre shell :

<Tabs>
  <Tab title="zsh">
    ```bash
    ant @completion zsh > "${fpath[1]}/_ant"
    # Redémarrez votre shell ou exécutez : 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
    # Pour conserver entre les sessions :
    # ant @completion powershell >> $PROFILE
    ```
  </Tab>
</Tabs>

## Étapes suivantes

<CardGroup cols={3}>
  <Card title="Options d'authentification de la CLI" icon="lock" href="https://platform.claude.com/docs/fr/cli-sdks-libraries/cli/authentication">
    Clés API, hôtes sans interface, espaces de travail multiples et profils nommés
  </Card>

  <Card title="Utilisation de la CLI" icon="terminal" href="https://platform.claude.com/docs/fr/cli-sdks-libraries/cli/using">
    Structure des commandes, formats de sortie, transformations GJSON et corps de requête
  </Card>

  <Card title="Scripts et automatisation avec la CLI" icon="code" href="https://platform.claude.com/docs/fr/cli-sdks-libraries/cli/scripting">
    Gestion de versions des ressources de l'API, modèles de scripts et utilisation depuis Claude Code
  </Card>
</CardGroup>
