Aller au contenu principal

Codex App + CLI

Codex App et CLI partagent une configuration Provider locale et se connectent à PopGo API via le wire API Responses.

Avant de configurer​

  • Cette page utilise seulement des espaces réservés. Copiez la vraie Key depuis les clés API PopGo et le modèle depuis les modèles et tarifs.
  • La configuration en un clic concerne les logiciels déjà installés avec un gestionnaire de protocole enregistré. Autorisez le navigateur à ouvrir l’application externe quand il le demande.
  • En configuration manuelle, enregistrez d’abord un Provider minimal. Activez streaming, outils ou routage multi-modèles après le premier succès.

Source officielle et vérification​

Cette page a été vérifiée le 2026-07-14 avec la source officielle de Codex App + CLI 0.144.4. Source officielle. La vérification couvre la structure Provider officielle et la configuration locale partagée par App et CLI.

Configuration en un clic​

Connectez-vous à la page des clés PopGo API et ouvrez le menu d'actions de la ligne Key visée. La documentation publique ne crée ni n'affiche de lien contenant une Key. Choisissez CC Switch, puis Codex. Après l'import, vérifiez que la Base URL s'arrête à /v1 ; App et CLI lisent la même configuration locale.

Configuration manuelle​

Définissez POPGO_API_KEY dans le terminal, puis ajoutez le bloc Provider ci-dessous au fichier Codex ; App et CLI ne nécessitent pas deux configurations.

export POPGO_API_KEY="YOUR_API_KEY"
$env:POPGO_API_KEY = "YOUR_API_KEY"
model = "YOUR_MODEL"
model_provider = "popgo"

[model_providers.popgo]
name = "PopGo"
base_url = "https://api.popgo.site/v1"
env_key = "POPGO_API_KEY"
wire_api = "responses"
  • Le fichier de configuration se trouve généralement dans .codex/config.toml sous le dossier utilisateur : %USERPROFILE%\.codex\config.toml sur Windows et ~/.codex/config.toml sur macOS/Linux.
  • La Key est lue via POPGO_API_KEY. N’écrivez pas de vraie Key dans config.toml ni dans une capture publique.

Installation et configuration multiplateforme​

  1. Vérifiez node --version et npm --version, puis installez le CLI avec la méthode officielle de Codex.
  2. Le fichier de configuration se trouve généralement dans %USERPROFILE%\.codex\config.toml sous Windows ou ~/.codex/config.toml sous macOS/Linux.
  3. Définissez POPGO_API_KEY dans le même terminal que celui qui lance Codex. N’écrivez pas de vraie Key dans le fichier :
$env:POPGO_API_KEY = "YOUR_API_KEY"

Utilisez l’ID actuel pour model. model_provider doit correspondre au bloc Provider, env_key doit être POPGO_API_KEY et wire_api doit être responses. Redémarrez l’App ou le CLI après modification.

Critère de réussite​

Démarrez le CLI depuis le terminal configuré ou rouvrez l'App, puis envoyez une requête avec YOUR_MODEL.

Erreurs courantes et récupération​

  • Si la Key est absente, vérifiez le nom exact POPGO_API_KEY, puis redémarrez le CLI ou rouvrez l'App.
  • Pour un statut 401, recollez YOUR_API_KEY après avoir retiré les espaces.
  • Pour un statut 404, vérifiez le niveau de Base URL et que le client n'ajoute pas /v1 deux fois.