Codex est un outil de codage IA qui s’exécute dans votre terminal. Vous pouvez connecter Codex au point de terminaison d’API LLM compatible OpenAI de Novita et utiliser les modèles Novita pour des tâches de compréhension, de génération, de refactorisation et de débogage de code.
Codex prend actuellement en charge uniquement la Responses API. Configurez wire_api = "responses" comme indiqué ci-dessous, et ne basculez pas cette intégration en mode Chat Completions.
Prérequis
Avant de commencer, préparez les valeurs suivantes :
- Clé API : créez ou copiez une clé API depuis Gestion des clés.
- URL de base :
https://api.novita.ai/openai/v1
- ID de modèle : copiez l’ID du modèle que vous souhaitez utiliser depuis le Model Hub, par exemple
deepseek/deepseek-v3.1.
Gardez votre clé API privée. Utilisez-la uniquement dans votre configuration Codex locale et ne la validez jamais dans un dépôt Git.
Installer Codex
Avant d’installer Codex, assurez-vous que Node.js 18 ou une version supérieure est installé sur votre machine.
Sur macOS, si vous utilisez Homebrew, vous pouvez installer Node.js avec :
Vérifiez vos versions de Node.js et npm :
Installez la CLI Codex :
Vérifiez la version de Codex :
Ouvrez votre fichier de configuration du shell, par exemple ~/.zshrc :
Ajoutez la variable d’environnement suivante :
Rechargez votre configuration du shell et confirmez que la variable est disponible :
Ouvrez le fichier de configuration Codex :
Ajoutez la configuration suivante, et remplacez model par l’ID du modèle Novita que vous souhaitez utiliser :
Démarrer Codex
Accédez au répertoire de votre projet et démarrez Codex :
Vous pouvez maintenant saisir une tâche de codage, par exemple :
Si Codex renvoie une erreur d’authentification ou de modèle, vérifiez que :
NOVITA_API_KEY est disponible dans la session de terminal actuelle.
model correspond exactement à l’ID du modèle dans le Model Hub de Novita.
base_url est défini sur https://api.novita.ai/openai/v1.