---
title: Scripts et automatisation avec la CLI
url: https://platform.claude.com/docs/fr/cli-sdks-libraries/cli/scripting
description: Versionnez les ressources de l'API sous forme de fichiers avec ant apply, enchaînez les commandes de la CLI ant dans des scripts, manipulez les ressources depuis Claude Code et authentifiez les appels curl avec les identifiants de la CLI.
---

Cette page couvre les flux de travail orientés tâches construits sur la CLI `ant`. Pour les options sous-jacentes et les options de sortie, consultez [Utiliser la CLI](https://platform.claude.com/docs/fr/cli-sdks-libraries/cli/using).

## Versionner les ressources de l'API

Pour conserver les agents, les environnements et les autres ressources Claude Managed Agents sous forme de fichiers dans votre dépôt, consultez [Gérer les ressources en tant que code avec ant apply](https://platform.claude.com/docs/fr/cli-sdks-libraries/cli/apply).

### Exécuter l'agent appliqué depuis le shell

Une fois qu'un agent et un environnement existent, vous pouvez piloter une session depuis le shell :

<Steps>
  <Step title="Démarrer une session">
    Transmettez les identifiants de l'agent et de l'environnement à la commande de création de session. Après `ant apply`, lisez-les dans `claude-lock.json` : chaque entrée sous `resources` possède un `id`, et pour le projet présenté dans [Gérer les ressources en tant que code avec ant apply](https://platform.claude.com/docs/fr/cli-sdks-libraries/cli/apply), les entrées sont `./agents/summarizer.md` et `./environments/cloud.yaml`.

    ```bash
    ant beta:sessions create \
      --agent agent_011CYm1BLqPXpQRk5khsSXrs \
      --environment-id env_01595EKxaaTTGwwY3kyXdtbs \
      --title "Summarization task"
    ```

    ```json Output
    {
      "id": "session_01JZCh78XvmxJjiXVy3oSi7K",
      "status": "running"
      /* ... */
    }
    ```
  </Step>

  <Step title="Envoyer un message utilisateur">
    Copiez l'`id` de la session issu de la sortie précédente dans `--session-id` :

    ```bash
    ant beta:sessions:events send \
      --session-id session_01JZCh78XvmxJjiXVy3oSi7K \
      --event '{type: user.message, content: [{type: text, text: "Summarize the benefits of type safety in one sentence."}]}'
    ```
  </Step>

  <Step title="Lire la conversation">
    Une fois que l'agent a répondu, listez les événements. `--transform` s'exécute sur chaque événement listé, de sorte que cette commande affiche le texte de chaque message dans l'ordre. `--format auto` remplace l'explorateur interactif que les commandes de liste ouvrent par défaut dans un terminal :

    ```bash
    ant beta:sessions:events list \
      --session-id session_01JZCh78XvmxJjiXVy3oSi7K \
      --transform 'content.0.text' \
      --raw-output \
      --format auto
    ```

    ```text Output wrap
    Summarize the benefits of type safety in one sentence.
    Type safety catches errors at compile time rather than runtime, reducing bugs, improving code clarity, enabling better tooling support, and making codebases easier to maintain and refactor with confidence.
    ```

    <Tip>
      Pour suivre une session pendant son exécution, utilisez `ant beta:sessions:events stream --session-id session_01JZCh78XvmxJjiXVy3oSi7K --format jsonl`, qui écrit chaque événement sur stdout dès son arrivée. Sans `--format`, un terminal ouvre plutôt l'explorateur interactif.
    </Tip>
  </Step>
</Steps>

## Modèles de scripts

La CLI est conçue pour se combiner avec les outils shell standard.

### Enchaîner la sortie d'une liste vers une seconde commande

`--transform id --raw-output` sur un point de terminaison de liste émet un ID brut par ligne, de sorte que les outils standard tels que `head` et `xargs` s'appliquent directement. Capturez le premier résultat, puis transmettez-le à une commande suivante :

```bash
FIRST_AGENT=$(ant beta:agents list --transform id --raw-output | head -1)

ant beta:agents:versions list \
  --agent-id "$FIRST_AGENT" \
  --transform "{version,created_at}" --format jsonl
```

### Inspecter les erreurs

Les options `--transform-error` et `--format-error` appliquent le même filtrage aux réponses d'erreur. `--raw-output` ne s'applique pas aux erreurs ; utilisez donc `--format-error yaml` pour obtenir un scalaire sans guillemets. Extrayez uniquement le message d'erreur :

```bash
ant beta:agents retrieve --agent-id bogus \
  --transform-error error.message --format-error yaml 2>&1
```

```text Output wrap
GET "https://api.anthropic.com/v1/agents/bogus?beta=true": 404 Not Found
Agent not found.
```

## Utiliser la CLI depuis Claude Code

[Claude Code](https://code.claude.com/docs/fr/overview) peut utiliser la CLI `ant` sans configuration supplémentaire. Une fois la CLI installée et authentifiée, vous pouvez demander à Claude Code d'agir directement sur vos ressources de l'API. Par exemple :

* « Liste mes sessions d'agent récentes et résume celles qui ont échoué. »
* « Téléverse chaque PDF de `./reports` vers l'API Files et affiche les ID obtenus. »
* « Récupère les événements de la session `session_01...` et dis-moi où l'agent s'est bloqué. »

Claude Code exécute `ant` dans le shell, analyse la sortie structurée et raisonne sur les résultats (aucun code d'intégration personnalisé n'est requis).

## Authentifier les requêtes curl avec les identifiants de la CLI

Les scripts qui appellent l'API avec `curl` ou un autre client HTTP peuvent utiliser les identifiants stockés par [`ant auth login`](https://platform.claude.com/docs/fr/cli-sdks-libraries/cli/quickstart#authentication) au lieu d'une clé API statique. Le jeton d'accès OAuth est placé dans l'en-tête `Authorization` en tant que jeton bearer ; l'en-tête `x-api-key` est réservé aux clés API statiques.

`ant auth print-credentials --access-token` affiche le jeton d'accès du profil actif, en le renouvelant d'abord s'il est expiré ou proche de l'expiration :

```bash cURL
curl https://api.anthropic.com/v1/messages \
  -H "Authorization: Bearer $(ant auth print-credentials --access-token)" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-opus-5-5",
    "max_tokens": 256,
    "messages": [{"role": "user", "content": "hi"}]
  }'
```

<Note>
  Laissez `ANTHROPIC_API_KEY` et `ANTHROPIC_AUTH_TOKEN` non définies lorsque vous travaillez à partir d'une connexion CLI. Chacune de ces variables est prioritaire sur la connexion pour les commandes `ant` (consultez [Priorité des identifiants](https://platform.claude.com/docs/fr/manage-claude/wif-reference#credential-precedence)) et peut les rediriger silencieusement vers une autre organisation ou un autre espace de travail.
</Note>

Exécutez [`ant auth status`](https://platform.claude.com/docs/fr/cli-sdks-libraries/cli/authentication#check-authentication-status) pour confirmer l'organisation et l'espace de travail auxquels vous êtes connecté ; la commande vous avertit lorsqu'une variable d'environnement remplace votre connexion.