Codex

Codex est l’agent de programmation d’OpenAI. Utilisez Codex CLI dans le terminal ou gérez vos projets et tâches dans l’application de bureau. Un fournisseur de modèles personnalisé permet d’utiliser l’endpoint OpenAI Responses compatible d’AGTCloud.

Le support des appels d’outils, du raisonnement, des systèmes multiagents et de la longueur de contexte varie selon le modèle. Choisissez un modèle accessible à l’API Key et compatible Responses.

Prérequis

Avant de commencer, vérifiez que vous avez :

Préparé le terminal et le projet local à ouvrir ;
Créé un compte AGTCloud et ouvert une session ;
Créé un Token dans API Keys ;
Copié dans le catalogue de modèles un ID accessible au Token et compatible Responses.

Installer Codex

Choisissez la méthode adaptée à votre environnement.

curl -fsSL https://chatgpt.com/codex/install.sh | sh

Après l’installation, rouvrez le terminal et vérifiez la version :

codex --version

Configurer l’API Key

Codex lit l’API Key depuis la variable d’environnement définie par le Provider personnalisé. Ce tutoriel utilise AGTCLOUD_API_KEY séparément pour éviter de mélanger les clés OpenAI et celles d’autres plateformes.

Configuration temporaire

Ces paramètres s’appliquent uniquement à la session de terminal actuelle.

export AGTCLOUD_API_KEY="your-api-key"

Configuration persistante

Pour appliquer la variable à chaque ouverture du terminal, ajoutez-la au fichier de configuration du shell ou aux variables utilisateur Windows.

Éditez ~/.zshrc et ajoutez :

export AGTCLOUD_API_KEY="your-api-key"

Enregistrez, puis rechargez :

source ~/.zshrc

N’inscrivez pas l’API Key dans config.toml

config.toml conserve seulement le nom de la variable. L’API Key est enregistrée en clair dans l’environnement local : utilisez cette méthode uniquement sur un appareil personnel fiable.

Configurer le Provider AGTCloud

La configuration utilisateur de Codex se trouve dans ~/.codex/config.toml. Si le fichier existe, sauvegardez-le, puis fusionnez le Provider AGTCloud dans la configuration existante sans écraser les autres paramètres.

mkdir -p ~/.codex

if [[ -f ~/.codex/config.toml ]]; then
    cp ~/.codex/config.toml ~/.codex/config.toml.backup
fi

Ajoutez dans ~/.codex/config.toml :

model_provider = "agtcloud"
model = "MODEL_ID"

[model_providers.agtcloud]
name = "AGTCloud"
base_url = "https://api.agtcloud.cn/v1"
env_key = "AGTCLOUD_API_KEY"
wire_api = "responses"

Paramètre	Rôle
`model_provider`	Définir AGTCloud comme fournisseur de modèles par défaut
`model`	Définir l’ID du modèle utilisé par Codex
`base_url`	Envoyer les requêtes Responses à l’adresse API AGTCloud affichée ici
`env_key`	Définir le nom de la variable contenant l’API Key
`wire_api`	Sélectionner le protocole OpenAI Responses

Placez le Provider dans la configuration utilisateur

Le .codex/config.toml du projet peut enregistrer les paramètres du projet, mais pas remplacer model_provider et model_providers. Placez la configuration ci-dessus dans ~/.codex/config.toml du répertoire utilisateur.

Choisir un modèle

MODEL_ID est une valeur fictive à remplacer. Copiez dans le catalogue de modèles un ID accessible à l’API Key et compatible Responses, puis remplacez MODEL_ID dans config.toml.

Dans Codex CLI, /model permet de consulter ou de changer le modèle. La sélection sous un Provider personnalisé dépend de la version et de l’API Key ; si le modèle est absent, modifiez directement model dans config.toml.

Utiliser Codex CLI

Ouvrir le répertoire du projet

cd /path/to/your/project

Démarrer Codex

codex

Vérifier la configuration actuelle

Exécutez dans Codex :

/status

Vérifiez le Provider, le modèle et le fichier de configuration. La Base URL doit être l’adresse API avec /v1 affichée ici, sans /v1/v1.

Effectuer un test en lecture seule

Dans un projet de test contenant README.md, saisissez :

Veuillez lire README.md et résumer l’objectif de ce projet en trois points. Ne modifiez aucun fichier.

Une réponse normale confirme la connexion de base. Cette étape entraîne une consommation API normale.

Utiliser Codex App

Redémarrer l’application

Après avoir enregistré ~/.codex/config.toml et les variables, quittez complètement puis rouvrez Codex App.

Ouvrir un projet local

Passez à Codex dans l’application de bureau et choisissez un projet de test sans code sensible.

Vérifier le modèle et valider

Vérifiez que le modèle correspond à config.toml, puis utilisez la même tâche README en lecture seule que dans la CLI.

Le chargement des variables dépend de la version et du démarrage de l’application

Codex App réutilise la configuration locale de Codex, mais le chargement des variables du shell varie selon la version et le système. Si la CLI fonctionne mais que l’application ne lit pas l’API Key, redémarrez complètement l’application, puis vérifiez la configuration et les variables utilisateur.

Questions fréquentes

Symptôme	Vérifier en priorité	Solution
Commande `codex` introuvable	Installation et `PATH`	Rouvrez le terminal, exécutez `codex --version` et, si nécessaire, relancez l’installation officielle
API Key non chargée	`AGTCLOUD_API_KEY` active dans le processus	Rouvrez le terminal ou l’application et rechargez l’environnement utilisateur
Provider non appliqué	Configuration placée par erreur dans le `.codex/config.toml` du projet	Déplacez `model_provider` et `model_providers` vers `~/.codex/config.toml`
Chemin contenant `/v1/v1`	Ajout supplémentaire à `base_url`	Utilisez directement `https://api.agtcloud.cn/v1` affiché ici
Réponse `401`	API Key et variables	Utilisez une API Key valide et vérifiez le nom `env_key`
Réponse `403`	Autorisations du Token et du modèle, état du compte	Vérifiez le Token et les modèles accessibles dans la console
Réponse `404`	Base URL, endpoint Responses et ID du modèle	Vérifiez `base_url` et recopiez l’ID d’un modèle accessible à la clé
Modèle inexistant ou indisponible	Visibilité et support de Responses	Copiez l’ID complet dans le catalogue et choisissez un modèle accessible à la clé
La CLI fonctionne, mais pas la configuration de l’application	Version, chemin de configuration et variables	Redémarrez complètement l’application ; validez d’abord la même configuration utilisateur dans la CLI
Certaines capacités avancées sont indisponibles	Capacités du modèle et adaptation actuelle	Validez d’abord une tâche de base en lecture seule ; les capacités avancées dépendent des résultats effectifs

En cas de problème non identifié, consignez l’heure, l’API Base URL, l’ID du modèle, le code HTTP et l’erreur expurgée, puis consultez Erreurs et dépannage. Ne fournissez pas d’API Key complète.

Conseils de sécurité

Créez une API Key distincte pour Codex afin de gérer les autorisations et la désactivation.
N’inscrivez pas de véritable clé dans config.toml, le code, un dépôt, une capture d’écran, un journal ou un script partagé.
Sur un appareil partagé ou en équipe, privilégiez le gestionnaire d’identifiants du système ou la distribution centralisée des secrets.
En cas de fuite présumée, désactivez ou supprimez immédiatement l’API Key dans la console, puis créez-en une nouvelle.

Consultez ensuite API Key, Base URL et authentification, OpenAI Responses et Erreurs et dépannage.

Sur cette page