Scripts et automatisation avec 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.

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.

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 :

1. 1

   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, les entrées sont ./agents/summarizer.md et ./environments/cloud.yaml.

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

   

   Output

   

   {
     "id": "session_01JZCh78XvmxJjiXVy3oSi7K",
     "status": "running"
     /* ... */
   }

2. 2

   Envoyer un message utilisateur

   Copiez l'id de la session issu de la sortie précédente dans --session-id :

   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."}]}'

   
3. 3

   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 :

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

   

   Output

   

   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.

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 :

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 :

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

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

Utiliser la CLI depuis Claude Code

Claude Code 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 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 :

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"}]
  }'

Exécutez ant auth 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.