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-4-6-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-4-6-t4",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-4-6-t4",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-4-6-t4",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-4-5-20251001-t4"
  }
}

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-4-6-t4
export ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-haiku-4-5-20251001-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-4-6-t4"
$env:ANTHROPIC_DEFAULT_HAIKU_MODEL = "claude-haiku-4-5-20251001-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 son propre paramètre. Exécutez Preferences: Open User Settings (JSON) 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-4-6-t4" },
  { "name": "ANTHROPIC_DEFAULT_HAIKU_MODEL", "value": "claude-haiku-4-5-20251001-t4" }
]

Choisir les modèles

• ANTHROPIC_MODEL est le modèle avec lequel une nouvelle session démarre.
• ANTHROPIC_DEFAULT_SONNET_MODEL et ANTHROPIC_DEFAULT_OPUS_MODEL sont utilisés par les choix sonnet et opus dans /model.
• ANTHROPIC_DEFAULT_HAIKU_MODEL sert aux tâches d'arrière-plan de Claude Code, comme le nom donné à vos sessions. Sans lui, ces requêtes d'arrière-plan demandent un nom de modèle Claude qu'Inférence Nordique ne fournit pas, et elles échouent.

Pour changer de modèle pendant une session, tapez /model claude-opus-4-6-t4, ou démarrez avec claude --model claude-opus-4-6-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.

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