Codex | Documentation d'Inférence Nordique

Exécutez Codex par le biais d'Inférence Nordique à l'aide de votre clé API NI.

Inférence Nordique est une API d'IA souveraine canadienne pour les équipes du gouvernement, de la défense, de la santé et des secteurs réglementés, y compris les organisations relevant du Programme des marchandises contrôlées. Chaque route comporte une résidence des données au Canada conforme à la LPRPDE, un chemin exact vers les derniers modèles de pointe et à poids ouverts, ainsi qu'un registre de chaîne de possession par requête.

Avant de commencer

Créez une clé API. Dans le portail, ouvrez Clés API et cliquez sur Créer la clé. Votre clé commence par ni_live_.
Ajoutez des crédits. Les nouveaux comptes démarrent avec un solde de 0 $, et chaque requête est refusée tant que vous n'ajoutez pas de crédits. Ouvrez Facturation et cliquez sur Acheter des crédits.
Choisissez un modèle. Les noms de modèles d'Inférence Nordique se terminent par une étiquette de niveau, par exemple claude-sonnet-4-6-t4. Vous les trouverez tous sur la page Modèles, ou tapez ni-models dans Codex une fois connecté.

Configurer Codex

1. Modifiez votre fichier de configuration de Codex. Ouvrez ~/.codex/config.toml dans un éditeur de texte, ou créez-le s'il n'existe pas. Sous Windows, ~ correspond à votre dossier utilisateur, donc le fichier est C:\Users\you\.codex\config.toml. Ajoutez ces lignes au début du fichier :

model_provider = "northerninference"
model = "claude-sonnet-4-6-t4"

[model_providers.northerninference]
name = "Northern Inference"
base_url = "https://northerninference.ca/v1"
env_key = "NI_API_KEY"
wire_api = "responses"

2. Fournissez votre clé à Codex. Codex la lit dans la variable d'environnement NI_API_KEY.

Mac et Linux

export NI_API_KEY=ni_live_YOUR_KEY_HERE
codex

Pour conserver la clé dans les nouveaux terminaux, ajoutez la ligne export à ~/.zshrc ou à ~/.bashrc.

Windows PowerShell

setx NI_API_KEY "ni_live_YOUR_KEY_HERE"

setx enregistre la clé pour tous les nouveaux terminaux. Fermez cette fenêtre, ouvrez-en une nouvelle et exécutez codex. Pour l'essayer dans la fenêtre actuelle seulement, utilisez plutôt $env:NI_API_KEY = "ni_live_YOUR_KEY_HERE".

3. Vérifiez que cela fonctionne. Envoyez un message quelconque dans Codex. Il apparaît dans le portail sous Utilisation en quelques secondes.

Placez ces lignes dans votre ~/.codex/config.toml personnel, et non dans le .codex/config.toml propre à un projet.

Conserver aussi votre configuration habituelle de Codex (facultatif)

Si vous utilisez aussi Codex avec votre compte ChatGPT, gardez Inférence Nordique dans son propre profil. Placez les mêmes lignes dans ~/.codex/northerninference.config.toml plutôt que dans config.toml, puis démarrez Codex avec :

codex --profile northerninference

Un simple codex continue d'utiliser votre configuration habituelle.

Choisir un modèle

Modifiez model dans le fichier de configuration, ou choisissez un modèle pour une seule exécution :

codex --model claude-opus-4-6-t4

Tout nom de la page Modèles fonctionne. Codex envoie les requêtes au format Responses, ce qui explique la présence de wire_api = "responses" dans la configuration.

Si un nom de modèle n'est pas reconnu

Inférence Nordique répond par un HTTP 404 et Model 'X' is not a route this key can call. Elle ne remplace jamais le modèle par un autre. Utilisez un nom de la page Modèles, ou posez la question depuis Codex. Tapez l'une de ces commandes comme message complet. Elles répondent immédiatement, n'appellent aucun modèle et ne sont pas facturées.

ni-models liste les modèles que votre clé peut appeler, numérotés.
ni-map-model 3 envoie le nom de modèle de votre configuration vers le modèle 3 de cette liste. ni-map-model <model-name> fait la même chose avec un nom exact.
ni-status affiche vos correspondances, et ni-unmap supprime celle de votre modèle actuel.
ni-help liste toutes les commandes.

Une correspondance s'applique à l'ensemble de votre compte. Vous pouvez aussi les consulter ou les supprimer dans le portail, sous Modèles, dans Correspondances des noms de modèles.

Dépannage

Ce que vous voyez	Ce qu'il faut faire
Codex indique que la variable `NI_API_KEY` est absente	La clé n'est pas définie dans ce terminal. Sous Windows, ouvrez un nouveau terminal après `setx`.
401 d'Inférence Nordique	La clé est incorrecte ou a été révoquée. Copiez-la de nouveau depuis le portail, sous Clés API, sans guillemets ni espaces.
402 `Insufficient credits. Add credits in the portal under Billing (https://northerninference.ca/portal/?page=billing) to continue.`	Ajoutez des crédits dans le portail, sous Facturation.
404 `Model 'X' is not a route this key can call.`	Utilisez un nom de modèle de la page Modèles, ou tapez `ni-models`. Voir Si un nom de modèle n'est pas reconnu plus haut.
Les requêtes n'apparaissent pas dans Utilisation	Codex n'utilise pas le fournisseur Inférence Nordique. Vérifiez que `model_provider = "northerninference"` se trouve au début de `~/.codex/config.toml`, avant tout `[section]`.

Si une requête renvoie une erreur NI, incluez le X-NI-Request-ID lorsque vous contactez le soutien.