Skip to main content
Codex est l’agent de code d’OpenAI, en trois formes : Codex CLI dans le terminal, l’extension Codex dans VS Code et l’app Codex. Les trois lisent le même dossier ~/.codex, donc une configuration les couvre tous.

Installation en une commande

Remplacez sk-xxx par votre clé, ouvrez un terminal, collez et appuyez sur Entrée. Le script vérifie la clé, liste tous les modèles que la clé peut appeler et vous laisse choisir (Entrée = recommandé : gpt-astra pour Astra, gpt-5.6-sol pour GPT, claude-opus-5 pour Claude), installe Codex CLI et écrit la configuration.
Le script demande d’abord la langue (1 = vietnamien, 2 = anglais ; passez avec --lang en ou --lang vi). Sans --key, il demande la clé. Pour forcer un modèle, ajoutez --model gpt-astra ou --model gpt-5.6-sol.
Lisez la source avant d’exécuter si vous le souhaitez : codex.sh, codex.ps1. Le script ne s’exécute que sur votre machine et n’envoie la clé qu’à gpt.teamsoclo.site pour vérification.

Ce que fait le script

  1. Vérifie la clé auprès de la passerelle et choisit le modèle de votre forfait ; une clé invalide arrête tout sans toucher à votre machine.
  2. Sauvegarde votre config.toml existant, s’il y en a un, en config.toml.bak.<horodatage>.
  3. Écrit ~/.codex/config.toml : modèle gpt-5.6-sol (ou gpt-astra), passerelle TeamSocLo, Responses API.
  4. Stocke la clé dans la variable d’environnement TEAMSOCLO_API_KEY (dans ~/.zshrc / ~/.bashrc, ou en variable utilisateur sous Windows). La clé n’est pas dans le fichier de configuration, vous pouvez donc partager config.toml sans la divulguer.
  5. Installe ou met à jour Codex CLI avec npm install -g @openai/codex. Sans Node.js, le script s’arrête et indique comment l’installer.
Relancez-le quand vous voulez pour changer de clé ou de forfait ; l’ancienne configuration est toujours sauvegardée d’abord.
Vous préférez éviter le terminal ? TeamSocLo Key Tool est une app Windows et macOS : collez votre clé une fois pour configurer Codex, Claude Code et plus de 20 autres outils.

Après l’installation

1

Ouvrez un nouveau terminal, lancez codex

L’ancien terminal n’a pas chargé la nouvelle variable ; ouvrez un nouvel onglet. Posez une question à Codex pour vérifier.
2

VS Code : installez l’extension, quittez complètement, rouvrez

VS Code → Extensions → cherchez Codex (OpenAI’s coding agent) → Install. Puis quittez VS Code complètement : macOS Cmd + Q, Windows fermez toutes les fenêtres. Reload Window ne suffit pas ; l’extension ne lit la configuration qu’au démarrage du processus.
3

App Codex

Rouvrez l’app après la commande. Sous macOS la commande a défini la variable pour les apps graphiques via launchctl ; sous Windows setx s’applique aux apps lancées ensuite.
Aucune connexion OpenAI n’est nécessaire. requires_openai_auth = false indique à Codex d’utiliser la clé de la passerelle depuis la variable d’environnement.

Configuration manuelle

Si vous préférez éditer vous-même, ~/.codex/config.toml (Windows : %USERPROFILE%\.codex\config.toml) doit contenir exactement :
et la variable d’environnement TEAMSOCLO_API_KEY doit contenir votre clé.
Gardez wire_api = "responses". Codex parle la Responses API ; passer à chat casse tout.
Ouvrir rapidement le dossier de configuration :

Changer de modèle

Le forfait GPT Astra utilise gpt-astra. Modifiez la première ligne de config.toml et redémarrez Codex :
Une clé GPT appelant gpt-astra obtient « no available channel », et inversement. Le modèle suit le forfait acheté, voir Modèles et forfaits.

Désinstaller

Pour garder Codex mais revenir à votre configuration précédente, recopiez config.toml.bak.<horodatage> par-dessus config.toml.

Si ça ne marche pas

  • Vous avez ouvert un nouveau terminal ou quitté VS Code complètement après l’installation.
  • echo $TEAMSOCLO_API_KEY (Windows : echo %TEAMSOCLO_API_KEY% dans cmd) affiche la clé entière.
  • base_url se termine par /v1, wire_api vaut responses.
  • La clé est valide et a du quota : vérifier ici.
  • Sinon voir le Dépannage, qui a une section Codex.