Limites d’utilisation de Codex : pourquoi elles surviennent et comment continuer

Identifier la limite en une minute

Ne déduisez pas la cause du seul statut 429. Lisez le code d’erreur précis et le corps de la réponse, puis suivez la documentation actuelle du fournisseur pour cette erreur.

Pourquoi un nombre fixe de messages n’est pas fiable

Selon le Centre d’aide OpenAI, consulté le 14 août 2026, l’utilisation de Codex dépend de la taille et de la complexité de la tâche, du modèle sélectionné et de l’endroit où la tâche s’exécute. Une petite modification locale et une longue tâche impliquant un grand dépôt consomment l’allocation différemment. Une formule telle que « N messages toutes les cinq heures » peut donc devenir rapidement obsolète et ne permet pas de prévoir l’utilisation réelle de manière fiable.

Pour les tâches payées avec des crédits selon le barème actuel fondé sur les tokens, les variables mesurables sont le modèle sélectionné ainsi que les tokens d’entrée, les tokens d’entrée mis en cache et les tokens de sortie de la tâche. Ouvrez le barème actuel de Codex, puis utilisez les informations affichées pour votre propre Workspace afin d’identifier le tableau et l’unité actuellement applicables avant d’estimer les coûts.

Que faire lorsque vous atteignez une limite du forfait Codex

1. Ouvrez la page Usage ou la bannière de limite et notez précisément ce que votre compte propose : des crédits, une réinitialisation disponible, un passage à un forfait supérieur ou l’attente de la réinitialisation de la limite. Vérifiez également si d’autres fonctionnalités agentiques disponibles dans le Workspace ont utilisé le pool partagé. Si votre rôle actuel ne vous permet pas d’ajouter des crédits ou de gérer la facturation, contactez le propriétaire ou un administrateur du Workspace ; les actions disponibles dépendent toujours du forfait, de votre rôle dans le Workspace et des autorisations accordées par l’administrateur.
2. La référence de configuration OpenAI actuelle place le profil nommé dans $CODEX_HOME/bt.config.toml. Par défaut, CODEX_HOME correspond généralement à ~/.codex sous macOS/Linux et à %USERPROFILE%\.codex sous Windows, mais une valeur personnalisée détermine le chemin réel et prévaut sur ces valeurs par défaut.

Sous macOS/Linux, vérifiez le répertoire sans modifier la variable :

printf '%s\n' "${CODEX_HOME:-$HOME/.codex}"

Sous PowerShell :

if ($env:CODEX_HOME) { $env:CODEX_HOME } else { Join-Path $env:USERPROFILE ".codex" }

Créez bt.config.toml précisément dans le répertoire affiché :

model = "YOUR_MODEL_ID"
model_provider = "bettertoken"

[model_providers.bettertoken]
name = "BetterToken"
base_url = "https://www.bettertoken.ai/v1?utm_source=blog&utm_medium=organic_content&utm_campaign=SEO-093&utm_content=codex-usage-limits-kak-prodolzhit"
env_key = "BETTERTOKEN_API_KEY"
wire_api = "responses"
requires_openai_auth = false
request_max_retries = 4
stream_max_retries = 8
stream_idle_timeout_ms = 300000
supports_websockets = false

Le chemin de fichier $CODEX_HOME/bt.config.toml correspond à la commande --profile bt. Ce profil ne remplace pas le fichier principal $CODEX_HOME/config.toml ; le fournisseur officiel reste donc disponible.

Remplacez YOUR_MODEL_ID par l’identifiant API complet et actuel affiché dans Setup, model plaza ou le guide en vigueur, et disponible avec votre clé. N’utilisez pas le titre visible du modèle s’il diffère de l’identifiant API.

Codex ajoute lui-même /responses. La Base URL doit donc se terminer par /v1, et non par /v1/responses, sinon le chemin serait ajouté deux fois.

Codex Desktop utilise les mêmes champs de fournisseur personnalisé, mais vérifiez la méthode actuelle de sélection de la configuration et de lancement dans le guide BetterToken en vigueur ; n’y supposez pas que la commande CLI --profile s’applique telle quelle. Pour VS Code Extension, utilisez le guide séparé et ne transposez ni le profil CLI ni son mode d’authentification sans vérification.

3. Exportez la clé dans votre shell et vérifiez uniquement que la variable n’est pas vide, sans afficher sa valeur :

export BETTERTOKEN_API_KEY="YOUR_API_KEY"
test -n "$BETTERTOKEN_API_KEY" && echo "BETTERTOKEN_API_KEY is set"

4. Démarrez Codex avec le nouveau profil :

codex --profile bt

Envoyez ensuite une petite requête en lecture seule, par exemple :

Lisez README.md et résumez son objectif. Ne modifiez aucun fichier.

5. Vérifiez la requête et son utilisation dans le Workspace avant de poursuivre avec une tâche plus importante. L’exemple complet et à jour est disponible dans le guide de configuration de Codex.

Ne placez pas une véritable clé dans un dépôt, un article, une capture d’écran ou dans $CODEX_HOME/bt.config.toml si la configuration risque d’être validée dans Git. La valeur doit provenir d’une variable d’environnement.

Éviter de perdre du travail lors du changement

Créez un court fichier de transmission sans secrets :

Objectif : corriger le test X qui échoue.
Déjà vérifié : A et B.
Fichiers modifiés : path/to/file.
Prochaine étape sûre : exécuter un seul test ciblé.
Interdit : commit, déploiement, suppression de données.

Avant d’ouvrir une autre copie de travail, inspectez l’état actuel, enregistrez les modifications suivies dans un patch compatible avec les fichiers binaires et listez séparément les fichiers non suivis :

git status --short
git diff --binary HEAD > ../codex-handoff.patch
git ls-files --others --exclude-standard -z > ../codex-handoff-untracked.zlist

Le patch n’inclut pas les fichiers non suivis. Avant toute copie, examinez ../codex-handoff-untracked.zlist et excluez les fichiers .env, les clés privées, les identifiants et tout autre secret. Ne conservez que les chemins que vous avez explicitement approuvés ; ne supposez pas qu’un fichier non suivi peut être supprimé ou transféré en toute sécurité.

Créez un nouveau worktree à partir du HEAD actuel, vérifiez le patch avant de l’appliquer, puis contrôlez l’état obtenu :

git worktree list
git branch --list codex/api-handoff
git worktree add -b codex/api-handoff ../project-api-handoff HEAD
if test -s ../codex-handoff.patch; then
  git -C ../project-api-handoff apply --check ../codex-handoff.patch
  git -C ../project-api-handoff apply ../codex-handoff.patch
fi
while IFS= read -r -d '' path; do
  mkdir -p -- "../project-api-handoff/$(dirname -- "$path")"
  cp -p -- "$path" "../project-api-handoff/$path"
done < ../codex-handoff-untracked.zlist
git -C ../project-api-handoff status --short

Le bloc if ignore git apply lorsque le patch des fichiers suivis est vide. La boucle de copie reste en dehors de ce bloc : les fichiers non suivis examinés et approuvés sont donc quand même transférés. Si ../project-api-handoff ou codex/api-handoff existe déjà, choisissez un nouveau chemin ou nom de branche inutilisé. Ne supprimez pas un worktree, une branche, un patch ou un fichier non suivi existant simplement pour réutiliser un nom en conflit.

Démarrez la nouvelle session API avec la note de transmission et l’état de travail vérifié plutôt qu’avec l’historique complet de la conversation. Vous réduirez ainsi l’utilisation et le risque de dépassement de la fenêtre de contexte, tout en limitant la probabilité de répéter des actions déjà terminées.

Si vous recevez plutôt une erreur 429

Vérifiez les points suivants dans l’ordre :

1. Le code d’erreur précis, le corps de la réponse, les en-têtes de réponse et la documentation du fournisseur relative à cette erreur.
2. Si plusieurs agents ou tâches CI utilisent la même clé.
3. Si le solde est nul ou si le budget de dépenses du Workspace a été atteint.
4. Si l’erreur se produit encore avec une seule petite requête après tout délai recommandé pour cette erreur précise.

Si l’erreur précise et la documentation du fournisseur indiquent une limitation temporaire du débit, utilisez un backoff exponentiel borné avec jitter. Ne réessayez pas indéfiniment : les requêtes répétées allongent la file d’attente et peuvent consommer le budget une fois le service rétabli.

Faire le choix final

• Si la bannière Codex propose des crédits ou une réinitialisation et que vous souhaitez conserver le même flux fondé sur le forfait, utilisez l’option officielle disponible.
• Si vous avez besoin d’un budget distinct pour l’automatisation, la CI ou une tâche urgente, configurez un flux API et suivez son utilisation séparément.
• Si le problème vient de la fenêtre de contexte, réduisez le contexte ou démarrez une nouvelle session. Dépenser davantage ou attendre la réinitialisation d’une limite ne le résoudra pas.
• Si le problème est une erreur API 429, suivez le code d’erreur précis, le corps de la réponse et la documentation du fournisseur ; si le solde est nul, corrigez le budget avant de réessayer.

Avant de transférer un travail urgent, ouvrez le guide BetterToken actuel de configuration de Codex, configurez un fournisseur personnalisé avec une clé distincte et vérifiez-le au moyen d’une petite requête. Une fois la vérification réussie, définissez une limite de dépenses opérationnelle, puis seulement poursuivez la tâche plus longue.