Clé API Codex VS Code : utiliser un endpoint personnalisé

Ce que vous configurez

Les assistants de code dans VS Code communiquent avec un modèle via HTTP. La plupart utilisent le format OpenAI API, acceptant ainsi une URL de base et une clé personnalisées. Ce service est compatible OpenAI, il s’intègre donc à tout outil offrant cette option.

Soyez clair sur ce qui se trouve à l’autre bout. Il s’agit d’un seul modèle à poids ouverts exécuté par un fournisseur indépendant, ajusté pour répondre sans refus de contenu pour une utilisation adulte conforme à la loi. Ce n’est pas le modèle Codex d’OpenAI ni l’API officielle d’aucun autre fournisseur. Il ne gère que du texte, avec une fenêtre de contexte de 100 000 tokens, l'appel d'outils et un mode JSON. Pour les détails des routes compatibles OpenAI, consultez la documentation ; pour l’adresse uniquement, consultez la page sur l’URL de base de l’API Codex.

Voici les trois valeurs à utiliser partout :

Obtenir une clé et la tester d'abord

Créez un compte sur la page de clé API avec Google ou avec e-mail et mot de passe. Les nouveaux utilisateurs peuvent obtenir 0,50 $ de crédit d'essai en un clic, valable 7 jours, sans carte requise. Ensuite, testez la clé dans un terminal avant de toucher VS Code. Un appel curl fonctionnel prouve la clé et l'URL, donc les erreurs ultérieures concerneront l'extension.

Copy# macOS or Linux, add to ~/.zshrc or ~/.bashrc
export CODEX_API_KEY="YOUR_KEY"

# then verify the endpoint answers
curl https://api.getcodexapi.com/v1/chat/completions \
  -H "Authorization: Bearer $CODEX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"uncensored","messages":[{"role":"user","content":"Write a Python one-liner that reverses a string."}]}'

La réponse est un JSON de complétions de chat, et la réponse comporte un en-tête X-Balance-USD avec votre crédit restant. Gardez la clé dans une variable d'environnement ou le stockage secret de l'extension, jamais dans un dépôt.

Extension et CLI Codex : fichier de configuration

Les outils Codex d'OpenAI prennent en charge les fournisseurs de modèles personnalisés via un fichier de configuration TOML dans votre répertoire personnel, et l'extension VS Code est documentée pour partager cette configuration avec le CLI. Vérifiez cela par rapport à la documentation Codex actuelle pour votre version, car le format a évolué.

Copy# ~/.codex/config.toml
model = "uncensored"
model_provider = "custom"

[model_providers.custom]
name = "Custom endpoint"
base_url = "https://api.getcodexapi.com/v1"
env_key = "CODEX_API_KEY"
wire_api = "chat"

Points à vérifier :

• base_url se termine par /v1, sans /chat/completions.
• env_key est le nom de la variable d'environnement, pas la clé elle-même.
• wire_api sélectionne le format de requête. Ce service accepte à la fois POST /v1/chat/completions et POST /v1/responses. Essayez d'abord « chat » ; utilisez « responses » si votre version Codex l'exige.
• Démarrez VS Code depuis un shell où la variable est définie, ou redémarrez-le après avoir ajouté la variable à votre profil. Un lancement via l’interface graphique sur macOS ne voit souvent pas les exports du shell.

Les outils de type agent reposent sur l'appel de fonctions. Il est pris en charge ici, y compris les appels de fonctions en streaming, mais la qualité varie selon le modèle, donc exécutez d'abord une petite tâche. La page connexe sur l'utilisation de l'API dans Cursor couvre une configuration similaire dans un autre éditeur.

Continue, Cline et autres extensions

Les extensions tierces ont chacune leur propre écran, mais le schéma est constant : choisissez un fournisseur OpenAI ou « Compatible OpenAI », puis remplissez l'URL de base, la clé et le modèle. Continue utilise une configuration YAML :

Copy# Continue (config.yaml), model entry
models:
  - name: Hosted uncensored
    provider: openai
    model: uncensored
    apiBase: https://api.getcodexapi.com/v1
    apiKey: YOUR_KEY

Cline et Roo Code offrent un fournisseur « Compatible OpenAI » dans leur panneau de paramètres avec les trois mêmes champs. Les noms et les menus changent souvent, donc recherchez « Compatible OpenAI » ou « URL de base personnalisée » dans la documentation de l'extension. Si une extension n'a pas de champ pour l'URL de base, elle ne peut pas utiliser cet endpoint.

Conseils qui font gagner du temps :

• Désactivez l'autocomplétion par onglet contre le modèle hébergé sauf si vous voulez une requête à chaque pause. Les actions de chat et d'édition sont moins chères.
• Définissez un contexte plus petit dans l'extension pour les éditions quotidiennes. Envoyer des dépôts entiers au modèle coûte des tokens d'entrée à chaque fois.
• Utilisez une clé distincte par outil afin de savoir lequel utilise votre crédit.

Quelles tâches d'éditeur conviennent à ce modèle

Un modèle textuel général avec une grande fenêtre est un bon ajustement pour plusieurs tâches quotidiennes : expliquer du code inconnu, écrire des tests unitaires pour une fonction, convertir un script entre langages, rédiger des docstrings et regex, et réécrire un module lorsque vous collez le fichier entier. La fenêtre de 100 000 tokens signifie que quelques fichiers moyens plus vos instructions tiennent dans une seule requête, et la complétion peut utiliser ce qui reste.

Soyez réaliste pour le reste. Ce n'est pas un modèle de codage spécialisé avec une formation consciente de l'éditeur, donc les exécutions d'agents multi-fichiers volumineux peuvent nécessiter plus de guidance et de vérification que vous ne le feriez pour un outil conçu pour eux. Demandez des diffs au lieu de fichiers entiers, révisez chaque changement avant de l'accepter, et exécutez vos tests. Si une tâche nécessite du contenu qu'un assistant filtré refuse, comme la rédaction d'une structure de fiction pour adultes ou du texte de recherche en sécurité pour une utilisation légale, un endpoint sans refus de contenu est la raison d'utiliser celui-ci.

Ce que cela coûte dans un éditeur

Les prix sont de 0,15 $ par 1M de tokens d'entrée et de 0,50 $ par 1M de tokens de sortie. Les outils de codage envoient beaucoup de contexte, donc regardez d'abord l'entrée.

Exemple : une demande d'édition avec 8 000 tokens de contexte de fichier et une réponse de 600 tokens coûtent 8 000 x 0,15 $ / 1M + 600 x 0,50 $ / 1M = 0,0012 $ + 0,0003 $ = 0,0015 $. Une journée de 150 demandes de ce type coûte 150 x 0,0015 $ = 0,225 $. Vingt jours ouvrables : 4,50 $.

Un agent qui lit de nombreux fichiers peut envoyer 40 000 tokens par étape. À cette taille, une étape coûte 0,006 $ plus la sortie, donc 100 étapes coûtent environ 0,60 $ plus la sortie. Surveillez les boucles d'agents. Les requêtes échouées ou refusées ne sont pas facturées, et le crédit n'expire jamais. Les recharges de 20 $ à 500 $ peuvent être payées par carte (Visa, Mastercard, Apple Pay, Google Pay) ou crypto. Les plans actuels sont listés sur la page des tarifs.

Dépannage

401 Non autorisé

La clé est manquante, contient un espace parasite, ou la variable d'environnement n'est pas visible pour VS Code. Redémarrez l'éditeur à partir d'un terminal qui a la variable.

404 ou "modèle non trouvé"

Utilisez le modèle exact uncensored et l'URL de base avec /v1 à la fin.

Erreurs 429

Une clé complète permet 8 requêtes simultanées et 300 par minute ; la clé d'essai permet 2 et 60. Une extension qui déclenche plusieurs requêtes simultanées, comme l'autocomplétion plus le chat, peut atteindre la limite de concurrence. Le code d'erreur est concurrency pour trop en même temps et rate_limited pour les limites par minute. Un en-tête Retry-After: 5 signifie une surcharge temporaire.

Le streaming se bloque

Certains proxies d'entreprise mettent en buffer les événements envoyés par le serveur. Testez depuis un réseau différent ou désactivez le streaming dans l'extension.

Les réponses diffèrent de ce que vous avez vu avec un autre assistant

C'est attendu. C'est un modèle différent avec ses propres forces. Donnez-lui des instructions claires et spécifiques et testez-le sur du code de votre propre projet.

Plus de guides

• API Codex en Python : appeler un LLM de codage
• URL de base de l'API Codex : Comment pointer votre client vers le nôtre