Accès illimité à Claude Code

Claude Code est l’agent officiel en ligne de commande d’Anthropic pour le développement logiciel. Il fonctionne avec une fenêtre de contexte de 200k, lance des sous-agents disposant de leurs propres contextes indépendants, lit des fichiers entiers dans l’historique de conversation et renvoie l’intégralité du contexte à chaque échange, ce qui entraîne une croissance quadratique du nombre de tokens au fil des longues sessions. Cela en fait l’un des outils de développement les plus gourmands en tokens disponibles. Connecter Claude Code à une passerelle illimitée à tarif forfaitaire le transforme : d’un outil dont l’usage doit être soigneusement rationné, il devient un véritable partenaire de développement disponible en permanence.

Pourquoi la consommation de tokens de Claude Code augmente de façon quadratique

Du point de vue de l’API, Claude Code ne conserve aucun état entre les échanges. Chaque message que vous envoyez inclut l’intégralité de l’historique de conversation : tous les messages précédents, le contenu de tous les fichiers lus, tous les résultats des outils et toutes les réponses de l’assistant. Le premier message peut représenter 5,000 tokens. Au dixième échange, vous envoyez 50,000 tokens d’historique, auxquels s’ajoute tout nouveau contenu. Au vingtième échange, le contexte peut dépasser 150,000 tokens par requête.

Les sous-agents accentuent ce phénomène. Lorsque Claude Code délègue du travail à un sous-agent, celui-ci dispose de sa propre fenêtre de contexte et commence à accumuler son propre historique de manière indépendante. Le contexte de l’agent principal s’enrichit du résumé du sous-agent, tandis que ce dernier génère sa propre facture de tokens. Les équipes d’agents, dans lesquelles plusieurs sous-agents collaborent, amplifient encore cette consommation. Une tâche complexe peut mobiliser un agent principal et trois sous-agents, chacun disposant de plus de 100k tokens de contexte et utilisant la même clé API.

La commande /compact aide en résumant l’historique et en tronquant l’ancien contexte, mais il s’agit d’une intervention manuelle qui sacrifie des détails pour gagner de la place. Avec une facturation au token, les utilisateurs compactent sans cesse pour maîtriser les coûts. Avec un accès illimité, vous pouvez laisser les conversations se développer naturellement, ne compacter que lorsque la qualité du contexte se dégrade et utiliser librement des sous-agents sans calculer mentalement leur coût.

Configuration des variables d’environnement

Claude Code lit sa configuration API dans les variables d’environnement. Les deux variables essentielles sont ANTHROPIC_BASE_URL et soit ANTHROPIC_API_KEY, soit ANTHROPIC_AUTH_TOKEN. Définissez ANTHROPIC_BASE_URL sur https://unlimited.aiprimetech.io, l’hôte racine sans /v1, car le SDK Anthropic ajoute automatiquement le chemin de l’API. Pour la clé, utilisez ANTHROPIC_API_KEY si votre passerelle attend une authentification via l’en-tête x-api-key, le format standard d’Anthropic.

Définissez ces variables dans le fichier de profil de votre shell (.bashrc, .zshrc ou $PROFILE pour PowerShell) pour rendre la configuration persistante. Sous Windows, vous pouvez également les définir comme variables d’environnement système dans la boîte de dialogue Paramètres système avancés. Claude Code les lit au démarrage : si vous les modifiez, redémarrez la session Claude Code pour que les nouvelles valeurs prennent effet.

Pour remplacer la configuration au niveau d’un projet, créez un fichier .env à la racine de votre projet. Claude Code charge les fichiers .env depuis le répertoire de travail. Cela vous permet d’utiliser des configurations API différentes pour chaque projet, ce qui est utile si certains de vos projets utilisent un accès illimité et d’autres une facturation directe par Anthropic. Le fichier .env est prioritaire sur les variables d’environnement système.

Correspondance des modèles pour Sonnet, Opus, Haiku et Fable

Claude Code utilise des alias de modèles internes que vous pouvez remplacer à l’aide de variables d’environnement. ANTHROPIC_DEFAULT_SONNET_MODEL détermine le modèle utilisé pour la sélection « sonnet » par défaut. ANTHROPIC_DEFAULT_OPUS_MODEL remplace le choix « opus ». ANTHROPIC_DEFAULT_HAIKU_MODEL et ANTHROPIC_DEFAULT_FABLE_MODEL contrôlent les autres niveaux. Définissez ces variables sur les identifiants exacts des modèles pris en charge par votre passerelle.

Par exemple, définissez ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-4-5 et ANTHROPIC_DEFAULT_OPUS_MODEL=claude-opus-4-6.. Lorsque vous sélectionnez un niveau de modèle dans Claude Code avec /model ou l’option de démarrage, le modèle utilisé est celui que vous avez associé à ce niveau. Cela est particulièrement utile si la passerelle expose des identifiants de modèles personnalisés ou si vous souhaitez fixer des versions précises de modèles.

Avec un accès illimité, le choix du modèle dépend uniquement du compromis entre qualité et rapidité. Il n’y a aucune différence de coût entre les niveaux. Utilisez Opus par défaut pour obtenir la meilleure qualité et ne passez à Sonnet ou Haiku que lorsque vous avez besoin de réponses plus rapides pendant des itérations rapprochées. La commande /effort permet également d’ajuster le degré d’approfondissement avec lequel Claude Code traite chaque tâche : combinez un effort élevé avec Opus pour obtenir la configuration la plus performante.

Sous-agents, équipes d’agents et agents en arrière-plan

Claude Code peut lancer des sous-agents : des instances Claude indépendantes disposant de leurs propres fenêtres de contexte et prenant en charge des sous-tâches déléguées. Lorsque l’agent principal rencontre une tâche complexe, il peut déléguer la recherche, l’implémentation ou la vérification à des sous-agents qui travaillent de manière isolée et lui rendent compte de leurs résultats. Chaque sous-agent démarre avec un contexte vierge et accumule son propre historique de conversation.

Les équipes d’agents étendent ce concept en permettant à plusieurs sous-agents de collaborer simultanément sur des travaux connexes. L’agent principal joue le rôle de coordinateur, répartit le travail et synthétise les résultats. Cette approche est extrêmement puissante pour les changements à grande échelle : un sous-agent peut refactoriser le module A pendant qu’un autre s’occupe du module B. Toutefois, la consommation de l’API augmente linéairement avec le nombre d’agents actifs.

Les agents en arrière-plan s’exécutent de manière asynchrone pendant que vous poursuivez votre travail dans la session principale. Ils traitent des tâches distinctes et communiquent leurs résultats une fois celles-ci terminées. Avec une facturation au token, exécuter simultanément plusieurs agents en arrière-plan devient vite coûteux. Avec un accès illimité, vous pouvez lancer plusieurs agents en arrière-plan, les laisser travailler sur différents aspects de votre projet et examiner leurs résultats lorsqu’ils sont prêts, le tout étant couvert par le tarif forfaitaire.

Définissez CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1 pour empêcher Claude Code d’envoyer des données de télémétrie et des requêtes non essentielles. C’est une bonne pratique avec toute passerelle personnalisée pour réduire le bruit. De plus, CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1 indique à Claude Code d’interroger la passerelle pour connaître les modèles disponibles plutôt que d’utiliser des listes codées en dur.

Mode sans interface et intégration CI/CD

Le mode sans interface de Claude Code (option --headless) s’exécute sans invites interactives, ce qui le rend adapté aux pipelines CI/CD, à la revue de code automatisée et au traitement par lots. Dans ce mode, Claude Code lit les données d’entrée depuis stdin ou les arguments de la ligne de commande et écrit les résultats sur stdout. Il se termine lorsque la tâche est achevée au lieu d’attendre de nouvelles entrées.

Pour une intégration CI, définissez les variables d’environnement dans la configuration de votre pipeline (secrets GitHub Actions, variables GitLab CI, identifiants Jenkins) et appelez Claude Code en passant la description de la tâche comme argument. Les cas d’usage courants en CI comprennent la revue automatisée des PR, la génération de documentation, l’écriture de tests et les scripts de migration.

Avec un accès illimité, le mode sans interface permet des workflows à haut débit. Vous pouvez exécuter Claude Code sur chaque PR d’un dépôt, générer par lots des suites de tests pour les modules non testés ou automatiser les mises à jour de la documentation à chaque nouvelle version, sans vous soucier du coût de chaque exécution. Le tarif forfaitaire couvre l’ensemble du volume tant qu’il reste dans les limites de débit prévues par la politique d’utilisation raisonnable.

Mémoire du projet dans CLAUDE.md et hooks

Les fichiers CLAUDE.md fournissent un contexte de projet persistant que Claude Code charge automatiquement. Placez un fichier CLAUDE.md à la racine de votre projet avec les normes de codage, les décisions d’architecture, les schémas courants et les instructions propres au projet. Ce contenu est inclus dans le prompt système de chaque requête, ce qui ajoute des tokens à chaque appel, mais améliore considérablement la qualité et la cohérence des réponses.

Avec une facturation au token, les utilisateurs limitent le contenu de CLAUDE.md au strict minimum pour maîtriser les coûts : chaque mot ajoute des tokens à chaque requête pendant toute la durée de la session. Avec un accès illimité, fournissez autant de contexte que cela est réellement utile : documentation d’architecture détaillée, guides de style complets, explications des dépendances et conventions d’équipe. Les tokens supplémentaires par requête n’entraînent aucun surcoût, et les gains de qualité se cumulent au fil des interactions.

Les hooks vous permettent d’exécuter des scripts personnalisés à des moments précis de l’exécution de Claude Code : avant et après les appels d’outils, au démarrage de la session et lors du compactage. Utilisez les hooks pour injecter du contexte dynamique, valider les modifications via la CI, formater automatiquement le code ou déclencher des notifications. Les hooks s’intègrent parfaitement à la passerelle illimitée, car ils fonctionnent au niveau du CLI plutôt qu’au niveau de l’API.

Résolution des problèmes de passerelle avec Claude Code

Si Claude Code ne parvient pas à se connecter, vérifiez que ANTHROPIC_BASE_URL est défini sur l’hôte racine sans /v1. Exécutez echo $ANTHROPIC_BASE_URL (ou $env:ANTHROPIC_BASE_URL dans PowerShell) pour confirmer la valeur. Le SDK ajoute automatiquement /v1/messages : si vous incluez /v1 dans l’URL de base, les requêtes sont envoyées à /v1/v1/messages, qui renvoie une erreur 404.

Les erreurs indiquant qu’un modèle est introuvable signifient que l’identifiant du modèle dans votre variable de correspondance ne correspond pas à celui proposé par la passerelle. Vérifiez les identifiants exacts pris en charge dans votre tableau de bord AI Prime Tech et mettez à jour ANTHROPIC_DEFAULT_SONNET_MODEL en conséquence. N’oubliez pas que les identifiants de modèles sont sensibles à la casse et comprennent des suffixes de version.

Si les sessions fonctionnent mais que les sous-agents échouent, le problème peut venir du fait que les sous-agents héritent différemment des variables d’environnement selon leur mode de lancement. Veillez à définir vos variables d’environnement au niveau du système plutôt que seulement dans la session de shell en cours, particulièrement sous Windows, où les processus enfants peuvent ne pas hériter des variables locales du shell.

# Shell environment (add to .bashrc / .zshrc / $PROFILE)
export ANTHROPIC_BASE_URL="https://aiprimetech.io"
export ANTHROPIC_API_KEY="<your AI Prime Tech Unlimited key>"
export ANTHROPIC_DEFAULT_SONNET_MODEL="claude-sonnet-4-5"
export ANTHROPIC_DEFAULT_OPUS_MODEL="claude-opus-4-6"
export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1

# Or per-project .env file:
# ANTHROPIC_BASE_URL=https://aiprimetech.io
# ANTHROPIC_API_KEY=sk-...
# ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-4-5

# Run Claude Code:
# claude            (interactive)
# claude --headless (CI/CD mode)

Questions fréquentes

AI Prime Tech est une passerelle API indépendante. Elle n’est ni affiliée à Anthropic, ni approuvée par Anthropic, ni revendeuse d’Anthropic. Claude et les noms de modèles associés sont des marques de leurs propriétaires respectifs.