Tutoriel de configuration du code Claude

📋 Étapes préparatoires

Avant de commencer, veuillez vous assurer d'avoir :

Créé un compte Koze et vous être connecté(e)
Créé une clé API sur la page de gestion des API
Installé Claude Code (npm install -g @anthropic-ai/claude-code)

🚀 Étape 1 : Configuration des variables d'environnement

Exécutez les commandes suivantes dans le terminal pour définir l'adresse et la clé API comme variables d'environnement :

# Définir l'adresse du proxy Koze sur l'URL de base
export ANTHROPIC_BASE_URL='https://api.kozeai.com/v1'

# Définir la clé API créée dans l'interface d'administration de Koze
export ANTHROPIC_AUTH_TOKEN="Votre API" Clé"

💡 Conseil : Remplacez https://api.kozeai.com par le domaine de votre service. Les clés API peuvent être consultées ou créées sur la page « Gestion des API → Clés existantes ». 🔧 Étape 2 : Configuration du plugin VSCode (Facultatif) Si vous utilisez le plugin Claude pour VSCode, vous devez le configurer dans le fichier `~/.claude/config.json` : { "primaryApiKey": "Votre clé API", "apiBaseUrl": "https://api.kozeai.com/v1" } Si le fichier n'existe pas, veuillez le créer manuellement.

macOS / Linux : ~/.claude/config.json

Windows : C:\Users\Votre nom d'utilisateur\.claude\config.json

🎯 Étape 3 : Lancer Claude Code

Après avoir configuré les variables d'environnement, lancez-le directement dans le terminal :

claude

Claude Code utilisera automatiquement l'adresse du proxy Koze que vous avez configurée pour effectuer les requêtes.

📌 Variables d'environnement persistantes

Pour éviter de réinitialiser les variables à chaque ouverture du terminal, il est recommandé de les enregistrer dans le fichier de configuration du shell :

# Utilisateur Bash echo 'export ANTHROPIC_BASE_URL='https://api.kozeai.com/v1' >>> ~/.bashrc echo 'export ANTHROPIC_AUTH_TOKEN='votre clé API' >>> ~/.bashrc source ~/.bashrc # Utilisateur Zsh echo 'export ANTHROPIC_BASE_URL='https://api.kozeai.com/v1' >>> ~/.zshrc echo 'export ANTHROPIC_AUTH_TOKEN='votre clé API' >> ~/.zshrc source ~/.zshrc

✅ Vérifier la connexion

Après avoir lancé Claude Code, si une interface de dialogue normale s'affiche, la configuration a réussi.
Vous pouvez consulter l'historique des appels en temps réel sur la page « Statistiques d'utilisation » de Koze. ⚠️ Foire aux questions

Problème Solution

Conseil : Clé API invalide Vérifiez que la clé API a été copiée correctement, en vous assurant qu'il n'y a pas d'espaces supplémentaires.

Délai de connexion dépassé Vérifiez que l'URL de base est correcte et contient le suffixe /v1

Modèle indisponible Consultez la liste des modèles disponibles pour le package actuel. Le lobby des mannequins Koze

Problème	Solution
Conseil : Clé API invalide	Vérifiez que la clé API a été copiée correctement, en vous assurant qu'il n'y a pas d'espaces supplémentaires.
Délai de connexion dépassé	Vérifiez que l'URL de base est correcte et contient le suffixe `/v1`
Modèle indisponible	Consultez la liste des modèles disponibles pour le package actuel. Le lobby des mannequins Koze