Guide d'utilisation de Codex

Le flux recommandé consiste à vous connecter d'abord avec votre propre compte Codex, afin que Codex conserve l'accès aux plugins, à MCP et aux capacités Agent. Configurez ensuite le mode token de Magick API pour router les requêtes de modèles via Magick API. Le CLI Codex et l'application de bureau partagent la même configuration locale.

1. Installer Codex CLI et se connecter

Si Codex CLI n'est pas encore installé, installez-le d'abord :

npm i -g @openai/codex

Démarrez Codex :

codex

Au premier lancement, Codex vous guidera dans l'autorisation de votre compte. Terminez cette étape avant de configurer le mode token de Magick API afin de conserver plus facilement les plugins et les outils locaux.

2. Configurer le mode token de Magick API

Codex prend en charge les protocoles compatibles OpenAI. Vous pouvez donc pointer les requêtes de modèles vers Magick API avec des variables d'environnement.

Récupérez d'abord votre clé Magick API sur la page de gestion des API Keys.

macOS/Linux

Pour appliquer la configuration uniquement au terminal courant :

export OPENAI_API_KEY="sk-your magickapi key"
export OPENAI_BASE_URL="https://api.magickapi.com/v1"

Pour une configuration persistante, ajoutez les variables à ~/.zshrc ou ~/.bashrc :

echo 'export OPENAI_API_KEY="sk-your magickapi key"' >> ~/.zshrc
echo 'export OPENAI_BASE_URL="https://api.magickapi.com/v1"' >> ~/.zshrc
source ~/.zshrc

Si vous utilisez Bash, remplacez ~/.zshrc par ~/.bashrc.

Windows PowerShell

setx OPENAI_API_KEY "sk-your magickapi key"
setx OPENAI_BASE_URL "https://api.magickapi.com/v1"

Après setx, rouvrez le terminal avant de lancer Codex.

3. Conserver les plugins Codex disponibles

Lorsque vous utilisez une API Key ou une base URL tierce compatible OpenAI, certaines versions de Codex peuvent masquer ou désactiver des plugins comme GitHub, le contrôle Chrome, les outils Browser ou les outils liés aux Agents. Vous pouvez activer explicitement les plugins dans le fichier de configuration Codex.

Chemin du fichier de configuration :

• macOS/Linux : ~/.codex/config.toml
• Windows : %userprofile%\.codex\config.toml

Ajoutez le contenu suivant à la fin du fichier :

[plugins."github@openai-curated"]
enabled = true

[plugins."chrome@openai-bundled"]
enabled = true

[plugins."browser@openai-bundled"]
enabled = true

Si vous utilisez d'autres plugins, vous pouvez continuer à les activer un par un par nom de plugin. Si votre version actuelle de Codex prend en charge un interrupteur global pour les plugins, vous pouvez aussi ajouter :

[plugins]
enabled = true

Si le fichier de configuration contient déjà des paramètres MCP ou d'autres plugins, conservez le contenu existant et ajoutez seulement les entrées d'activation ci-dessus.

4. Redémarrer et vérifier

Après avoir enregistré la configuration, redémarrez Codex :

codex restart

Vous pouvez aussi quitter la session Codex actuelle puis relancer :

codex

Dans le mode interactif de Codex, saisissez :

/plugins

Vérifiez que les plugins GitHub, Chrome, Browser, MCP ou liés aux Agents restent disponibles. Lorsque vous appelez des modèles GPT, Codex lit OPENAI_API_KEY et OPENAI_BASE_URL, puis envoie les requêtes à Magick API via https://api.magickapi.com/v1.

Alternative : écrire la configuration du provider Codex

Si vous préférez ne pas dépendre des variables d'environnement, vous pouvez écrire Magick API dans la configuration provider de Codex.

Chemin du fichier de configuration :

• macOS/Linux : ~/.codex/config.toml
• Windows : %userprofile%\.codex\config.toml

model_provider = "OpenAI"
model = "gpt-5.5"
review_model = "gpt-5.5"
model_reasoning_effort = "xhigh"
disable_response_storage = true
network_access = "enabled"
windows_wsl_setup_acknowledged = true
model_context_window = 1000000
model_auto_compact_token_limit = 900000

[model_providers.OpenAI]
name = "OpenAI"
base_url = "https://api.magickapi.com/v1"
wire_api = "responses"
requires_openai_auth = true

Écrivez ensuite l'API Key dans le fichier d'authentification.

Chemin du fichier d'authentification :

• macOS/Linux : ~/.codex/auth.json
• Windows : %userprofile%\.codex\auth.json

{
  "OPENAI_API_KEY": "Clé générée dans le panneau d'administration"
}

Remarques

• Pour OPENAI_API_KEY, renseignez la clé générée dans le panneau d'administration de l'API Magick
• OPENAI_BASE_URL ou le base_url du provider doit être défini sur https://api.magickapi.com/v1
• Le mode token sert uniquement à router les requêtes de modèles vers Magick API. L'autorisation du compte Codex permet de conserver les capacités propres à Codex, les plugins et l'expérience des outils
• Dans ce document, model et review_model utilisent tous deux gpt-5.5, vous pouvez les remplacer par les modèles disponibles dans la [Place de marché des modèles]