Claude Code

Avant de commencer

1. 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_.
2. 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.
3. Choisissez un modèle. Les noms de modèles d'Inférence Nordique se terminent par une étiquette de niveau, par exemple claude-sonnet-5-t4. Vous les trouverez tous sur la page Modèles, ou tapez ni-models dans Claude Code une fois connecté.

Configurer Claude Code (Mac, Windows et Linux)

Placez vos paramètres dans le fichier de paramètres de Claude Code. Cela fonctionne sur tous les systèmes d'exploitation, reste en vigueur quand vous ouvrez un nouveau terminal et s'applique aussi aux sessions en arrière-plan. Ouvrez le fichier dans un éditeur de texte, ou créez-le s'il n'existe pas :

• Mac et Linux : ~/.claude/settings.json
• Windows : %USERPROFILE%\.claude\settings.json (par exemple C:\Users\you\.claude\settings.json)

Collez ce qui suit, puis remplacez ni_live_YOUR_KEY_HERE par votre clé :

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://northerninference.ca",
    "ANTHROPIC_AUTH_TOKEN": "ni_live_YOUR_KEY_HERE",
    "ANTHROPIC_MODEL": "claude-sonnet-5-t4",
    "ANTHROPIC_DEFAULT_MODEL": "claude-sonnet-5-t4",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-5-5-t4",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-5-t4",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-sonnet-5-t4",
    "ANTHROPIC_DEFAULT_FABLE_MODEL": "claude-sonnet-5-t4",
    "CLAUDE_CODE_SUBAGENT_MODEL": "claude-sonnet-5-t4"
  }
}

claude-haiku-5-5-t4, qui coûte moins cher, et claude-fable-5-1-t4 conviennent aussi aux paramètres haiku et fable, mais ils peuvent conserver des données : utilisez-les seulement si la politique de conservation des données de votre clé est réglée sur Autoriser.

Gardez les sept lignes de modèle. Chacune couvre une partie différente de Claude Code, et une ligne omise fait échouer les requêtes de cette partie. La section Choisir les modèles plus bas explique ce que couvre chaque ligne.

Si le fichier contient déjà d'autres paramètres, ajoutez le bloc "env" à côté d'eux au lieu de remplacer le fichier. Gardez la clé dans ce fichier personnel seulement, jamais dans le .claude/settings.json d'un projet, qui est partagé avec toute personne qui clone le projet.

Démarrez Claude Code avec claude et tapez /status. Vous devriez voir Anthropic base URL: https://northerninference.ca et une ligne Auth token qui mentionne ANTHROPIC_AUTH_TOKEN. Envoyez un message quelconque. Il apparaît dans le portail sous Utilisation en quelques secondes.

Déjà connecté avec un abonnement Claude?

Ce n'est pas un problème. Dès que ANTHROPIC_AUTH_TOKEN est défini, Claude Code envoie votre clé d'Inférence Nordique au lieu de votre connexion Claude. La connexion reste enregistrée, mais n'est pas utilisée. Pour la supprimer, tapez /logout dans Claude Code.

Utilisez ANTHROPIC_AUTH_TOKEN, et non ANTHROPIC_API_KEY. Avec ANTHROPIC_API_KEY, Claude Code demande une fois s'il doit utiliser la clé. Si vous répondez No, il continue d'envoyer la connexion de votre abonnement Claude, et Inférence Nordique la rejette avec une erreur 401.

Essayer dans un seul terminal d'abord (facultatif)

Pour tester avant de modifier le fichier de paramètres, définissez les valeurs dans une fenêtre de terminal et démarrez Claude Code depuis cette même fenêtre. Elles ne durent que jusqu'à sa fermeture.

Mac et Linux

export ANTHROPIC_BASE_URL=https://northerninference.ca
export ANTHROPIC_AUTH_TOKEN=ni_live_YOUR_KEY_HERE
export ANTHROPIC_MODEL=claude-sonnet-5-t4
export ANTHROPIC_DEFAULT_MODEL=claude-sonnet-5-t4
export ANTHROPIC_DEFAULT_OPUS_MODEL=claude-opus-5-5-t4
export ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-5-t4
export ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-sonnet-5-t4
export ANTHROPIC_DEFAULT_FABLE_MODEL=claude-sonnet-5-t4
export CLAUDE_CODE_SUBAGENT_MODEL=claude-sonnet-5-t4
claude

Windows PowerShell

$env:ANTHROPIC_BASE_URL = "https://northerninference.ca"
$env:ANTHROPIC_AUTH_TOKEN = "ni_live_YOUR_KEY_HERE"
$env:ANTHROPIC_MODEL = "claude-sonnet-5-t4"
$env:ANTHROPIC_DEFAULT_MODEL = "claude-sonnet-5-t4"
$env:ANTHROPIC_DEFAULT_OPUS_MODEL = "claude-opus-5-5-t4"
$env:ANTHROPIC_DEFAULT_SONNET_MODEL = "claude-sonnet-5-t4"
$env:ANTHROPIC_DEFAULT_HAIKU_MODEL = "claude-sonnet-5-t4"
$env:ANTHROPIC_DEFAULT_FABLE_MODEL = "claude-sonnet-5-t4"
$env:CLAUDE_CODE_SUBAGENT_MODEL = "claude-sonnet-5-t4"
claude

Dans l'Invite de commandes de Windows, utilisez set ANTHROPIC_AUTH_TOKEN=ni_live_YOUR_KEY_HERE sans guillemets autour de la valeur. Si le fichier de paramètres définit aussi une valeur, c'est celle du fichier de paramètres qui l'emporte.

Extension VS Code

L'extension Claude Code pour VS Code lit aussi ~/.claude/settings.json, donc les paramètres ci-dessus la couvrent déjà. Seulement si vous n'utilisez pas ce fichier, exécutez Préférences : Ouvrir les paramètres utilisateur (JSON) dans VS Code et ajoutez :

"claudeCode.environmentVariables": [
  { "name": "ANTHROPIC_BASE_URL", "value": "https://northerninference.ca" },
  { "name": "ANTHROPIC_AUTH_TOKEN", "value": "ni_live_YOUR_KEY_HERE" },
  { "name": "ANTHROPIC_MODEL", "value": "claude-sonnet-5-t4" },
  { "name": "ANTHROPIC_DEFAULT_MODEL", "value": "claude-sonnet-5-t4" },
  { "name": "ANTHROPIC_DEFAULT_OPUS_MODEL", "value": "claude-opus-5-5-t4" },
  { "name": "ANTHROPIC_DEFAULT_SONNET_MODEL", "value": "claude-sonnet-5-t4" },
  { "name": "ANTHROPIC_DEFAULT_HAIKU_MODEL", "value": "claude-sonnet-5-t4" },
  { "name": "ANTHROPIC_DEFAULT_FABLE_MODEL", "value": "claude-sonnet-5-t4" },
  { "name": "CLAUDE_CODE_SUBAGENT_MODEL", "value": "claude-sonnet-5-t4" }
]

Choisir les modèles

Claude Code demande un modèle par son nom à plus d'endroits que votre conversation principale. Les choix dans /model, le mode plan, les sous-agents et les tâches d'arrière-plan utilisent chacun leur propre paramètre. Pour chaque paramètre que vous omettez, Claude Code demande l'un de ses propres noms de modèles Claude, qu'Inférence Nordique ne fournit pas, et la requête échoue avec une erreur 404 comme Model 'claude-opus-5-5' is not a route this key can call. De votre côté, cela ressemble à des erreurs occasionnelles entre des requêtes qui fonctionnent, ou à un mode plan, des sous-agents ou des tâches d'arrière-plan qui ne fonctionnent pas. Définissez toutes les variables de cette liste.

• ANTHROPIC_MODEL est le modèle avec lequel une nouvelle session démarre.
• ANTHROPIC_DEFAULT_MODEL est ce qu'utilise le choix Default dans /model, et le modèle avec lequel une nouvelle session démarre quand rien d'autre n'en définit un. Il exige Claude Code 2.1.236 ou une version ultérieure, et les versions plus anciennes l'ignorent. Tapez claude --version pour vérifier votre version et claude update pour la mettre à jour.
• ANTHROPIC_DEFAULT_OPUS_MODEL est ce qu'utilise le choix opus dans /model, et ce qu'utilise opusplan en mode plan.
• ANTHROPIC_DEFAULT_SONNET_MODEL est ce qu'utilise le choix sonnet, et ce qu'utilise opusplan hors du mode plan.
• ANTHROPIC_DEFAULT_HAIKU_MODEL est ce qu'utilise le choix haiku, et ce qu'utilisent les tâches d'arrière-plan de Claude Code, comme le nom donné à vos sessions.
• ANTHROPIC_DEFAULT_FABLE_MODEL est ce qu'utilise le choix fable.
• CLAUDE_CODE_SUBAGENT_MODEL est le modèle des sous-agents et des membres d'une équipe d'agents qui n'en reçoivent pas d'une autre façon. Un sous-agent dont la définition nomme un modèle garde ce modèle : écrivez-y donc opus, sonnet, haiku ou un nom de modèle d'Inférence Nordique, et non un nom de modèle Claude.

Les exemples ci-dessus utilisent un modèle Claude pour chaque choix. Un modèle autre que Claude fonctionne aussi, par exemple DeepSeek-V4-Flash-t4 : définissez toutes les variables sur ce modèle.

Pour changer de modèle pendant une session, tapez /model claude-opus-5-5-t4, ou démarrez avec claude --model claude-opus-5-5-t4. Tout nom de la page Modèles fonctionne.

Niveau de réflexion

Claude Code appelle cela effort. Définissez-le au lancement, ou tapez /effort pendant une session pour le modifier :

claude --effort low
claude --effort medium
claude --effort high
claude --effort max

Les niveaux acceptés dépendent du modèle. Claude Sonnet 4.6 et Opus 4.6 acceptent low, medium, high et max. Avec un modèle autre que Claude, Inférence Nordique convertit l'effort en low, medium ou high à votre place.

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 Claude Code avec ces commandes. 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 utilisé par Claude Code 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.

Revenir à votre configuration précédente

Pour cesser d'utiliser Inférence Nordique, retirez les lignes que vous avez ajoutées au bloc "env" de votre fichier de paramètres, ou fermez le terminal où vous les avez définies. Quittez ensuite et redémarrez chaque session Claude Code encore ouverte. Une session en cours garde les paramètres avec lesquels elle a démarré : elle continue donc d'envoyer ses requêtes à Inférence Nordique jusqu'à ce que vous la redémarriez.

Annulez aussi ces changements, si vous les avez faits :

• Si vous avez choisi un modèle avec /model, Claude Code l'a enregistré comme modèle par défaut dans votre fichier de paramètres, sous la forme d'une ligne comme "model": "claude-opus-5-5-t4" en dehors du bloc "env". Retirez cette ligne avant de redémarrer. Sinon, Claude Code continue de demander un nom de modèle d'Inférence Nordique, que votre abonnement Claude ne fournit pas.
• Si vous avez écrit un nom de modèle d'Inférence Nordique sur la ligne model: de la définition d'un sous-agent (un fichier dans .claude/agents/), remplacez-le par opus, sonnet, haiku ou inherit.
• Si vous avez ajouté "claudeCode.environmentVariables" à vos paramètres VS Code, retirez-le de ces paramètres, puis quittez et rouvrez VS Code.
• Si vous avez tapé /logout pour supprimer votre connexion Claude, tapez /login dans Claude Code pour vous reconnecter.

Dépannage

Quelque chose ne fonctionne pas comme prévu? Écrivez à support at northerninference dot ca. Incluez le X-NI-Request-ID s'il a été renvoyé.