ant CLI : Le Nouveau Client en Ligne de Commande pour l'API Claude

Sommaire

---

Qu'est-ce que ant CLI ?

ant est le nouveau client en ligne de commande officiel d'Anthropic pour interagir avec l'API Claude. Si vous utilisez déjà [Claude Code](/blog/claude-code-guide-complet) pour le développement assisté par IA, ant est son complément naturel pour les interactions directes avec l'API.

Avant ant, appeler l'API Claude depuis le terminal nécessitait de construire manuellement des requêtes JSON avec \curl\. C'était verbeux, sujet aux erreurs, et pénible pour les requêtes complexes impliquant des fichiers ou des conversations multi-tours.

ant résout ce problème en offrant :

---

Installation et configuration

Installation

ant s'installe via npm, Homebrew ou comme binaire autonome :

\\\`bash # Via npm (recommandé si vous utilisez déjà Claude Code) npm install -g @anthropic-ai/cli

# Via Homebrew (macOS/Linux) brew install anthropic/tap/ant

# Vérifier l'installation ant --version \\\`

Configuration de la clé API

ant utilise la même variable d'environnement que le SDK Anthropic :

\\\`bash # Ajouter à votre .zshrc ou .bashrc export ANTHROPIC_API_KEY="sk-ant-..."

# Ou configurer via ant directement ant config set api-key sk-ant-... \\\`

Si vous avez déjà configuré votre clé API pour le [Claude Agent SDK](/blog/claude-agent-sdk-creer-agents-ia) ou pour Claude Code, ant la détectera automatiquement.

Completions shell

ant supporte les completions pour les 4 shells principaux :

\\\`bash # bash ant completion bash >> ~/.bashrc

# zsh ant completion zsh >> ~/.zshrc

# fish ant completion fish > ~/.config/fish/completions/ant.fish

# PowerShell ant completion powershell >> $PROFILE \\\`

---

Premiers pas avec ant

La commande la plus basique est \ant messages create\ :

\\\bash # Requête simple ant messages create \ --model claude-sonnet-4-6 \ --max-tokens 1024 \ --user "Explique-moi le MCP en 3 phrases" \\\

Comparez avec l'équivalent curl :

\\\bash # Même requête en curl (bien plus verbeux) curl https://api.anthropic.com/v1/messages \ -H "x-api-key: $ANTHROPIC_API_KEY" \ -H "anthropic-version: 2023-06-01" \ -H "content-type: application/json" \ -d '{ "model": "claude-sonnet-4-6", "max_tokens": 1024, "messages": [ {"role": "user", "content": "Explique-moi le MCP en 3 phrases"} ] }' \\\

Le gain de productivité est immédiat : 4 lignes au lieu de 12, pas de JSON à formater, pas de headers à retenir.

---

Construction de requêtes sans JSON

ant permet de construire des requêtes complexes sans écrire une seule ligne de JSON :

Messages multi-tours

\\\bash ant messages create \ --model claude-opus-4-7 \ --max-tokens 2048 \ --user "Qu'est-ce que Claude Code ?" \ --assistant "Claude Code est le CLI d'Anthropic pour le développement assisté par IA." \ --user "Quelles sont ses fonctionnalités principales ?" \\\

System prompt

\\\bash ant messages create \ --model claude-sonnet-4-6 \ --max-tokens 1024 \ --system "Tu es un expert en sécurité informatique. Réponds en français." \ --user "Analyse les risques de cette configuration nginx" \\\

Paramètres avancés

\\\bash ant messages create \ --model claude-opus-4-7 \ --max-tokens 4096 \ --temperature 0.3 \ --top-p 0.9 \ --user "Génère un plan d'architecture pour une API REST" \\\

Entrée YAML via pipe

Pour les requêtes très complexes, ant accepte du YAML en entrée :

\\\`bash cat <

content: "Conçois une architecture microservices pour un e-commerce" EOF \\\`

---

Références de fichiers avec @path

La fonctionnalité la plus puissante de ant est la référence de fichiers inline avec \@\ :

\\\`bash # Analyser un fichier de code ant messages create \ --model claude-sonnet-4-6 \ --max-tokens 2048 \ --user "Trouve les bugs dans ce code : @src/app/api/route.ts"

# Comparer deux fichiers ant messages create \ --model claude-opus-4-7 \ --max-tokens 4096 \ --user "Compare ces deux implémentations : @v1/handler.ts @v2/handler.ts"

# Analyser une image ant messages create \ --model claude-sonnet-4-6 \ --max-tokens 1024 \ --user "Décris cette maquette UI : @designs/homepage.png" \\\`

ant détecte automatiquement le type MIME du fichier et encode le contenu de manière appropriée (base64 pour les images, texte brut pour le code). Plus besoin de convertir manuellement les fichiers en base64 avant de les envoyer à l'API.

Cette fonctionnalité est particulièrement utile pour les revues de code automatisées et l'analyse de documents.

---

Extraction de données avec --transform

\--transform\ permet d'extraire des champs spécifiques de la réponse JSON :

\\\`bash # Extraire uniquement le texte de la réponse ant messages create \ --model claude-sonnet-4-6 \ --max-tokens 256 \ --user "Donne-moi un UUID" \ --transform ".content[0].text"

# Extraire l'usage de tokens ant messages create \ --model claude-sonnet-4-6 \ --max-tokens 256 \ --user "Hello" \ --transform ".usage"

# Combiner avec d'autres outils Unix ant messages create \ --model claude-sonnet-4-6 \ --max-tokens 256 \ --user "Liste 5 frameworks JavaScript" \ --transform ".content[0].text" | grep -c "React" \\\`

\--transform\ utilise la syntaxe jq, ce qui permet des extractions complexes et des transformations de données directement dans le pipeline.

---

Intégration avec Claude Code

ant et [Claude Code](/blog/claude-code-guide-complet) sont conçus pour fonctionner ensemble. Claude Code peut appeler ant dans les [hooks](/blog/claude-code-hooks-automatiser-workflow) et les scripts, et parser automatiquement les résultats.

Exemple : hook de validation de code

\\\json { "hooks": { "pre-commit": { "command": "ant messages create --model claude-sonnet-4-6 --max-tokens 512 --user 'Vérifie la qualité de ce diff : @<(git diff --staged)' --transform '.content[0].text'" } } } \\\

Exemple : script de revue de PR

\\\bash #!/bin/bash # review-pr.sh — Revue automatique de PR avec ant DIFF=$(gh pr diff $1) echo "$DIFF" | ant messages create \ --model claude-opus-4-7 \ --max-tokens 4096 \ --system "Tu es un reviewer de code senior. Analyse ce diff et identifie les problèmes potentiels." \ --user "@/dev/stdin" \ --transform ".content[0].text" \\\

Exemple : pipeline CI/CD

ant est léger et rapide, ce qui le rend adapté aux pipelines CI/CD. Vous pouvez l'intégrer dans vos [workflows DevOps](/blog/claude-code-devops-cicd-pipeline-2026) pour des analyses automatiques :

\\\`yaml # .github/workflows/code-review.yml

run: | ant messages create \ --model claude-sonnet-4-6 \ --max-tokens 2048 \ --user "Analyse cette PR pour les problèmes de sécurité : @<(git diff origin/main...HEAD)" \ --transform ".content[0].text" > review.md \\\`

---

Commandes beta : agents et sessions

ant expose également des ressources beta sous le préfixe \beta:\ :

\\\`bash # Lister les agents managés ant beta:agents list

# Créer une session d'agent ant beta:sessions create \ --agent-id agent_xxx \ --input "Déploie la dernière version en staging"

# Vérifier le statut d'un déploiement ant beta:deployments get deploy_xxx

# Gérer les environnements ant beta:environments list \\\`

Ces commandes sont particulièrement utiles pour les développeurs qui utilisent les [Claude Managed Agents](/blog/claude-managed-agents-entreprises-2026) en production. ant offre un accès rapide à la gestion des agents sans passer par le dashboard web.

---

Cas d'usage pratiques

1. Traduction automatique de fichiers

\\\bash for file in docs/en/*.md; do ant messages create \ --model claude-sonnet-4-6 \ --max-tokens 8192 \ --system "Traduis ce document en français. Conserve le formatage Markdown." \ --user "@$file" \ --transform ".content[0].text" > "docs/fr/$(basename $file)" done \\\

2. Analyse de logs

\\\bash tail -100 /var/log/app/error.log | ant messages create \ --model claude-sonnet-4-6 \ --max-tokens 1024 \ --system "Analyse ces logs d'erreur et identifie la cause racine." \ --user "@/dev/stdin" \ --transform ".content[0].text" \\\

3. Génération de documentation

\\\bash ant messages create \ --model claude-opus-4-7 \ --max-tokens 4096 \ --user "Génère la documentation API pour ce fichier : @src/api/users.ts" \ --transform ".content[0].text" > docs/api/users.md \\\

4. Batch processing avec xargs

\\\bash find src -name "*.ts" | xargs -I {} ant messages create \ --model claude-sonnet-4-6 \ --max-tokens 512 \ --user "Note la qualité de ce code de 1 à 10 : @{}" \ --transform ".content[0].text" \\\

---

ant CLI vs appels API directs

ant ne remplace pas le SDK Python ou TypeScript pour les applications complexes. C'est un outil complémentaire pour les interactions rapides, le prototypage, les scripts shell et les pipelines CI/CD.

Pour les développeurs qui utilisent quotidiennement le terminal avec [Claude Code](/blog/claude-code-pour-debutants), ant s'intègre naturellement dans le workflow existant.

---

FAQ

ant remplace-t-il Claude Code ?

Non. Claude Code est un environnement de développement complet avec contexte de projet, sous-agents, [skills](/blog/claude-code-skills-creer-commandes-personnalisees), et [agent teams](/blog/claude-code-agent-teams). ant est un outil ciblé pour les appels API directs depuis le terminal. Ils sont complémentaires.

Faut-il une clé API Anthropic ?

Oui, ant nécessite une clé API Anthropic (commençant par \sk-ant-\). Vous pouvez en obtenir une sur console.anthropic.com. Le plan gratuit inclut des crédits pour démarrer.

ant supporte-t-il le streaming ?

Oui, ant supporte le streaming par défaut. Les réponses s'affichent en temps réel dans le terminal, ce qui est particulièrement agréable pour les réponses longues.

Peut-on utiliser ant dans des scripts automatisés ?

Absolument, c'est même l'un de ses cas d'usage principaux. La combinaison de \--transform\ et des pipes Unix en fait un outil puissant pour l'automatisation. Consultez notre guide sur les [tâches planifiées Claude Code](/blog/claude-code-scheduled-tasks-automatisation) pour aller plus loin.

ant fonctionne-t-il avec les modèles tiers ?

Non, ant est exclusivement conçu pour l'API Anthropic. Pour les modèles tiers, utilisez les SDKs ou CLI spécifiques de chaque fournisseur.

Quelle est la différence avec le SDK Anthropic ?

Le SDK (Python/TypeScript) est conçu pour les applications. ant est conçu pour le terminal. Si vous écrivez du code qui appelle Claude, utilisez le SDK. Si vous voulez appeler Claude depuis un script bash ou une commande one-liner, utilisez ant.

---

*Sources : Anthropic API Documentation, Claude Code Changelog, Anthropic Engineering Blog.*