Agents de codage IA et outils

Claude Code envoie sa valeur par défaut configurée (par exemple claude-opus-5 ou claude-sonnet-5) — pas le nom de votre passerelle. Soit nommez le modèle de la passerelle exactement comme l’outil le demande, soit définissez sa variable d’environnement de modèle (par exemple ANTHROPIC_MODEL) sur votre nom de passerelle. En cas d’incohérence → 404 model_not_found dès le premier message.

L’URL de base des clients de style Anthropic pointe vers la racine de la passerelle (sans /v1) — le client ajoute lui-même /v1/messages. Ajouter /v1 ici double le segment de chemin.

Codex CLI impose wire_api = "responses" pour un bloc [model_providers.*] personnalisé. La passerelle implémente /v1/responses nativement — pointez base_url vers elle et définissez env_key sur une clé d’accès à la passerelle.

Aider, OpenHands et SWE-agent reposent sur LiteLLM : définissez OPENAI_API_BASE sur la passerelle et donnez au modèle un préfixe openai/ (par exemple openai/gateway-model-name) pour que LiteLLM le route comme un point de terminaison compatible OpenAI.

Codex, Gemini CLI et Qwen Code utilisent par défaut la connexion OAuth / abonnement du fournisseur. Pour router via la passerelle, vous devez passer à l’authentification par clé API (définir explicitement la clé + l’URL de base) — sinon l’agent contourne entièrement la passerelle.

Cline / Roo / Kilo et d’autres décident de la capacité d’appel d’outils et de vision à partir du nom du modèle. Un nom de passerelle personnalisé peut désactiver l’appel de fonctions — si les appels d’outils échouent, vérifiez les règles de détection de capacités du client ou nommez le modèle comme une famille connue.

Pendant une longue inférence amont, la passerelle émet des lignes de commentaire SSE :keep-alive (inoffensives — ignorez les lignes commençant par :), et en cas de rupture en cours de flux elle insère un champ _gateway_warning au lieu de renvoyer une erreur, afin que des outils comme Claude Code n’interrompent pas toute la conversation.

En mode auto, Claude Code attend un verdict côté serveur (un champ safeguards dans la requête) avant une action potentiellement dangereuse. Lorsque l’amont est Anthropic officiel, le verdict est produit dans la même requête et la passerelle le transmet tel quel. Lorsque l’amont est un tiers qui ignore ce champ, c’est la passerelle qui répond — et la valeur par défaut livrée (allow_all) libère toutes les actions, ce qui est plus permissif que de laisser l’appel intact. Rendez une route à son amont en écrivant "anthropic_server_safeguards": "upstream" dans l’extra_config de cet amont ; le réglage dans la console est réservé aux administrateurs.