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

# 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 :

# 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 ou pour Claude Code, ant la détectera automatiquement.

Completions shell

ant supporte les completions pour les 4 shells principaux :

# 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 :

# 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 :

# 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

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

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

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 :

cat <<EOF | ant messages create --yaml
model: claude-opus-4-7
max_tokens: 4096
system: "Tu es un architecte logiciel senior."
messages:
  - role: user
    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 @ :

# 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 :

# 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 sont conçus pour fonctionner ensemble. Claude Code peut appeler ant dans les hooks et les scripts, et parser automatiquement les résultats.

Exemple : hook de validation de code

{
  "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

#!/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 pour des analyses automatiques :

# .github/workflows/code-review.yml
- name: AI Code Review
  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: :

# 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 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

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

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

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

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, 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, et 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 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.*