---
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 le formatage de la sortie, le filtrage des réponses et la saisie de fichiers YAML ou JSON.

<Frame caption="La CLI ant en action.">
  <video aria-label="Enregistrement d'écran de la CLI ant s'exécutant 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 de flags typés ou de YAML transmis par pipe au lieu de JSON écrit à la main, et intègre le contenu de fichiers dans des champs de type chaîne grâce à une référence `@path`. Il extrait les champs de la 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 endpoints de liste.

<Info>
  Pour les paramètres propres à chaque endpoint 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 permet d'obtenir une commande fonctionnelle. Pour tout ce que la CLI peut faire d'autre, consultez [Utiliser 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.

    ```bash
    VERSION=2.3.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/v2/cmd/ant@latest
    ```

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

    ```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, afin que vous puissiez appeler l'API sans créer ni gérer de 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 complet de l'API, affiché de manière lisible 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-en un et installez-le pour 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 ce réglage d'une session à l'autre :
    # 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="Utiliser 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>