Passer de Claude Code à Codex : le guide complet de migration 2026 (avec configuration des relais d'API)

En juin 2026, un événement a bouleversé les habitudes de nombreux développeurs : les modèles phares d'Anthropic, Fable 5 et Mythos 5, se sont retrouvés hors service du jour au lendemain pour les utilisateurs du monde entier en raison de restrictions à l'export — une interdiction qui a duré 20 jours pleins. Même si elle a été levée en juillet, cet épisode a mis en évidence un risque bien réel : lier tout son flux de travail à un seul outil coûte cher quand les choses tournent mal. À la même période, OpenAI Codex a livré une vague de mises à jour majeures en juin — Codex Remote est passé en disponibilité générale, la surveillance mobile a été lancée, et l'intégration à Amazon Bedrock est arrivée — faisant passer le nombre de développeurs actifs hebdomadaires de 3 à 5 millions. Cet article rassemble toutes les étapes clés pour migrer de Claude Code vers Codex, y compris la configuration des relais qui compte le plus pour les développeurs hors des États-Unis.

Pourquoi de plus en plus de développeurs migrent-ils vers Codex ?

Les motivations varient d'un développeur à l'autre, mais elles se résument généralement à quatre choses :

Avant de basculer : les différences essentielles entre Claude Code et Codex

Les données racontent une seule histoire claire : GPT-5.5 devance légèrement sur SWE-bench Verified, mais sur le SWE-bench Pro plus difficile, Claude Opus 4.8 est en tête d'environ 6 %. Chaque outil a ses propres forces — nous verrons plus loin comment faire tourner les deux ensemble.

Étape 1 : installer Codex

Il existe deux façons d'installer Codex — choisissez celle qui correspond à votre façon de travailler.

Option A : Codex CLI (terminal, l'expérience la plus proche de Claude Code)

# Installation (nécessite Node.js 18+)
npm install -g @openai/codex

# Vérifier l'installation
codex --version

Une fois installé, exécuter codex pour la première fois vous invite à vous connecter — vous pouvez utiliser un compte ChatGPT (Plus/Pro/Business/Enterprise fonctionnent tous) ou saisir directement une clé API OpenAI.

Option B : l'app de bureau Codex (interface graphique, avec migration automatique intégrée)

Téléchargez l'installateur macOS/Windows depuis openai.com/codex. L'app de bureau intègre une fonctionnalité « importer la configuration d'un autre agent » (Settings → Import agent setup) qui scanne automatiquement votre configuration Claude Code et migre les Skills, les Hooks, la configuration MCP et 30 jours d'historique de session.

Étape 2 : configurer votre clé API

Accéder à l'API officielle d'OpenAI depuis certaines régions nécessite généralement un proxy. Il existe deux chemins ici : la connexion directe (nécessite un VPN) ou un relais (connexion directe, sans VPN).

Option A : connexion directe à l'API officielle d'OpenAI (nécessite un proxy)

# macOS / Linux — ajoutez ceci à ~/.zshrc pour le rendre permanent
export OPENAI_API_KEY=sk-votre-cle-api-openai

# Rechargez
source ~/.zshrc

# Lancez Codex
codex

# Windows PowerShell
$env:OPENAI_API_KEY="sk-votre-cle-api-openai"

# Ou définissez-la de façon permanente comme variable d'environnement système :
# Propriétés système → Avancé → Variables d'environnement → Nouvelle : OPENAI_API_KEY

Option B : accès via un relais d'API (connexion directe, sans VPN nécessaire)

C'est l'option la plus pratique pour les développeurs hors des États-Unis. Les relais prenant en charge GPT-5.5 (codex-1) ne nécessitent que deux variables d'environnement — le reste de la configuration est identique à l'Option A :

# macOS / Linux
export OPENAI_API_KEY=votre-cle-api-du-relais
export OPENAI_BASE_URL=https://votre-domaine-relais.com/v1

source ~/.zshrc
codex

# Windows PowerShell
$env:OPENAI_API_KEY="votre-cle-api-du-relais"
$env:OPENAI_BASE_URL="https://votre-domaine-relais.com/v1"

Points essentiels à vérifier au moment de choisir un relais :

• Support explicite de GPT-5.5 / codex-1 : Codex utilise le modèle codex-1 (une variante de GPT-5.5 spécialement ajustée pour l'agentique) — le relais doit l'avoir dans sa liste de modèles
• Format OpenAI (/v1/chat/completions) : Codex parle le protocole OpenAI, donc vérifiez que le chemin d'API du relais est compatible avec le SDK OpenAI standard
• Nœuds en connexion directe : privilégiez les relais avec des nœuds optimisés pour votre région, pour réduire les délais de connexion, par exemple sur un réseau de bureau
• Function calling stable : le mode agentique de Codex s'appuie fortement sur les appels d'outils — si un relais gère mal cela, le comportement de l'agent sera erratique

Vous pouvez filtrer notre comparatif des relais d'API IA pour trouver les relais dont la « couverture de modèles » inclut GPT-5.5 — la plupart des relais listés ont été vérifiés comme compatibles avec le protocole de Codex.

Étape 3 : migrer CLAUDE.md → AGENTS.md

Claude Code stocke les instructions IA au niveau projet dans CLAUDE.md ; l'équivalent chez Codex est AGENTS.md. Le point de départ le plus simple est une copie directe :

# Depuis la racine de votre projet
cp CLAUDE.md AGENTS.md

Cela dit, une simple copie n'est qu'un point de départ. Il existe des différences sémantiques importantes entre les deux fichiers — après la migration, vérifiez les points suivants :

Étape 4 : reconfigurer les serveurs MCP

MCP est un standard ouvert, pris en charge à la fois par Claude Code et Codex, donc les serveurs eux-mêmes n'ont pas besoin d'être modifiés. Ce qui change, c'est le format du fichier de configuration de connexion : JSON pour Claude Code, TOML pour Codex.

Configuration MCP de Claude Code (JSON, généralement dans ~/.claude/settings.json) :

{
  "mcpServers": {
    "my-server": {
      "command": "npx",
      "args": ["-y", "@myorg/mcp-server"],
      "env": {
        "MY_API_KEY": "sk-xxx"
      }
    }
  }
}

Migrée vers le format TOML de Codex (~/.codex/config.toml) :

[mcp_servers.my-server]
command = "npx"
args = ["-y", "@myorg/mcp-server"]

[mcp_servers.my-server.env]
MY_API_KEY = "sk-xxx"

Étape 5 : vérifier le flux de travail de base de Codex

Une fois configuré, suivez ces étapes pour vérifier que Codex fonctionne correctement :

# 1. Lancez Codex dans un vrai répertoire de projet
cd ~/votre-projet
codex

# 2. Vérifiez la configuration actuelle
/model        # Confirmez que le modèle est correct (devrait afficher gpt-5.5 / codex-1)

# 3. Testez avec une petite tâche (utilisez d'abord --dry-run pour prévisualiser sans exécuter)
codex --dry-run "Trouve tous les commentaires TODO codés en dur sous src/ et liste les noms de fichiers"

# 4. Vérifiez que le tool calling fonctionne (vérification MCP)
# Si vous avez un serveur MCP installé, demandez à Codex d'appeler un outil MCP
# en conversation et vérifiez qu'il répond correctement

Erreurs courantes en passant par un relais

Si vous rencontrez des problèmes en vous connectant via un relais, vérifiez d'abord ces points :

1. 401 Unauthorized : OPENAI_API_KEY est incorrecte, ou le format de clé du relais n'est pas compatible avec le standard OpenAI. Vérifiez que la clé commence par le bon préfixe et consultez la documentation du relais pour les exigences de format de clé.
2. 404 / model not found : le relais ne prend pas en charge codex-1 ou gpt-5.5 comme identifiant de modèle. Essayez de spécifier le modèle manuellement au lancement de Codex : codex --model gpt-5.5, ou contactez le relais pour confirmer l'identifiant de modèle exact attendu.
3. Échec du parsing des tool calls / comportement erratique de l'agent : le relais a des problèmes pour transmettre correctement les appels d'outils. Passez à un relais avec un meilleur support du function calling, ou repassez temporairement en mode conversation simple (sans tool call) pour vérifier si le relais est en cause.
4. Les variables d'environnement ne prennent pas effet : vous avez édité ~/.zshrc mais oublié d'exécuter source ~/.zshrc, ou vous avez modifié des variables dans une session de terminal déjà ouverte sans la redémarrer. Ouvrez un nouvel onglet de terminal et exécutez echo $OPENAI_BASE_URL pour vérifier que la variable est chargée.

Codex Remote : envoyer les tâches longues dans le cloud

C'est le plus grand facteur de différenciation de Codex face à Claude Code. Codex Remote (en disponibilité générale depuis juin 2026) permet de :

• Soumettre une tâche depuis l'app web ChatGPT ou l'app mobile, fermer son ordinateur portable, et la laisser continuer à s'exécuter dans le bac à sable cloud isolé d'OpenAI
• Recevoir les résultats automatiquement sous forme de pull request sur votre dépôt GitHub — il ne vous reste qu'à réviser et merger
• Exécuter plusieurs tâches en parallèle sans qu'elles se bloquent mutuellement ni consomment les ressources de votre machine locale
• Utiliser l'app mobile (bêta publique iOS depuis le 29 juin) pour soumettre des tâches pendant vos trajets, recevoir des notifications de PR, et réviser du code à distance

Un cas d'usage typique : avant de partir le soir, confiez « écris les tests unitaires pour la fonctionnalité X » à Codex Remote, et le lendemain matin une PR vous attend déjà pour révision — sans que votre machine n'ait jamais eu besoin de rester allumée.

# Connectez votre dépôt GitHub (autorisation unique)
codex connect github

# Soumettez une tâche en arrière-plan
codex remote "Ajoute des commentaires JSDoc à toutes les fonctions sous src/auth/, avec des annotations de type complètes"

# Vérifiez le statut de la tâche
codex remote status

# Listez les PR en attente de révision
codex remote prs

Vous n'avez pas à choisir : faire tourner Claude Code + Codex ensemble est la meilleure configuration

Le consensus communautaire le plus net de ces six derniers mois est le suivant : les développeurs les plus productifs utilisent les deux outils, en routant les tâches selon leurs caractéristiques.

En pratique, beaucoup d'équipes réservent Claude Code aux sessions interactives et de réflexion approfondie, utilisent Codex (surtout Remote) pour le travail par lots en arrière-plan et la génération automatisée de PR, et gèrent les clés et quotas des deux côtés via un seul relais d'API.

Ce que vous perdez après la bascule — à savoir à l'avance

Résumé

Migrer vers Codex n'est pas une opération en un clic, mais c'est moins compliqué qu'il n'y paraît. Il n'y a vraiment que quatre étapes centrales : installer la CLI → configurer votre clé API (les utilisateurs de relais définissent OPENAI_BASE_URL) → renommer et ajuster légèrement CLAUDE.md en AGENTS.md → réécrire votre configuration MCP de JSON vers TOML. Donnez-lui 30 minutes et Codex est opérationnel — vous pourrez l'affiner au fur et à mesure.

Le point le plus important à retenir : vous n'avez pas à désinstaller Claude Code. Chaque outil a ses propres forces, et faire tourner les deux est la configuration la plus productive en 2026. Ajouter Codex à votre chaîne d'outils signifie que lorsqu'un outil subit une interdiction, une panne ou épuise son quota, l'autre peut prendre le relais — une décision d'ingénierie plus précieuse que l'optimisation autour d'un seul outil.

Sources

• How to Switch from Claude Code to OpenAI Codex: The Complete Developer Guide (2026) – Medium / Software Mind
• Switching from Claude Code to OpenAI Codex – Awesome Agents
• From Claude Code to Codex: A Practical Migration Guide for Developers in 2026 – Pasquale Pillitteri
• Claude Code to Codex Migration Guide 2026 – Blake Crosley
• Claude Code to Codex Migration: One-Click Import Guide – MindWiredAI
• Claude Code vs Codex: Which AI Coding Agent Should You Use in 2026? – Firecrawl
• Codex vs Claude Code (June 2026): Benchmarks, Subagents & Limits Compared – MorphLLM
• AI Coding Costs (2026): Claude vs Codex vs Gemini, Real Monthly Spend – MorphLLM
• Claude Code vs Codex: What I Learned After 100+ Hours With Both (2026) – Composio
• Claude Code vs OpenAI Codex: $20/mo Each but OpenAI Claims 4x Better Efficiency – SpectrumAILab
• Codex vs Claude Code in June 2026: The Fable 5 Era Rematch – Developers Digest
• Claude Code vs Codex App in 2026: Local Agent Pairing vs Cloud Agent Orchestration – Developers Digest
• Codex vs Claude Code: Which AI Coding Agent Should You Use in 2026? – MindStudio
• Codex vs. Claude Code: Context Window, Token Efficiency, and Which Lasts Longer – MindStudio
• Sync Codex and Claude Code configs: skills, agents, MCP, permissions – OpenAI Developer Community
• OpenAI Codex Step by Step Guide: Setup, Claude Code, and Cost in 2026 – GenAI Unplugged
• Codex Quickstart – OpenAI Developers (documentation officielle)
• Codex Environment Variables – OpenAI Developers (documentation officielle)
• Codex débloqué : guide complet pour accéder à OpenAI Codex via un relais d'API auto-hébergé – Kejilion
• Claude Code, Codex, OpenClaw : comment je les ai fait travailler ensemble – Wang Shuyi