Claude Code et Codex reliés à HiAPI : une seule clé, un modèle par tâche

Ces derniers jours, une phrase de Karpathy en début d'année refait surface : the new default is that you are not writing the code directly 99% of the time, you are orchestrating agents who do and acting as oversight. Autrement dit : par défaut, 99 % du temps vous n'écrivez plus le code vous-même, vous orchestrez des agents qui le font à votre place et vous ne jouez plus qu'un rôle de supervision. Cette phrase vient de son post où il introduisait le concept d'agentic engineering ; dans le podcast No Prior, il en a remis une couche : I don't think I've typed a line of code probably since December.

Au-delà de l'effet de mode, les données montrent qu'il ne s'agit pas d'un simple slogan. Le revenu annualisé d'exploitation de Claude Code dépasse déjà 2,5 Md$ (chiffre annoncé lors de la Series G de février 2026, ARR non audité), alors que GitHub Copilot avait mis environ 3 ans pour atteindre 1 Md$. Dans l'enquête 2026 de JetBrains sur l'écosystème des développeurs (plus de 15 000 répondants), environ 90 % des développeurs professionnels utilisent chaque semaine un agent de programmation IA ; le taux d'adoption de Claude Code en contexte professionnel est passé de 18 % à 39 % (47 % aux États-Unis), et celui de Codex de 3 % à 16 %.

Le problème arrive avec : les agents se multiplient, mais la configuration et la facturation restent séparées. Beaucoup de gens utilisent Claude Code et Codex en même temps, mais chaque outil a sa propre demande de clé, son propre crédit et ses propres statistiques d'usage ; pour changer de modèle, il faut repasser par une procédure de demande. Cet article explique comment connecter les deux outils avec une seule clé HiAPI, puis comment choisir et changer de modèle une fois l'intégration faite.

Le résumé

• Une clé pour deux outils : la clé API HiAPI sert à la fois à Claude Code et à Codex ; solde, consommation et facturation sont dans un seul back-office
• Chacun son meilleur modèle : Claude Code utilise le protocole Anthropic Messages (/v1/messages) avec les modèles Claude de HiAPI ; Codex utilise l'API Responses (/v1/responses) avec les modèles de la gamme GPT-6.1
• Liberté dans les limites de deux règles : Claude Code ne prend officiellement pas en charge le routage vers des modèles non-Claude via une passerelle quelconque ; la bonne approche est donc de connecter chaque outil à sa propre famille de modèles, et non de faire tout passer par un seul outil
• Intégration en 5 minutes maximum : ouvrez la page /connect/agents, choisissez l'outil, le modèle et le système, puis copiez la configuration générée ; Claude Code et Codex prennent en charge l'import en un clic via CC Switch
• Changer de modèle = une seule modification : pour Claude Code, modifiez le champ de modèle dans settings.json ; pour Codex, modifiez la ligne model dans hiapi.config.toml ; la clé ne change pas

La solution HiAPI : une clé, deux outils

HiAPI est une plateforme API qui agrège plusieurs familles de modèles et expose plusieurs protocoles standard de manière unifiée. Côté agents de programmation, la plateforme propose officiellement une page d'intégration en un clic pour 4 outils : /zh/connect/agents (version anglaise /en/connect/agents), compatible avec Claude Code, Codex CLI, OpenCode et Hermes Agent.

Le mappage des protocoles est la clé d'une intégration correcte :

Outil	Protocole	Chemin d'accès	Modèles disponibles côté HiAPI
Claude Code	Anthropic Messages	/v1/messages	claude-opus-5-5, claude-sonnet-4-6, claude-opus-4-8, claude-opus-4-8@aws (4 au total)
Codex CLI	API Responses	/v1/responses	gpt-6.1-sol, gpt-6.1-terra, gpt-6-astra, gamme gpt-5.6, gamme deepseek-v4 (9 au total)
OpenCode / Hermes Agent	Chat Completions	/v1/chat/completions	Modèles textuels de chaque famille, couverture la plus large

Autrement dit, Claude Code excelle dans les tâches d'agent de codage longue durée et reçoit le fleuron de la famille Claude ; Codex excelle dans les traitements à volume et reçoit la gamme GPT-6.1. Une seule clé authentifie les deux côtés, et la facturation est consolidée.

Une chose doit être dite clairement : Anthropic indique officiellement que Claude Code ne prend pas en charge le routage vers des modèles non-Claude via une passerelle quelconque. Forcer un modèle GPT dans Claude Code rend les appels d'outils et le comportement de l'agent instables, sans recours officiel en cas de problème. Donc « une clé pour changer de modèle à tout moment » signifie précisément : répartir les tâches entre les deux outils, chacun utilisant le modèle le plus performant pour lui, et non mélanger les familles au sein d'un même outil.

Si vous n'utilisez que Claude Code, consultez notre guide de configuration mono-outil déjà publié : « Connecter Claude Code à HiAPI : guide de configuration complet pour économiser 100 $ d'abonnement par mois ». Cet article se concentre sur le partage d'une clé entre deux outils et la stratégie de bascule.

Méthode 1 (recommandée) : générer la configuration via la page /connect/agents

La méthode la plus simple, entièrement par sélection, sans écrire aucune configuration à la main :

1. Ouvrez hiapi.ai/zh/connect/agents et cliquez sur « Connecter HiAPI à votre Agent »
2. Choisissez l'outil : Claude Code ou Codex CLI
3. Choisissez le modèle : par exemple claude-opus-5-5 pour Claude Code, gpt-6.1-sol pour Codex
4. Choisissez le système d'exploitation : macOS / Windows / Linux ; les chemins de la configuration s'adaptent
5. Copiez la configuration générée et collez-la dans le fichier correspondant selon les indications

Claude Code et Codex prennent en charge l'import en un clic via CC Switch : sur la page API Keys de HiAPI, cliquez sur Importer ; le navigateur lance CC Switch pour écrire la configuration. Le lien d'import lui-même ne contient pas votre clé, celle-ci est stockée dans une variable d'environnement locale ; vous pouvez être tranquille sur ce point.

Vérifiez d'abord les versions requises : Codex CLI nécessite 0.134 ou plus, vérifiez avec codex --version ; pour Claude Code, utilisez claude --version pour confirmer que le numéro de version s'affiche correctement.

Méthode 2 : écrire manuellement les fichiers de configuration

La configuration manuelle n'est pas compliquée non plus ; chaque fichier gère un outil.

Claude Code : ~/.claude/settings.json

Dans le bloc env de ~/.claude/settings.json (sous Windows, %USERPROFILE%\.claude\settings.json), ajoutez :

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.hiapi.ai",
    "ANTHROPIC_AUTH_TOKEN": "votre clé API HiAPI",
    "ANTHROPIC_MODEL": "claude-opus-5-5",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-5-5",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-opus-5-5",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-sonnet-4-6",
    "CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS": "1"
  }
}

Explication champ par champ :

• ANTHROPIC_BASE_URL pointe vers https://api.hiapi.ai, sans /v1 ; le client ajoute lui-même /v1/messages
• ANTHROPIC_AUTH_TOKEN contient votre clé API HiAPI, avec authentification Bearer
• ANTHROPIC_MODEL ainsi que les deux alias OPUS / SONNET pointent tous vers le modèle que vous avez choisi sur HiAPI (HiAPI ne sert pas les ID officiels des modèles Claude ; les alias pointent tous vers votre choix)
• ANTHROPIC_DEFAULT_HAIKU_MODEL est fixé à claude-sonnet-4-6 ; c'est l'emplacement utilisé par Claude Code pour les tâches d'arrière-plan (compression de contexte, génération de messages de commit, etc.)
• CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1 car le nouveau pipeline de texte rejette les champs de requête experimental beta ; désactivez-le pour éviter les problèmes

Codex : ~/.codex/hiapi.config.toml

Créez ~/.codex/hiapi.config.toml (sous Windows, %USERPROFILE%\.codex\hiapi.config.toml) :

model_provider = "hiapi"
model = "gpt-6.1-sol"

[model_providers.hiapi]
name = "HiAPI"
base_url = "https://api.hiapi.ai/v1"
env_key = "HIAPI_API_KEY"
wire_api = "responses"

Ensuite, définissez la variable d'environnement dans le shell et lancez :

export HIAPI_API_KEY="votre clé API HiAPI"
codex --profile hiapi

Sous Windows PowerShell, utilisez $env:HIAPI_API_KEY = "...". Attention : ici base_url inclut /v1, contrairement au côté Claude Code ; ne copiez pas l'un pour l'autre.wire_api = "responses" déclare l'utilisation du protocole Responses, une exigence stricte de Codex.

Comment choisir le modèle : Opus pour les tâches complexes, GPT-6.1 pour le volume

Une fois les deux outils connectés, le choix du modèle devient une question de routage par tâche. Notre recommandation est directe :

• Tâches difficiles et longues : claude-opus-5-5 : refactorisation multi-fichiers, débogage marathon, tâches nécessitant la compréhension de toute la base de code. C'est le fleuron côté Claude Code, avec une fenêtre de contexte allant jusqu'à 1M
• Traitements quotidiens à fort volume : gpt-6.1-sol / gpt-6.1-terra : réécritures en lot, fonctionnalités sur un seul fichier, génération de scripts — des tâches nombreuses et peu complexes ; avec un modèle d'un cran moins cher, la différence de facture est nette
• gpt-6-astra réservé aux scénarios Responses plus sensibles à la qualité : un cran de prix au-dessus, à activer selon les besoins

Prix plateforme des modèles clés ($/M de tokens, en vigueur en octobre 2026, offre de base) :

Modèle	Entrée	Sortie	Lecture de cache	Contexte
claude-opus-5-5	2,02 $	10,08 $	0,10 $	1M
claude-sonnet-4-6	3,00 $	15,00 $	0,30 $	—
gpt-6.1-sol	0,50 $	2,50 $	0,025 $	1,05M
gpt-6.1-terra	0,25 $	1,25 $	0,0125 $	1,05M
gpt-6-astra	2,50 $	12,50 $	0,25 $	1,05M (au-delà de 272K, tarif long contexte majoré)

Notez la colonne du prix de lecture de cache : dans une session d'agent, une grande partie des tokens provient des hits de cache ; la lecture de cache de gpt-6.1-terra ne coûte que 0,0125 $/M, donc lors de longues sessions où l'on modifie plusieurs fois le même dépôt, la facture réelle est bien inférieure à une estimation au prix d'entrée. Volume et économies ne sont pas incompatibles.

Pour comparer plus en détail les orientations de capacités d'Opus 5.5 et GPT-6.1 Sol, lisez « Claude Opus 5.5 face à GPT-6.1 Sol » ; l'ampleur et le contexte de la récente baisse de prix de Terra sont détaillés dans « Analyse de la baisse de prix de GPT-6.1 Terra ». Les prix et paramètres en temps réel des deux modèles font foi sur la page de détails du modèle.

Changer de modèle est très simple

C'est l'avantage le plus sous-estimé de cette approche. Changer de modèle ne demande que deux actions :

• Claude Code : modifiez les valeurs de ANTHROPIC_MODEL / ANTHROPIC_DEFAULT_OPUS_MODEL / ANTHROPIC_DEFAULT_SONNET_MODEL dans ~/.claude/settings.json (sur HiAPI, les alias opus/sonnet pointent vers votre choix ; mettez le même nouvel ID de modèle), puis rouvrez une session pour que cela prenne effet
• Codex : modifiez la ligne model = "..." dans ~/.codex/hiapi.config.toml ; cela prend effet au prochain codex --profile hiapi

La clé ne bouge pas de bout en bout. Par rapport à l'ancienne méthode « demander une clé officielle séparée pour chaque outil » : changer de modèle exigeait une nouvelle demande, une attente d'approbation et une modification de la gestion des clés ; désormais, c'est une ligne de configuration. Si vous avez utilisé l'import CC Switch, vous pouvez aussi resélectionner le modèle sur la page /connect/agents et recliquer sur Importer ; tout se fait graphiquement.

Pour connecter davantage de modèles, OpenCode et Hermes Agent utilisent le protocole Chat Completions, avec la couverture de modèles la plus large, selon le même parcours de page. Si les nouveaux modèles multimodaux et de type world model vous intéressent, jetez aussi un œil à « Test du world model Genie 4 ».

Questions fréquentes

Claude Code peut-il utiliser les modèles GPT via HiAPI ?

Non, et ce n'est pas nécessaire. Anthropic indique officiellement que Claude Code ne prend pas en charge le routage vers des modèles non-Claude via une passerelle quelconque ; forcer la connexion rend les appels d'outils et le comportement de l'agent instables, sans recours officiel. Les modèles disponibles pour Claude Code sur HiAPI sont claude-opus-5-5, claude-sonnet-4-6, claude-opus-4-8 et claude-opus-4-8@aws, soit 4 modèles. Pour utiliser les modèles de la gamme GPT-6.1, passez par Codex, dont le protocole Responses les prend nativement en charge.

Une clé HiAPI peut-elle servir en même temps à Claude Code et à Codex ?

Oui, c'est le cœur de cette approche. Les deux outils partagent la même clé ; le mode d'authentification diffère (ANTHROPIC_AUTH_TOKEN pour Claude Code, variable d'environnement HIAPI_API_KEY pour Codex), mais il s'agit de la même clé. Solde, consommation et facturation sont consultables dans le même back-office, avec des statistiques groupées par outil.

L'import en un clic via CC Switch est-il sûr ?

Oui. Le lien d'import lui-même ne contient pas la clé ; celle-ci est stockée dans vos variables d'environnement locales. Le processus : après avoir généré une clé sur HiAPI, allez sur la page API Keys et cliquez sur l'import CC Switch ; le navigateur lance CC Switch pour écrire la configuration. Si le processus graphique ne vous rassure pas, écrire manuellement settings.json et hiapi.config.toml est totalement équivalent.

Une fois les deux outils configurés, comment vérifier que la connexion fonctionne ?

Côté Claude Code, exécutez claude --version pour vérifier que le client fonctionne, puis ouvrez une session et envoyez un message, et retournez dans le back-office HiAPI voir si la consommation augmente ; côté Codex, la version CLI 0.134+ est requise ; après le lancement avec codex --profile hiapi, envoyez également une tâche et vérifiez la mesure dans le back-office. Pour la première fois, il est conseillé de lancer une petite tâche de chaque côté pour confirmer que la facturation et l'ID du modèle sont corrects, avant de passer à l'échelle.

Vaut-il la peine de connecter OpenCode et Hermes Agent ?

Cela dépend des habitudes de votre équipe. Ces deux outils utilisent le protocole Chat Completions et offrent le plus grand choix de familles de modèles ; ils conviennent aux scénarios nécessitant plusieurs familles de modèles dans un même client. Le processus de configuration est identique à celui de Claude Code / Codex, toujours sur la page /connect/agents.

Changer de modèle affecte-t-il les sessions en cours ?

La modification prend effet pour les nouvelles sessions. Une session déjà ouverte utilise le modèle chargé au démarrage ; après avoir changé la configuration, rouvrez une session, l'historique des sessions n'est pas affecté.

Conclusion clé

Que la phrase des 99 % de Karpathy refasse surface montre que l'agentic engineering n'est plus le jeu des joueurs de pointe, mais le mode de travail par défaut. Dans ce mode de travail par défaut, les utilisateurs de Claude Code et de Codex simultanément seront de plus en plus nombreux, et la fragmentation de la configuration et de la facturation est une friction réelle. La solution HiAPI consiste à connecter deux outils avec une seule clé : Claude Code utilise le protocole Messages avec le fleuron de la famille Claude, Codex utilise le protocole Responses avec la gamme GPT-6.1, chacun avec son meilleur modèle, et la facturation est consolidée. L'intégration passe par la génération de configuration sur la page /connect/agents et l'import CC Switch, opérationnelle en 5 minutes ; changer de modèle ne demande qu'une ligne de configuration, sans toucher à la clé. Router par tâche (Opus 5.5 pour les tâches difficiles, GPT-6.1 Sol/Terra pour le volume) est aujourd'hui la meilleure façon de maîtriser à la fois la qualité et la facture.