Scripts CLI et automatisation

Cette page couvre les flux de travail orientés tâches construits sur la CLI ant. Pour les options de drapeaux et de sortie sous-jacentes, consultez Utiliser la CLI.



Gestion de versions des ressources API

Vous pouvez utiliser la CLI pour gérer les versions des ressources API telles que les skills, les agents, les environnements ou les déploiements sous forme de fichiers YAML dans votre dépôt et les maintenir synchronisés avec l'API Claude.



Modèles de scripts

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



Enchaîner la sortie d'une liste dans 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 passez-le à une commande de suivi :

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 drapeaux --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 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 dès l'installation. Avec la CLI installée et authentifiée, vous pouvez demander à Claude Code d'opérer directement sur vos ressources API. Par exemple :

• « Liste mes sessions d'agent récentes et résume celles qui ont échoué. »
• « Téléverse chaque PDF dans ./reports vers l'API Files et affiche les ID résultants. »
• « 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 via le shell, analyse la sortie structurée et raisonne sur les résultats (aucun code d'intégration personnalisé requis).



Authentifier les requêtes curl avec les identifiants 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 va dans l'en-tête Authorization en tant que jeton bearer ; l'en-tête x-api-key est uniquement destiné aux clés API statiques.

ant auth print-credentials --access-token affiche le jeton d'accès du profil actif, en le rafraîchissant 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",
    "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.