🪄 Connecter Claude Code au modèle personnalisé CodingPlanX

> Claude Code est un puissant assistant de programmation IA lancé par Anthropic, qui s'intègre directement dans votre terminal, comprend votre base de code et collabore de manière transparente avec vous pour écrire, refactoriser et déboguer du code. > > Ce tutoriel vous guidera à travers la préparation de l'environnement, l'installation de l'outil et la configuration exclusive pour l'interface proxy codingplanx.ai.

📋 Exigences du système

Avant de commencer, assurez-vous que votre système répond aux exigences minimales suivantes :

Node.js : version >= 18.0
Système d'exploitation : macOS, Linux, Windows (utilisation de WSL recommandée)

🚀 Démarrage rapide

1. Installer Node.js

> 💡 Astuce : Si vous avez déjà installé Node.js 18.0 ou une version ultérieure, veuillez ignorer cette étape.

🍎 Utilisateurs macOS

Il est recommandé d'installer via Homebrew :

# 1. Installer les outils de ligne de commande Xcode
sudo xcode-select --install

# 2. Installer Homebrew (si ce n'est pas déjà fait)
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# 3. Installer Node.js via Homebrew
brew install node

# 4. Vérifier l'installation
node --version

🐧 Utilisateurs Ubuntu / Debian

Utilisez le script officiel NodeSource pour installer la version LTS :

# 1. Télécharger et exécuter le script d'installation
curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo bash -

# 2. Installer Node.js
sudo apt-get install -y nodejs

# 3. Vérifier l'installation
node --version

🪟 Utilisateurs Windows

Il est recommandé d'utiliser la ligne de commande winget pour l'installation, ou de télécharger le package d'installation sur le site officiel de Node.js :

# Utiliser winget pour installer la version LTS de Node.js
winget install OpenJS.NodeJS.LTS

# Vérifier l'installation (un redémarrage du terminal peut être nécessaire)
node --version

2. Installer Claude Code

Ouvrez votre terminal et utilisez npm pour installer Claude Code globalement :

npm install -g @anthropic-ai/claude-code

# Vérifier si l'installation a réussi
claude --version

(Remarque : en cas d'erreur due à des problèmes de permissions, les utilisateurs macOS/Linux peuvent avoir besoin d'utiliser sudo npm install -g @anthropic-ai/claude-code)

3. Configurer et commencer à utiliser

🔑 Obtenir les informations de configuration nécessaires

Pour utiliser ce service, vous devez préparer les deux variables d'environnement suivantes :

Élément	Description	Comment l'obtenir
`ANTHROPIC_AUTH_TOKEN`	Jeton d'authentification API	Obtenu en cliquant sur Ajouter un jeton sur la page Jetons API après l'inscription (commence par `sk-`)
`ANTHROPIC_BASE_URL`	Adresse du service API	Remplir fixement avec : `https://api.codingplanx.ai`

> 📝 Paramètres suggérés lors de la création du jeton : > - Nom : Nommez-le comme vous le souhaitez (ex: claude-code-cli) > - Quota : Définir sur Quota illimité > - Groupe : Choisissez Exclusif Claude code ou Claude 3 et supérieur > - Autres options : Conservez les paramètres par défaut

💻 Démarrer Claude Code

Veuillez choisir la commande de démarrage correspondante en fonction de votre système d'exploitation et de votre terminal. Veuillez d'abord vous rendre dans le répertoire de votre projet :

cd votre-dossier-de-projet

🟢 Linux / macOS (Bash/Zsh)

# Définir les variables d'environnement (valables pour le terminal actuel)
export ANTHROPIC_AUTH_TOKEN="sk-VotreVraieClé"
export ANTHROPIC_BASE_URL="https://api.codingplanx.ai"
export API_TIMEOUT_MS="300000"  # Définir le délai d'attente à 300 secondes pour éviter les déconnexions sur les réponses longues

# Démarrer Claude Code
claude

🔵 Windows PowerShell

# Définir les variables d'environnement (valables pour le terminal actuel)
$env:ANTHROPIC_BASE_URL = "https://api.codingplanx.ai"
$env:ANTHROPIC_AUTH_TOKEN = "sk-VotreVraieClé"
$env:API_TIMEOUT_MS = "300000"

# Démarrer Claude Code
claude

⚫ Windows CMD

set ANTHROPIC_BASE_URL=https://api.codingplanx.ai
set ANTHROPIC_AUTH_TOKEN=sk-VotreVraieClé
set API_TIMEOUT_MS=300000

claude

> 💡 Astuce avancée : Si vous ne voulez pas saisir les variables d'environnement à chaque fois, vous pouvez ajouter les instructions export ci-dessus à votre fichier ~/.bashrc ou ~/.zshrc (Mac/Linux), ou ajouter des variables d'environnement permanentes dans les paramètres système de Windows.

⚙️ Assistant de configuration au premier lancement

Lors du premier lancement de claude, le système vous guidera à travers les paramètres de base :

Choisir le thème (Theme) 👉 Choisissez votre palette de couleurs de terminal préférée, appuyez sur Entrée pour confirmer.
Consignes de sécurité (Safety) 👉 Lisez et confirmez les avertissements de sécurité, appuyez sur Entrée.
Configuration du terminal (Terminal) 👉 Il est recommandé d'utiliser la configuration par défaut, appuyez sur Entrée.
Faire confiance au répertoire (Trust) 👉 Confirmez que vous faites confiance au répertoire de travail actuel, appuyez sur Entrée.

✨ Félicitations ! Lorsque vous voyez l'invite de commande, vous pouvez commencer à discuter avec votre partenaire de programmation IA ! Essayez de taper : "Aide-moi à expliquer la structure principale de ce projet".

❓ Foire aux questions (FAQ)

Q : Vous rencontrez l'erreur `Invalid API Key · Please run /login` ?

R : Cela indique que Claude Code n'a pas réussi à lire vos variables d'environnement. Veuillez vérifier :

Si ANTHROPIC_AUTH_TOKEN et ANTHROPIC_BASE_URL sont correctement définis.
Si le format du jeton est correct (il doit commencer par sk- et ne pas contenir d'espaces ou de guillemets superflus).
Si vous avez configuré des variables d'environnement permanentes, assurez-vous d'avoir redémarré le terminal pour qu'elles prennent effet.

Q : Pourquoi le coin inférieur gauche du terminal affiche-t-il le statut `offline` ?

R : Claude Code ping google.com par défaut pour déterminer l'état du réseau. Il est normal que offline s'affiche dans certains environnements réseau, cela n'affecte en rien votre utilisation normale et la génération de code.

Q : Pourquoi la navigation sur le web (Fetch) par Claude échoue-t-elle ?

R : Avant d'accéder à des pages web externes, Claude Code doit appeler le service officiel pour des vérifications de sécurité. Si vous rencontrez un échec de Fetch :

Assurez-vous que votre ordinateur dispose d'une connexion Internet internationale stable.
Si nécessaire, veuillez activer le proxy global du terminal (ex: export https_proxy=...).

Q : Pourquoi les requêtes affichent-elles toujours `fetch failed` ou expirent-elles ?

R : C'est généralement causé par des fluctuations du réseau ou le transfert via proxy. Solutions :

Vérifiez si la variable d'environnement de délai d'attente est correctement définie : API_TIMEOUT_MS=300000.
Essayez de changer votre nœud de proxy local.
Appuyez sur Ctrl+C pour quitter la session en cours et relancez la commande claude.

Q : Erreur de connexion sur la page web ?

R : Si vous rencontrez une anomalie sur la page web lors de l'obtention du Token, veuillez essayer de vider le cache des cookies de votre navigateur, ou utilisez le mode navigation privée pour vous reconnecter à codingplanx.ai.

📌 Remarques

🛡️ Description de l'interface : Ce site est directement connecté au service de transfert officiel de Claude Code, parfaitement adapté aux outils CLI.
🚦 Limite de trafic : La configuration actuelle ne prend en charge que le trafic API de Claude Code, et ne prend pas en charge les appels API ordinaires utilisés pour d'autres clients tiers.
🔒 Avertissement de sécurité : Veuillez conserver précieusement votre jeton API (sk-...), ne le codez jamais en dur dans votre code et ne le téléversez pas sur des dépôts GitHub publics.

🔗 Liens connexes

📖 Documentation officielle de Claude Code
🟢 Site officiel de Node.js
🌐 Console Codingplanx.ai