> ## Documentation Index
> Fetch the complete documentation index at: https://novita.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Codex

> Connectez Codex au point de terminaison d’API LLM compatible OpenAI de Novita.

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.

<Warning>
  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.
</Warning>

## Prérequis

Avant de commencer, préparez les valeurs suivantes :

* **Clé API** : créez ou copiez une clé API depuis [Gestion des clés](https://novita.ai/settings/key-management).
* **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`.

<Tip>
  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.
</Tip>

## Installer Codex

Avant d’installer Codex, assurez-vous que [Node.js 18 ou une version supérieure](https://nodejs.org/en/download/) est installé sur votre machine.

Sur macOS, si vous utilisez Homebrew, vous pouvez installer Node.js avec :

```bash theme={"system"}
brew install node
```

Vérifiez vos versions de Node.js et npm :

```bash theme={"system"}
node -v
npm -v
```

Installez la CLI Codex :

```bash theme={"system"}
npm install -g @openai/codex
```

Vérifiez la version de Codex :

```bash theme={"system"}
codex --version
```

## Configurer votre clé API

Ouvrez votre fichier de configuration du shell, par exemple `~/.zshrc` :

```bash theme={"system"}
nano ~/.zshrc
```

Ajoutez la variable d’environnement suivante :

```bash theme={"system"}
export NOVITA_API_KEY="<your-novita-api-key>"
```

Rechargez votre configuration du shell et confirmez que la variable est disponible :

```bash theme={"system"}
source ~/.zshrc
echo $NOVITA_API_KEY
```

## Configurer Codex

Ouvrez le fichier de configuration Codex :

```bash theme={"system"}
mkdir -p ~/.codex
nano ~/.codex/config.toml
```

Ajoutez la configuration suivante, et remplacez `model` par l’ID du modèle Novita que vous souhaitez utiliser :

```toml theme={"system"}
model_provider = "novita"
model = "deepseek/deepseek-v3.1"

[model_providers]
[model_providers.novita]
name = "Novita"
wire_api = "responses"
requires_openai_auth = true
base_url = "https://api.novita.ai/openai/v1"
env_key = "NOVITA_API_KEY"
```

## Démarrer Codex

Accédez au répertoire de votre projet et démarrez Codex :

```bash theme={"system"}
cd <your-project-directory>
codex
```

Vous pouvez maintenant saisir une tâche de codage, par exemple :

```text theme={"system"}
Read this project and summarize the main modules.
```

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`.