Codex CLI : configuration de la clé API et d’un fournisseur personnalisé

Ce guide vous permet de connecter votre travail local dans Codex CLI à AI Prime Tech. Vous avez besoin d’un compte sur la passerelle, d’une clé active dans le groupe Codex prévu et d’un modèle accessible avec cette clé. Commencez par la présentation de l’API Codex si vous êtes encore en train de choisir un type d’accès.

1. Vérifier la clé et le groupe

Créez une clé dans le tableau de bord. L’accès prépayé à GPT utilise le Codex groupe. Si un accès Codex à durée limitée est proposé, utilisez le groupe et les conditions indiqués pour ce forfait ; l’accès à Claude est distinct. Vérifiez la liste des modèles disponibles avec la clé que vous utiliserez.

Définissez la clé dans le terminal actuel. Remplacez la valeur fictive localement ; n’enregistrez pas la clé dans un dépôt.

PowerShell

$env:AIPRIMETECH_API_KEY = "YOUR_GATEWAY_KEY"

bash ou zsh

export AIPRIMETECH_API_KEY="YOUR_GATEWAY_KEY"

Redémarrez tout terminal ou éditeur lancé avant la définition de son environnement s’il ne détecte pas la variable. Ces exemples la définissent pour le processus actuel et ses processus enfants.

2. Configurer le fournisseur

Intégrez cette configuration à votre fichier utilisateur ~/.codex/config.toml. Sous Windows, le chemin équivalent est %USERPROFILE%\.codex\config.toml. Les identifiants du fournisseur doivent figurer dans la configuration utilisateur, et non dans le fichier du dépôt .codex/config.toml.

model_provider = "aiprimetech"
model = "gpt-6.1-sol"

[model_providers.aiprimetech]
name = "AI Prime Tech"
base_url = "https://aiprimetech.io/v1"
env_key = "AIPRIMETECH_API_KEY"
wire_api = "responses"
supports_websockets = false

Utilisez un identifiant de fournisseur tel que aiprimetech et veillez à ce que model_provider corresponde à sa table. La version actuelle de Codex utilise le protocole Responses. L’URL de base est la racine de la passerelle /v1 ; Codex ajoute le chemin de la requête. Cette configuration utilise le transport HTTP/SSE.

3. Vérifier la connexion

Exécutez codex doctor pour examiner votre configuration CLI. Lancez codex, puis utilisez /status pour confirmer le fournisseur et le modèle. Demandez une réponse courte avant d’autoriser une tâche plus importante sur le dépôt. Vérifiez que la requête apparaît sur votre page d’utilisation AI Prime Tech.

Vous pouvez consulter la liste des modèles accessibles avec la clé indépendamment de Codex :

Invoke-RestMethod -Uri "https://aiprimetech.io/v1/models" -Headers @{Authorization="Bearer $env:AIPRIMETECH_API_KEY"}

curl --fail-with-body https://aiprimetech.io/v1/models \
  -H "Authorization: Bearer $AIPRIMETECH_API_KEY"

Si le catalogue renvoyé contient votre modèle mais que la requête échoue, vérifiez l’erreur exacte et la disponibilité actuelle du groupe. La présence d’un identifiant dans la liste ne suffit pas à valider un test d’inférence.

Conserver un profil CLI facultatif

Pour sélectionner ce fournisseur uniquement pour certaines sessions CLI, placez la configuration ci-dessus dans ~/.codex/aiprimetech.config.toml et lancez :

codex --profile aiprimetech

À partir de Codex 0.134.0, les profils CLI utilisent des fichiers distincts. Les anciens exemples [profiles.aiprimetech] ne correspondent pas au format actuel des profils. L’extension IDE utilise la configuration utilisateur ; vérifiez son fournisseur actif après l’avoir redémarrée, plutôt que de supposer que le changement de profil CLI s’y est appliqué.

Choisir un modèle

Utilisez gpt-6.1-sol comme point de départ pour le développement, gpt-6-astra pour les tâches exigeantes, ou gpt-6-luna pour un travail ciblé. gpt-6-sol est un identifiant distinct pour les flux de travail Sol existants. Consultez les détails du modèle et comment les comparer.

Dépannage

Symptôme	Vérifiez
Variable d’environnement manquante	Définissez `AIPRIMETECH_API_KEY` dans le processus qui lance Codex.
Erreur d’authentification 401	Vérifiez que la clé est active, copiée intégralement et émise par cette passerelle.
403 ou modèle indisponible	Vérifiez le groupe de la clé, les droits d’accès de l’offre et l’identifiant exact du modèle.
404 ou une réponse HTML	Utilisez `https://aiprimetech.io/v1` ; supprimez le doublon `/v1` ou un ajout de `/responses`.
`wire_api` rejeté	Utilisez `responses` ; les anciens `chat` exemples de fournisseurs sont obsolètes.
Erreur de solde, d’offre ou de limite de débit	Lisez l’erreur, vérifiez votre compte et réduisez le nombre de tâches simultanées avant de réessayer.
La connexion s’interrompt en cours de réponse	Essayez une requête courte, vérifiez la connectivité du réseau et du proxy, puis relevez l’identifiant de la requête pour le transmettre à l’assistance.

Claude et fonctionnalités hébergées de Codex

Pour utiliser Claude via la traduction Responses de la passerelle, suivez Claude avec Codex avec une clé compatible du groupe Claude. L’exemple GPT ci-dessus concerne l’accès du groupe Codex.

L’accès à la passerelle ne donne pas de droits d’accès à un espace de travail ChatGPT ni au cloud Codex. Consultez la comparaison des modes de connexion pour connaître le périmètre du produit.