Skip to main content

Claude Code — Intégration IDE

Claude Code est l’assistant de codage agent d’Anthropic. En le pointant vers le proxy compatible Anthropic de SecureAI, chaque invite envoyée par vos développeurs passe par SMLTP, DLP, analyse PII, Prompt Shield, limitation de débit et gouvernance des modèles — sans aucune modification du flux de travail du développeur.

Comment ça marche

SecureAI expose un point de terminaison compatible avec l’API Anthropic Messages à l’adresse :
Claude Code prend nativement en charge la redirection de tout le trafic vers une URL de base personnalisée via la variable d’environnement ANTHROPIC_BASE_URL. Une fois configuré, il communique son protocole Anthropic natif directement à SecureAI — aucun proxy local ou script wrapper n’est requis.
Toutes les activités apparaissent dans le tableau de bord d’administration SecureAI sous AI Gateway → Journaux d’audit, attribuées à la clé API du développeur.

Étape 1 — Installer Claude Code


Étape 2 — Générer une clé API

  1. Accédez à Admin → Clés API (https://<your-host>/admin/apis)
  2. Cliquez sur Créer une clé API
  3. Définissez un nom (par exemple claude-code-dev-jane)
  4. Configurez :
    • Modèles autorisés — sélectionnez les LLM que la clé peut utiliser (voir modèles disponibles)
    • Politique SMLTP — sélectionnez la stratégie de conformité (internal, confidential, hipaa, etc.)
    • Limites de taux selon les besoins
  5. Copiez la valeur sk-… — elle n’est affichée qu’une seule fois

Étape 3 — Configurer Claude Code

L’approche recommandée consiste à ajouter les paramètres au fichier de paramètres locaux au niveau du projet (.claude/settings.local.json), qui est ignoré par git par défaut.
.claude/settings.local.json
ANTHROPIC_API_KEY doit être explicitement défini sur une chaîne vide pour empêcher Claude Code de tenter de s’authentifier directement auprès d’Anthropic.
Profil de coque (alternative)Vous pouvez également ajouter les variables à ~/.zshrc, ~/.bashrc ou à votre PowerShell $PROFILE au lieu du fichier de paramètres. Le fichier de paramètres est préféré pour les projets d’équipe afin que chaque développeur hérite automatiquement de la même configuration.

Étape 4 — Vérifiez la connexion

Démarrez Claude Code depuis le répertoire de votre projet :
Exécutez /status dans la session. Vous devriez voir :
Cela confirme que tout le trafic est acheminé via SecureAI.

Modèles disponibles

SecureAI expose le même catalogue de modèles disponible dans l’interface de discussion. Utilisez n’importe quelle valeur id du tableau ci-dessous dans les variables d’environnement ci-dessus.

Anthropique (Claude)

OpenAI

Google (Gémeaux)

Méta (Lama)

###Mistral

Recherche profonde

xAI (Grök)

Qwen

Auto-hébergé (points de terminaison SMLTP distants)

Les modèles auto-hébergés enregistrés en tant que points de terminaison SMLTP distants actifs sont automatiquement disponibles. Leurs identifiants suivent le modèle self-hosted/<model-name>. Exécutez /status dans Claude Code ou appelez GET /api/claude-code/v1/models pour voir la liste en direct.

Rôles modèles de Claude Code

Claude Code utilise différents modèles pour différentes tâches internes. Mappez chaque rôle à n’importe quel modèle du catalogue ci-dessus : Vous pouvez mélanger librement les fournisseurs. Par exemple, utilisez Gemini pour les sous-tâches rapides/bon marché et Claude pour la boucle de raisonnement principale :

Application de la sécurité

Chaque requête via le proxy est soumise à la pile de sécurité complète SecureAI : La stratégie SMLTP est héritée de la configuration de la clé API. Pour modifier la stratégie d’une clé, accédez à Admin → Clés API, modifiez la clé et sélectionnez une autre Politique SMLTP.

Dépannage

/status affiche toujours api.anthropic.com

Claude Code a mis en cache les informations d’identification d’une connexion précédente. Exécutez /logout dans une session Claude Code, puis redémarrez :

401 Unauthorized

  • Vérifiez que la clé sk-… est active dans Admin → Clés API
  • Vérifiez que ANTHROPIC_API_KEY est défini sur une chaîne vide ("")

Modèle non disponible

  • Vérifiez la liste des Modèles autorisés de la clé API dans Admin → Clés API.
  • Appelez GET /api/claude-code/v1/models (avec votre token Bearer sk-…) pour voir exactement à quoi la clé peut accéder

Blocage DLP/PII

Si une invite est bloquée, Claude Code recevra une réponse d’erreur avec un message expliquant la violation. L’incident est enregistré dans Admin → Incidents et visible dans AI Gateway → Journaux d’audit.