Claude Code

Claude Code est l’outil de programmation en terminal d’Anthropic. Configurez l’adresse API, l’API Key et l’ID du modèle pour utiliser l’endpoint Anthropic Messages compatible d’AGTCloud.

Ce tutoriel couvre uniquement Claude Code CLI. Le support des appels d’outils, de la réflexion étendue et des fonctions expérimentales varie selon le modèle. Choisissez un modèle accessible à l’API Key et compatible Anthropic Messages.

Prérequis

Avant de commencer, vérifiez que vous avez :

Préparé un environnement de terminal et Git ;
Créé un compte AGTCloud et ouvert une session ;
Créé un Token dans API Keys ;
Trouvé dans le catalogue de modèles un ID compatible Anthropic accessible à votre Token.

Installer Claude Code

Choisissez la méthode adaptée à votre système. Les scripts natifs se mettent à jour automatiquement ; Homebrew et WinGet nécessitent une mise à jour manuelle via leur gestionnaire de packages.

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

Après l’installation, rouvrez le terminal et vérifiez la version :

claude --version
claude doctor

claude doctor vérifie l’installation et les fichiers de configuration. Si claude est introuvable, rouvrez le terminal et vérifiez que le répertoire d’installation figure dans PATH.

Configurer AGTCloud

Claude Code envoie les requêtes à ANTHROPIC_BASE_URL. Renseignez seulement l’API Origin AGTCloud, sans ajouter /v1, car Claude Code demande lui-même /v1/messages.

Configuration temporaire

Ces paramètres s’appliquent uniquement à la session de terminal actuelle. Remplacez your-api-key et MODEL_ID par votre Token et votre ID de modèle.

unset ANTHROPIC_AUTH_TOKEN
export ANTHROPIC_BASE_URL="https://api.agtcloud.cn"
export ANTHROPIC_API_KEY="your-api-key"
export ANTHROPIC_MODEL="MODEL_ID"

Variable d’environnement	Rôle
`ANTHROPIC_BASE_URL`	Diriger les requêtes Claude Code vers l’adresse API AGTCloud affichée ici
`ANTHROPIC_API_KEY`	Envoyer l’API Key AGTCloud via le Header `X-Api-Key`
`ANTHROPIC_MODEL`	Définir l’ID du modèle par défaut pour cette session

Supprimez les variables d’authentification en conflit

Si ANTHROPIC_AUTH_TOKEN est déjà définie, Claude Code l’utilise comme Bearer Token et peut remplacer ANTHROPIC_API_KEY. Supprimez cette variable avant d’appliquer ce tutoriel.

Configuration persistante

Pour appliquer les paramètres à chaque ouverture du terminal, ajoutez-les au fichier de configuration du shell ou aux variables utilisateur Windows. L’API Key sera conservée en clair en local : utilisez cette méthode uniquement sur un appareil personnel fiable.

Éditez ~/.zshrc et ajoutez :

export ANTHROPIC_BASE_URL="https://api.agtcloud.cn"
export ANTHROPIC_API_KEY="your-api-key"
export ANTHROPIC_MODEL="MODEL_ID"

Enregistrez, puis rechargez :

source ~/.zshrc

Choisir un modèle

MODEL_ID doit être remplacé, ce n’est pas un nom réel. Copiez dans le catalogue de modèles un ID accessible à l’API Key et compatible Anthropic Messages.

Dans Claude Code, /model permet aussi de consulter et changer le modèle de session. La liste automatique de tous les modèles AGTCloud dépend de la version et de l’API Key. Si le modèle cible est absent, définissez son ID directement via ANTHROPIC_MODEL.

Interface de sélection des modèles Claude Code

Démarrer et valider la connexion

Ouvrir le répertoire du projet

cd /path/to/your/project

Démarrer Claude Code

claude

Si le premier démarrage demande de confirmer l’utilisation de l’API Key de l’environnement, suivez l’invite du terminal.

Vérifier la configuration actuelle

Exécutez dans Claude Code :

/status

Confirmez une authentification par API Key et vérifiez que la Base URL est l’adresse API AGTCloud affichée ici. Elle ne doit pas contenir de /v1 dupliqué.

Effectuer un test en lecture seule

Dans un projet de test contenant README.md, saisissez :

Veuillez lire README.md et résumer l’objectif de ce projet en trois points. Ne modifiez aucun fichier.

Une réponse normale et un appel correspondant dans la console AGTCloud confirment la connexion de base.

Après avoir vérifié la configuration, envoyez une question simple pour confirmer la réponse du modèle.

Test de conversation de base Claude Code

Questions fréquentes

Symptôme	Vérifier en priorité	Solution
Commande `claude` introuvable	Installation et `PATH`	Rouvrez le terminal, exécutez `claude doctor` et, si nécessaire, relancez l’installation officielle
Une connexion est encore demandée au démarrage	API Key active dans le terminal qui démarre Claude Code	Vérifiez `ANTHROPIC_API_KEY`, rouvrez le terminal et redémarrez
L’API Key n’est pas appliquée	Présence simultanée de `ANTHROPIC_AUTH_TOKEN`	Supprimez la variable en conflit et vérifiez la source d’authentification avec `/status`
Réponse `401`	API Key, variables et état du Token	Copiez une API Key valide et confirmez la source avec `/status`
Réponse `403`	Autorisations du Token et du modèle, état du compte	Vérifiez dans la console le Token et les modèles accessibles
Réponse `404`	Base URL et ID du modèle	Utilisez seulement `https://api.agtcloud.cn`, sans `/v1`, et recopiez l’ID du modèle
Modèle introuvable ou inutilisable	Modèles accessibles à l’API Key et protocoles	Choisissez Anthropic Messages et définissez l’ID complet via `ANTHROPIC_MODEL`
Certains outils ou fonctions avancées sont indisponibles	Capacités du modèle et compatibilité du Gateway	Validez d’abord la conversation de base ; les fonctions avancées dépendent du modèle et de son adaptation actuelle

En cas de problème non identifié, consignez l’heure, l’ID du modèle, le code HTTP et l’erreur expurgée, puis consultez Erreurs et dépannage. Ne fournissez pas d’API Key complète.

Conseils de sécurité

Créez une API Key distincte pour Claude Code afin de gérer les autorisations et la désactivation.
N’inscrivez pas de véritable clé dans le code, un dépôt, une capture d’écran, un journal ou un script partagé.
Sur un appareil partagé ou en équipe, privilégiez le gestionnaire d’identifiants du système ou la distribution centralisée des secrets.
En cas de fuite présumée, désactivez ou supprimez immédiatement l’API Key dans la console, puis créez-en une nouvelle.

Consultez ensuite API Key, Base URL et authentification et Anthropic Messages.

Sur cette page