Cette page fournit un aperçu des options de déploiement disponibles et vous aide à choisir la bonne configuration pour votre organisation.

Comparaison des fournisseurs

FonctionnalitéAnthropicAmazon BedrockGoogle Vertex AI
RégionsPays pris en chargeMultiples régions AWSMultiples régions GCP
Mise en cache des promptsActivée par défautActivée par défautContactez Google pour l’activation
AuthentificationClé APIIdentifiants AWS (IAM)Identifiants GCP (OAuth/Compte de service)
Suivi des coûtsTableau de bordAWS Cost ExplorerFacturation GCP
Fonctionnalités d’entrepriseÉquipes, surveillance de l’utilisationPolitiques IAM, CloudTrailRôles IAM, Cloud Audit Logs

Fournisseurs cloud

Infrastructure d’entreprise

Aperçu de la configuration

Claude Code prend en charge des options de configuration flexibles qui vous permettent de combiner différents fournisseurs et infrastructures :

Comprenez la différence entre :

  • Proxy d’entreprise : Un proxy HTTP/HTTPS pour router le trafic (défini via HTTPS_PROXY ou HTTP_PROXY)
  • Passerelle LLM : Un service qui gère l’authentification et fournit des points de terminaison compatibles avec les fournisseurs (défini via ANTHROPIC_BASE_URL, ANTHROPIC_BEDROCK_BASE_URL, ou ANTHROPIC_VERTEX_BASE_URL)

Les deux configurations peuvent être utilisées en tandem.

Utilisation de Bedrock avec proxy d’entreprise

Routez le trafic Bedrock via un proxy HTTP/HTTPS d’entreprise :

# Activer Bedrock
export CLAUDE_CODE_USE_BEDROCK=1
export AWS_REGION=us-east-1

# Configurer le proxy d'entreprise
export HTTPS_PROXY='https://proxy.example.com:8080'

Utilisation de Bedrock avec passerelle LLM

Utilisez un service de passerelle qui fournit des points de terminaison compatibles Bedrock :

# Activer Bedrock
export CLAUDE_CODE_USE_BEDROCK=1

# Configurer la passerelle LLM
export ANTHROPIC_BEDROCK_BASE_URL='https://your-llm-gateway.com/bedrock'
export CLAUDE_CODE_SKIP_BEDROCK_AUTH=1  # Si la passerelle gère l'authentification AWS

Utilisation de Vertex AI avec proxy d’entreprise

Routez le trafic Vertex AI via un proxy HTTP/HTTPS d’entreprise :

# Activer Vertex
export CLAUDE_CODE_USE_VERTEX=1
export CLOUD_ML_REGION=us-east5
export ANTHROPIC_VERTEX_PROJECT_ID=your-project-id

# Configurer le proxy d'entreprise
export HTTPS_PROXY='https://proxy.example.com:8080'

Utilisation de Vertex AI avec passerelle LLM

Combinez les modèles Google Vertex AI avec une passerelle LLM pour une gestion centralisée :

# Activer Vertex
export CLAUDE_CODE_USE_VERTEX=1

# Configurer la passerelle LLM
export ANTHROPIC_VERTEX_BASE_URL='https://your-llm-gateway.com/vertex'
export CLAUDE_CODE_SKIP_VERTEX_AUTH=1  # Si la passerelle gère l'authentification GCP

Configuration de l’authentification

Claude Code utilise le ANTHROPIC_AUTH_TOKEN pour les en-têtes Authorization et Proxy-Authorization lorsque nécessaire. Les drapeaux SKIP_AUTH (CLAUDE_CODE_SKIP_BEDROCK_AUTH, CLAUDE_CODE_SKIP_VERTEX_AUTH) sont utilisés dans les scénarios de passerelle LLM où la passerelle gère l’authentification du fournisseur.

Choisir la bonne configuration de déploiement

Considérez ces facteurs lors de la sélection de votre approche de déploiement :

Accès direct au fournisseur

Idéal pour les organisations qui :

  • Veulent la configuration la plus simple
  • Ont une infrastructure AWS ou GCP existante
  • Ont besoin de surveillance et conformité natives du fournisseur

Proxy d’entreprise

Idéal pour les organisations qui :

  • Ont des exigences de proxy d’entreprise existantes
  • Ont besoin de surveillance du trafic et de conformité
  • Doivent router tout le trafic via des chemins réseau spécifiques

Passerelle LLM

Idéal pour les organisations qui :

  • Ont besoin de suivi de l’utilisation entre équipes
  • Veulent basculer dynamiquement entre modèles
  • Nécessitent une limitation de taux personnalisée ou des budgets
  • Ont besoin d’une gestion d’authentification centralisée

Débogage

Lors du débogage de votre déploiement :

  • Utilisez la commande slash claude /status. Cette commande fournit une observabilité sur tous les paramètres d’authentification, proxy et URL appliqués.
  • Définissez la variable d’environnement export ANTHROPIC_LOG=debug pour journaliser les requêtes.

Meilleures pratiques pour les organisations

  1. Nous recommandons fortement d’investir dans la documentation pour que Claude Code comprenne votre base de code. De nombreuses organisations créent un fichier CLAUDE.md (que nous appelons aussi mémoire) à la racine du dépôt qui contient l’architecture système, comment exécuter les tests et autres commandes courantes, et les meilleures pratiques pour contribuer à la base de code. Ce fichier est généralement enregistré dans le contrôle de source pour que tous les utilisateurs puissent en bénéficier. En savoir plus.
  2. Si vous avez un environnement de développement personnalisé, nous trouvons que créer un moyen “en un clic” d’installer Claude Code est essentiel pour développer l’adoption dans une organisation.
  3. Encouragez les nouveaux utilisateurs à essayer Claude Code pour les Q&R de base de code, ou sur de petites corrections de bogues ou demandes de fonctionnalités. Demandez à Claude Code de faire un plan. Vérifiez les suggestions de Claude et donnez des commentaires si c’est hors sujet. Au fil du temps, à mesure que les utilisateurs comprennent mieux ce nouveau paradigme, ils seront plus efficaces pour laisser Claude Code fonctionner de manière plus agentique.
  4. Les équipes de sécurité peuvent configurer des permissions gérées pour ce que Claude Code est et n’est pas autorisé à faire, qui ne peuvent pas être écrasées par la configuration locale. En savoir plus.
  5. MCP est un excellent moyen de donner plus d’informations à Claude Code, comme se connecter aux systèmes de gestion de tickets ou aux journaux d’erreurs. Nous recommandons qu’une équipe centrale configure les serveurs MCP et enregistre une configuration .mcp.json dans la base de code pour que tous les utilisateurs en bénéficient. En savoir plus.

Chez Anthropic, nous faisons confiance à Claude Code pour alimenter le développement dans chaque base de code Anthropic. Nous espérons que vous apprécierez utiliser Claude Code autant que nous !

Prochaines étapes