Utiliser Claude Code avec DGrid

​

Avant de commencer

• Un Mac connecté à Internet. Les commandes utilisent Zsh, le shell par défaut de macOS.
• Un compte DGrid disposant de crédits et d’un accès au modèle Claude choisi.
• Pour l’installation avec npm : Node.js 22 ou version ultérieure et npm. Les instructions figurent ci-dessous.

​

Étape 1 : créer une clé API DGrid et choisir un modèle

1. Connectez-vous à DGrid et ouvrez API Keys.
2. Cliquez sur Create New Key, nommez la clé et créez-la.
3. Copiez la clé pour la suite. Ne montrez jamais la clé complète dans les captures ou fichiers partagés.
4. Dans la liste DGrid, trouvez un modèle Claude disponible et copiez son ID complet. Ce guide utilise anthropic/claude-opus-5.5.

• CLI
• Application de bureau

​

Étape 2 : installer Claude Code

Si Claude Code est déjà installé, exécutez claude --version. Si un numéro s’affiche, passez à l’étape 3.

​

Installation avec npm

Vérifiez d’abord la présence de Node.js et npm :

node -v
npm -v

Si une commande est introuvable ou si Node.js est antérieur à 22, installez la version LTS actuelle depuis la page Node.js. Choisissez l’installateur macOS, qui inclut npm. Ouvrez ensuite un nouveau terminal et relancez les deux commandes.Installez Claude Code dans votre répertoire utilisateur :

npm install -g @anthropic-ai/claude-code --prefix "$HOME/.local"

Ajoutez le répertoire d’installation au PATH du terminal et vérifiez la version :

export PATH="$HOME/.local/bin:$PATH"
claude --version

Cette installation utilisateur ne nécessite pas sudo. Pour conserver le PATH dans les nouveaux terminaux, ajoutez la même ligne export PATH à ~/.zshrc avec un éditeur de texte.

​

Alternative : installateur natif

Vous pouvez utiliser l’installateur natif officiel, sans installation séparée de Node.js :

curl -fsSL https://claude.ai/install.sh | bash

Après l’installation, ouvrez un terminal et vérifiez claude --version. Si la commande est introuvable, ajoutez ~/.local/bin au PATH comme ci-dessus. Choisissez une seule méthode. Si l’URL renvoie du HTML ou si le téléchargement échoue, installez Node.js et utilisez npm.

​

Étape 3 : configurer DGrid dans le terminal actuel

Exécutez ce bloc dans Zsh. La dernière commande demande la clé sans afficher votre saisie :

export ANTHROPIC_BASE_URL="https://api.dgrid.ai"
unset ANTHROPIC_API_KEY
export ANTHROPIC_AUTH_TOKEN
read -rs "ANTHROPIC_AUTH_TOKEN?Paste your DGrid API key (hidden): "

À l’invite Paste your DGrid API key (hidden):, collez votre clé DGrid et appuyez sur Entrée. Le terminal revient à l’invite sans afficher la clé.Continuez dans ce terminal pour que Claude Code hérite des variables. Ces paramètres ne valent que pour cette session. Dans un nouveau terminal, répétez cette étape ou utilisez la configuration de projet facultative ci-dessous.Les paramètres d’un ancien fournisseur peuvent encore s’appliquer. unset supprime une variable du shell, pas une entrée de fichier. Vérifiez la connexion à l’étape 5 ; si une autre clé est détectée, consultez le dépannage.

​

Étape 4 : lancer Claude Code

Créez un dossier dédié à votre première session, puis lancez Claude Code avec l’ID DGrid complet :

mkdir -p "$HOME/dgrid-claude-demo"
cd "$HOME/dgrid-claude-demo"
claude --model "anthropic/claude-opus-5.5"

Si Claude Code demande si le dossier est fiable, vérifiez le chemin et sélectionnez Yes, I trust this folder pour le dossier créé. Terminez les éventuels réglages d’apparence du premier lancement.

​

Étape 5 : vérifier la connexion active

Dans Claude Code, saisissez :

/status

L’onglet Status doit afficher :

Champ d’état	Valeur attendue
Auth token	ANTHROPIC_AUTH_TOKEN
Anthropic base URL	https://api.dgrid.ai
Model	anthropic/claude-opus-5.5

Si vous avez choisi un autre modèle Claude, vérifiez son ID complet. Appuyez sur Échap pour revenir à la conversation.

​

Étape 6 : envoyer votre premier message

Saisissez :

Reply with exactly: DGrid connection successful

Appuyez sur Entrée et attendez la réponse :

DGrid connection successful

Vous pouvez continuer à utiliser Claude Code via DGrid. Pour consulter l’utilisation, retrouvez le modèle et l’heure dans l’historique DGrid. Une requête terminée porte le statut Success.

Le nombre de tokens et les frais varient selon la requête. La capture montre un exemple incluant l’écriture en cache.

​

Facultatif : enregistrer les paramètres du projet

Pour éviter de ressaisir les variables, configurez .claude/settings.local.json dans le projet. Avant de créer ce fichier, ajoutez .claude/settings.local.json au .gitignore du projet pour exclure la clé du suivi de versions.Créez ou modifiez le fichier local en remplaçant la valeur de substitution par votre clé DGrid :

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.dgrid.ai",
    "ANTHROPIC_AUTH_TOKEN": "<your-dgrid-api-key>",
    "ANTHROPIC_API_KEY": ""
  },
  "model": "anthropic/claude-opus-5.5"
}

Fusionnez ces champs avec les paramètres existants. La clé est stockée dans un fichier local : gardez-le privé. Dans un nouveau terminal, ouvrez le dossier du projet, lancez claude et vérifiez avec /status. Les portées sont décrites dans le guide officiel de la passerelle.

Claude Code est aussi disponible dans l’onglet Code de l’application Claude. Configurez sa passerelle séparément de la CLI. Les variables du terminal ne configurent pas la connexion d’inférence tierce de l’application.

​

1 Ouvrir les paramètres d’inférence tierce

1. Téléchargez et installez l’application Claude pour macOS, puis ouvrez-la.
2. Dans la barre de menus macOS, choisissez Help → Troubleshooting → Enable Developer Mode.
3. Autorisez le redémarrage si nécessaire, puis choisissez Developer → Configure Third-Party Inference….
4. Si une erreur de passerelle propose Open Setup, ce bouton ouvre aussi la configuration.

Si le menu Developer disparaît après la première configuration tierce, réactivez Developer Mode depuis Help. Le guide officiel de configuration dans l’application explique ce comportement et l’option locale Apply Changes.

​

2 Saisir les paramètres de connexion DGrid

Ouvrez Connection et utilisez ces valeurs :

Champ	Valeur à saisir ou sélectionner
Inference provider	Gateway
Credential kind	Static API key
Gateway base URL	https://api.dgrid.ai
Gateway API key	Votre clé API DGrid
Gateway auth scheme	bearer

Laissez Artifact preview iframe origin à sa valeur par défaut. Masquez la clé avec l’icône en forme d’œil avant toute capture.

Cliquez sur Apply Changes pour appliquer la configuration locale ; l’application redémarre. Vous pouvez aussi utiliser Test connection. En cas d’échec, ouvrez les détails et vérifiez le modèle testé et la réponse.

​

3 Choisir le modèle et démarrer une session locale

1. Ouvrez l’onglet Code et créez une session.
2. Si un sélecteur d’environnement apparaît, choisissez This computer.
3. Dans le sélecteur, choisissez anthropic/claude-opus-5.5 ou un autre modèle Claude disponible.
4. Cliquez sur Choose a folder ou sur le contrôle du dossier de projet et choisissez dgrid-claude-demo. Si vous avez ignoré la CLI, créez et sélectionnez un nouveau dossier.

Envoyez :

Reply with exactly: DGrid connection successful

Attendez la réponse. Le nom du modèle sous la zone de saisie doit correspondre à votre choix.

Vous pouvez poursuivre votre travail avec DGrid dans cette session.

​

Dépannage

​

Le terminal indique command not found ou permission denied

type -a claude

"$HOME/.local/bin/claude" --version

​

Claude Code détecte une autre clé API ou une mauvaise passerelle

​

Une requête échoue avec une erreur d’authentification ou de modèle

​

L’application de bureau signale une erreur de passerelle

​

Le modèle attendu n’apparaît pas dans l’application

​

Ressources connexes

• Vue d’ensemble des tutoriels d’intégration
• Démarrage rapide AI Gateway
• Utiliser Claude Code avec DGrid