Guide d’installation hors ligne de Codex CLI

Guide d’installation hors ligne de Codex CLI sur Windows et macOS, avec la structure du bundle, les scripts de configuration, les problèmes fréquents et la préparation d’une API key plus économique.

Ce guide vise les nouveaux utilisateurs qui veulent installer Codex CLI sans dépendre d’un réseau externe stable, puis l’utiliser immédiatement après la configuration.

À qui s’adresse ce guide

Aux personnes qui veulent essayer le Vibe Coding sans connexion solide

Aux nouveaux utilisateurs de Codex CLI qui veulent un parcours d’installation propre

Aux équipes qui ont besoin d’un bundle offline portable pour des collègues ou amis

Préparer avant l’installation

L’ordinateur cible doit déjà disposer de Node.js et npm. Vérifiez-les d’abord dans le terminal.

node -v
npm -v

Structure du bundle

Le bundle offline est séparé par plateforme : windows-x64, macos-arm64 et macos-x64. Chaque dossier contient le paquet principal, le runtime de plateforme, les scripts d’installation et de configuration.

Identifier la plateforme avant tout

Windows

La plupart des PC Windows classiques utilisent windows-x64.

macOS

Utilisez macos-arm64 pour Apple Silicon et macos-x64 pour les Mac Intel. Sur macOS, uname -m permet de vérifier.

uname -m

Étapes d’installation Windows x64

Étape 1 : entrer dans le dossier offline

cd "your-path\codex-npm-offline\windows-x64\npm-offline"

Étape 2 : lancer le script d’installation

.\install-codex-windows-x64.cmd

Étape 3 : installer manuellement si besoin

npm install -g .\codex-npm-0.121.0-alpha.6.tgz @openai/codex-win32-x64@file:.\codex-npm-win32-x64-0.121.0-alpha.6.tgz

Étape 4 : vérifier que l’installation a réussi

codex --version

Exécuter le script de configuration

.\run-codex-setup.cmd

Après l’installation, le script de configuration demandera la Base URL et l’API key.

Il écrit la configuration dans les fichiers principaux de Codex et crée généralement une sauvegarde avant d’écraser un fichier existant.

~/.codex/config.toml
~/.codex/auth.json

Installation macOS Apple Silicon

cd "/your-path/codex-npm-offline/macos-arm64/npm-offline"
bash ./install-codex-macos-arm64.sh

Si vous préférez l’installation manuelle, utilisez npm pour installer le paquet principal et le paquet spécifique à la plateforme.

npm install -g ./codex-npm-0.121.0-alpha.6.tgz @openai/codex-darwin-arm64@file:./codex-npm-darwin-arm64-0.121.0-alpha.6.tgz

Installation macOS Intel

cd "/your-path/codex-npm-offline/macos-x64/npm-offline"
bash ./install-codex-macos-x64.sh

npm install -g ./codex-npm-0.121.0-alpha.6.tgz @openai/codex-darwin-x64@file:./codex-npm-darwin-x64-0.121.0-alpha.6.tgz

Problèmes fréquents

Commande codex introuvable après installation

Fermez le terminal actuel, ouvrez-en un nouveau, puis relancez codex --version.

Windows bloque le script

Passez par le script de configuration, car il appelle PowerShell avec ExecutionPolicy Bypass.

macOS indique que le script n’est pas exécutable

Lancez les scripts shell directement via bash plutôt qu’en double-cliquant.

Comment obtenir une API key stable et économique

Si vous avez encore besoin d’une clé fournisseur, inscrivez-vous, comparez groupes et prix, créez un API token, puis recopiez Base URL et API key dans la configuration.

Chemin d’usage le plus court

Installer le bon paquet pour la plateforme

Lancer le script de configuration et saisir Base URL et API key

Démarrer Codex avec codex ou utiliser codex --yolo pour un mode plus direct

codex
codex --yolo