Une API pour tousGuide d’utilisation
Site web ↗
Guide d’utilisationConfigurer un outil

Codex

Connectez votre client Codex local déjà installé. Distinguez d’abord ce client des tâches dans le cloud.

Préparez ces trois informations

L’application étant déjà installée, ouvrez Libre-service sur ce site et connectez-vous. Créez ou consultez votre clé, copiez l’adresse API affichée et un identifiant exact dans Modèles et tarifs. N’utilisez ni la page d’accueil, ni votre mot de passe, ni un nom commercial de modèle. Vérifiez le solde et le quota de la clé.

API_HOST, YOUR_API_KEY et YOUR_MODEL_ID sont des valeurs fictives : remplacez chacune avant utilisation. Suivez les indications pour /v1 ; n’ajoutez ni /chat/completions ni /responses. Les exemples ne se connectent pas automatiquement et ne contiennent pas votre clé.

1. Identifier le client

Ces fichiers concernent Codex CLI et les clients lisant la configuration locale, pas les tâches web dans le cloud. Pour une configuration à la souris, suivez la branche Codex de CC Switch.

2. Ouvrir la configuration

Ouvrez ~/.codex/config.toml sous macOS/Linux ou %USERPROFILE%\.codex\config.toml sous Windows. Lancez Codex une fois si le fichier manque. Fusionnez l’exemple. MY_API_KEY est un nom de variable, pas la clé.

Schéma des champs · pas une capture d’écran
Base URL
https://API_HOST/v1
wire_api
responses
model
YOUR_MODEL_ID
env_key
MY_API_KEY
Exemple de configuration

Conservez une copie du fichier actuel. Modifiez les entrées existantes sans les dupliquer et gardez les autres réglages. Ne partagez aucun fichier ou capture contenant une vraie clé.

model_provider = "my_api"
model = "YOUR_MODEL_ID"

[model_providers.my_api]
name = "My API"
base_url = "https://API_HOST/v1"
wire_api = "responses"
env_key = "MY_API_KEY"
requires_openai_auth = false

3. Définir la clé et démarrer

Définissez MY_API_KEY ci-dessous, entrez dans le dossier de test depuis ce même terminal, puis lancez codex. Ne remplacez pas votre auth.json. Une application ouverte par son icône peut ignorer la variable : utilisez CC Switch pour ce client.

Si la configuration utilise MY_API_KEY, définissez cette variable dans le terminal qui lancera l’outil. Saisissez votre clé uniquement sur votre ordinateur. Elle reste définie jusqu’à la fermeture du terminal.

Terminal macOS / Linux
export MY_API_KEY="YOUR_API_KEY"
codex
Windows PowerShell
$env:MY_API_KEY = "YOUR_API_KEY"
codex

4. Choisir modèle et raisonnement

Vérifiez le modèle avec /model. Commencez par la valeur par défaut ou Medium. Vous pouvez aussi placer model_reasoning_effort = "medium" au début de config.toml, avant toute [table]. Utilisez uniquement les niveaux pris en charge.

5. Vérifier le format

Utilisez Responses avec wire_api = "responses" et gardez /v1. Ne recopiez pas le choix Chat Completions de Harness. Le modèle doit aussi accepter les outils et la diffusion du client.

Test 1 : recevoir une réponse

Créez un dossier de test vide, choisissez-le comme espace de travail et ouvrez une nouvelle conversation. Vérifiez le fournisseur et le modèle, puis envoyez le message ci-dessous. Une réponse sans erreur confirme la connexion de base, pas toutes les fonctions. Les tests entraînent une consommation API normale.

Réponds uniquement : Connexion réussie.

Résultat attendu : « Connexion réussie ». Si un écran de connexion, une erreur ou un chargement sans fin apparaît, consultez les vérifications avant de réessayer.

Test 2 : lire un vrai fichier

Dans ce dossier, créez hello.txt avec un éditeur de texte et écrivez « API connection test 27 ». Enregistrez, puis envoyez la demande ci-dessous. Autorisez uniquement la lecture de ce dossier si l’outil le demande.

Utilise l’outil de lecture pour ouvrir hello.txt dans l’espace de travail actuel et donne son contenu. Ne modifie aucun fichier.

Résultat attendu : une trace d’exécution lisant hello.txt, puis une réponse contenant API connection test 27. Une réponse seule ne prouve pas l’appel d’outil. Vous pouvez ensuite supprimer le dossier de test.

Vérifier selon le symptôme

401 / Invalid API key

Vérifiez que l’adresse et la clé complète correspondent au même service et que la clé est active. N’envoyez jamais une clé complète au support.

404 / model not found

Vérifiez /v1, l’identifiant exact et le format. Un modèle répertorié ne prend pas nécessairement tous les formats en charge.

429 / quota / balance

Vérifiez solde, quota et fréquence selon l’erreur. Augmenter le raisonnement ne rétablit pas le quota.

La conversation fonctionne, pas les fichiers

Vérifiez les outils du modèle, les autorisations du dossier et l’erreur d’exécution.

Aucun niveau de raisonnement

Vérifiez les capacités déclarées, le modèle et la version. Le raisonnement n’est pas toujours réglable.

Références officielles et portée

Configuration vérifiée le 2026-11-08. Les menus peuvent évoluer ; consultez ces références officielles. Utilisez les informations de connexion actuelles de notre plateforme.