Skip to main content
Claude Code utilise le protocole Messages Anthropic. Sa Base URL NexusAPI est donc https://nexusapi.link : n’ajoutez pas /v1.

​
Prérequis système

  • macOS 13+, Ubuntu 20.04+, Debian 10+, Alpine Linux 3.19+ ou Windows 10 version 1809+ ;
  • au moins 4 Go de mémoire et un processeur x64 ou ARM64 ;
  • un réseau pouvant joindre NexusAPI ;
  • sous Windows, Git for Windows est facultatif si vous utilisez Git Bash.

​
1. Installer Claude Code

Utilisez l’installeur officiel :
Windows peut aussi utiliser winget install Anthropic.ClaudeCode, et macOS brew install --cask claude-code. Vérifiez ensuite :

​
Windows avec WinGet

​
macOS avec Homebrew

​
2. Créer une clé NexusAPI

Dans Gestion des jetons → Ajouter un jeton, choisissez un groupe contenant le modèle Claude voulu et définissez une limite. Vérifiez le protocole dans le catalogue ou la matrice des capacités.

​
Choisir des réglages de clé sûrs

Utilisez un nom propre au projet et une limite adaptée. Activez une restriction de modèle ou une liste d’IP seulement si vous en comprenez les effets ; donnez une expiration aux clés de test temporaires.

​
3. Configurer le compte utilisateur

​
Trouver le dossier de configuration

Sur macOS, Linux, WSL ou Git Bash :
Sous Windows PowerShell, créez d’abord le dossier puis ouvrez le fichier :

​
Définir les variables d’environnement

Fusionnez ces valeurs dans env sans écraser vos autres réglages :
Conservez ce fichier dans le profil utilisateur, jamais dans le dépôt du projet.
Désactivez les champs expérimentaux seulement si le message le demandeSi l’erreur mentionne explicitement context_management ou des entrées expérimentales non prises en charge, ajoutez CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1 à env et réessayez. Ce réglage désactive certains champs de préversion ; utilisez-le uniquement pour ce type d’erreur de compatibilité.

​
4. Vérifier

Ouvrez un nouveau terminal, placez-vous dans le projet et exécutez :
Exécutez ensuite /status. Vérifiez que Anthropic base URL vaut https://nexusapi.link et que l’authentification vient de ANTHROPIC_AUTH_TOKEN, puis envoyez une courte question.

​
Problèmes fréquents

​
Invalid API Key · Please run /login

Vérifiez les deux variables, le statut de la clé et le redémarrage du terminal. Ne modifiez pas les fichiers internes d’état de connexion de Claude.

​
Impossible de joindre les services Anthropic

Lancez claude doctor, vérifiez la syntaxe JSON de settings.json, puis rouvrez le terminal. Si le problème persiste, gardez le texte d’erreur, claude --version et la sortie de claude doctor.
N’écrasez pas par script les champs internes de .claude.json : ils peuvent changer avec les versions et l’écrasement peut supprimer des réglages existants.

​
PowerShell bloque l’installateur

Essayez d’abord WinGet ou l’installateur officiel depuis Windows CMD. Si vous avez vérifié que seul le réglage local d’exécution est en cause, modifiez uniquement la portée de l’utilisateur courant :
Après avoir confirmé que la stratégie locale est la cause, modifiez uniquement celle de l’utilisateur courant.

​
fetch failed

  1. Envoyez une courte question normale. Si elle fonctionne, le problème concerne probablement WebFetch ou une autre fonction réseau distincte.
  2. Si tous les appels échouent, lancez claude doctor et vérifiez l’URL avec /status.
  3. Contrôlez DNS, pare-feu, réseau d’entreprise ou proxy de confiance pour nexusapi.link.
  4. Ouvrez un nouveau terminal et testez une seule fois. En cas d’échec persistant, conservez version, sortie doctor, erreur complète et Request ID, puis suivez l’auto-vérification.

​
État offline

Certaines fonctions auxiliaires testent des services séparés. Vérifiez l’URL avec /status et une courte requête de modèle ; offline seul ne signifie pas forcément une panne NexusAPI.

​
WebFetch échoue mais le chat normal fonctionne

WebFetch peut utiliser des contrôles de domaine et un accès réseau externes distincts. Si une requête texte courte fonctionne, la Base URL NexusAPI n’a pas besoin d’être modifiée ; examinez l’erreur WebFetch selon les règles réseau propres à Claude Code.

​
Un appel API échoue

Fermez la session, ouvrez une nouvelle session claude et testez une seule courte requête. Si l’échec continue, conservez le Request ID et utilisez l’auto-vérification.

​
Références officielles