Assistant de configuration

L'assistant de configuration se lance automatiquement si Claude Sandbox n'a jamais été configuré, ou depuis le bouton Assistant de l'écran d'accueil. Il peut être relancé à tout moment pour modifier la configuration.

Cette étape vérifie que votre système est prêt pour WSL2.

• Virtualisation BIOS (VT-x / AMD-V) — doit être activée dans l'UEFI/BIOS
• WSL2 — bouton « Installer WSL2 » si absent. Un redémarrage Windows est requis après l'installation.
• Compte administrateur — informatif uniquement. Claude Sandbox ne requiert pas d'être lancé en admin ; un prompt UAC s'affiche au moment de l'installation de la VM.

Claude Sandbox utilise une distribution WSL2 dédiée et verrouillée : Ubuntu-Claude-Sandbox. Elle ne peut pas être remplacée par une autre distribution.

• Bouton Installer — télécharge Ubuntu 24.04 et configure l'isolation totale (automount=false, interop=false). L'installation est visible dans le terminal intégré.

Claude Code est installé Linux-nativement dans la distribution sandboxée via nvm et npm. L'installation peut prendre jusqu'à 10 minutes.

Configurez les paramètres de connexion à l'API Anthropic. Ces valeurs sont exportées comme variables d'environnement à chaque ouverture d'un terminal.

• Clé d'API Anthropic (ANTHROPIC_API_KEY) — requise pour Claude Code et le Prompt Engineer. Obtenue sur console.anthropic.com.
• URL du proxy (ANTHROPIC_BASE_URL) — optionnel. À renseigner si votre organisation utilise un proxy d'entreprise (ex : Matcha) ou un service compatible Anthropic (ex : Ollama).
• Case « Utiliser mon compte Claude » — si cochée, la clé d'API et l'URL proxy ne sont pas exportées. Claude Code utilise alors la session de connexion Claude native. Note : le Prompt Engineer nécessite toujours une clé d'API.

Sélectionnez les modèles disponibles pour le Prompt Engineer intégré à l'application. Ces modèles sont utilisés pour les appels directs à l'API /v1/messages.

Sélectionnez les modèles disponibles pour les sessions de terminal Claude Code. Le modèle sélectionné est exporté comme ANTHROPIC_MODEL à chaque ouverture d'un terminal.

Configurez le comportement de Claude Code au lancement de chaque session.

• Contexte 1 million de tokens — ajoute le suffixe [1m] au nom du modèle. Optionnel sur Sonnet 4.6 (nécessite des crédits) ; inclus par défaut sur Opus 4.7+.
• Tmux — lance Claude Code dans une session tmux nommée claude-<repo>. Utile pour les workflows multi-panneaux et pour partager une session entre plusieurs onglets du même dépôt.
• Équipe d'agents — active le mode expérimental d'équipes d'agents de Claude Code (CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS).
• Journal du terminal — affiche un en-tête de diagnostic avant Claude et un message avec le code de sortie après. Utile pour le débogage de sessions.

La configuration est complète. Claude Sandbox est prêt à utiliser. Cliquez sur Terminer pour fermer l'assistant et commencer à travailler.

Sélectionnez le type de serveur MCP à configurer. Trois presets sont disponibles, chacun pré-remplissant les paramètres typiques du serveur cible.

• SQL Server — serveur Microsoft SQL Server. Idéal pour les bases de données d'entreprise et les applications .NET.
• MySQL — serveur MySQL ou MariaDB. Compatible avec la plupart des stacks web.
• Azure DevOps — connexion à votre organisation Azure DevOps pour accéder aux dépôts, work items et pipelines.

Renseignez les paramètres de connexion spécifiques au serveur sélectionné.

• Hôte et port — adresse du serveur et port d'écoute (pré-remplis selon le preset).
• Base de données — nom de la base cible (SQL Server et MySQL uniquement).
• Identifiants — utilisateur et mot de passe, ou jeton d'accès personnel (Azure DevOps).

Donnez un nom unique à ce serveur MCP. Ce nom est utilisé par Claude Code pour référencer le serveur dans les conversations et les outils disponibles.

Vérifiez le résumé de la configuration avant d'enregistrer. Cliquez sur Terminer pour écrire le serveur MCP dans le fichier ~/.claude/mcp.json de la distribution WSL2.