--- title: Choisir un environnement d'agent url: https://platform.claude.com/docs/fr/managed-agents/choosing-an-environment description: Décidez si les outils et le code de Claude Managed Agents s'exécutent dans un environnement cloud géré par Anthropic ou dans un sandbox auto-hébergé, et découvrez ce qui change si vous passez de l'un à l'autre. featureMetadata: topic: title: Managed Agents url: https://platform.claude.com/docs/en/managed-agents/overview status: beta betaHeader: managed-agents-2026-04-01 --- Un environnement détermine où s'exécutent les outils et le code de votre agent. Ils s'exécutent dans un « sandbox » (bac à sable). Un sandbox est un espace de travail isolé, tel qu'un conteneur, dans lequel l'agent exécute des commandes et travaille sur des fichiers. Vous disposez de deux options : * **Environnement cloud :** Anthropic exécute le sandbox pour vous. Chaque session obtient son propre conteneur Linux neuf sur une infrastructure gérée par Anthropic, avec les langages, bases de données et utilitaires courants déjà installés. Vous choisissez ses règles réseau et les éventuels paquets supplémentaires à installer. * **Sandbox auto-hébergé :** Vous exécutez le sandbox sur votre propre infrastructure. Claude s'exécute toujours du côté d'Anthropic et décide quel outil appeler ensuite. Un programme que vous exécutez, appelé « worker » (processus de travail), effectue les appels aux outils bash et de fichiers de l'agent sur vos machines et renvoie chaque résultat. Il peut également servir des outils personnalisés. La définition de l'agent est la même quelle que soit l'option choisie. Vous définissez le modèle, le prompt et les outils sur l'[agent](https://platform.claude.com/docs/fr/managed-agents/agent-setup), et non sur l'environnement. ## Commencer avec un environnement cloud Si vous ne savez pas quelle option choisir, ou si vous découvrez Claude Managed Agents, commencez avec un [environnement cloud](https://platform.claude.com/docs/fr/managed-agents/environments), comme le fait le [guide de démarrage rapide](https://platform.claude.com/docs/fr/managed-agents/quickstart). Anthropic exécute un conteneur isolé pour chaque session, avec les langages et outils courants déjà installés, vous n'avez donc rien à héberger. Choisissez un sandbox auto-hébergé uniquement si les outils doivent s'exécuter sur une infrastructure que vous contrôlez. ## Comparer les options Le tableau compare les deux options. | | [Environnement cloud](https://platform.claude.com/docs/fr/managed-agents/environments) (par défaut) | [Sandbox auto-hébergé](https://platform.claude.com/docs/fr/managed-agents/self-hosted-sandboxes) | | --------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Où s'exécutent les outils et le code | Un sandbox géré par Anthropic | Votre worker, sur votre infrastructure | | Ce qui parvient à Anthropic | L'[historique de conversation](https://platform.claude.com/docs/fr/managed-agents/events-and-streaming#list-past-events), les [résultats des outils](https://platform.claude.com/docs/fr/managed-agents/tools#available-tools), les fichiers et l'état du sandbox, les skills et les magasins de mémoire | L'historique de conversation, les résultats des outils, les skills et les magasins de mémoire. Les fichiers et processus du sandbox restent sur votre worker. | | Ce que vous exploitez | Rien | Les hôtes des workers, leur durcissement, leurs limites réseau et la clé d'environnement avec laquelle votre worker s'authentifie | | Portée réseau | Les règles réseau que vous définissez sur l'environnement | Votre propre politique réseau | | Montage de fichiers et de dépôts GitHub | Géré par Anthropic | Géré par vous | | Magasins de mémoire | Montés par Anthropic dans `/mnt/memory/` | Téléchargés dans `/mnt/memory/` et synchronisés par le worker | | Cycle de vie du sandbox | Géré par Anthropic | Géré par vous | | Choisissez-le lorsque | C'est l'option par défaut. Vous n'avez pas besoin que les outils s'exécutent sur votre propre infrastructure. | Les outils doivent s'exécuter sur une infrastructure que vous contrôlez. | ## Quand choisir un sandbox auto-hébergé Un sandbox auto-hébergé convient lorsque l'agent doit effectuer l'une des actions suivantes : * **Travailler sur des données qui ne peuvent pas quitter votre réseau :** Les fichiers et processus de l'agent restent sur votre worker. Ce qu'un outil renvoie au modèle parvient tout de même au service Managed Agents. * **Atteindre des services internes qui ne sont pas routables publiquement :** Les outils bash et de fichiers de l'agent, ainsi que tous les outils personnalisés servis par votre worker, s'exécutent au sein de votre réseau. C'est Anthropic, et non votre worker, qui se connecte aux serveurs MCP de l'agent. Un serveur privé peut se trouver devant votre système de tickets interne ou le wiki de votre entreprise. Pour l'atteindre, vous pouvez utiliser un [tunnel MCP](https://platform.claude.com/docs/fr/agents-and-tools/mcp-tunnels/overview) avec l'une ou l'autre option. Les tunnels MCP sont en aperçu de recherche et nécessitent une demande d'accès. Consultez [Sandboxes auto-hébergés et tunnels MCP](https://platform.claude.com/docs/fr/managed-agents/self-hosted-sandboxes#self-hosted-sandboxes-and-mcp-tunnels). * **S'exécuter sous les propres contrôles de conformité et d'audit de votre organisation :** Les outils s'exécutent sur des hôtes que vous configurez, journalisez et auditez. ## Ce qu'un sandbox auto-hébergé ne change pas Avec l'une ou l'autre option, l'historique de conversation et les résultats des outils sont envoyés au service Managed Agents, exploité par Anthropic. C'est ainsi que le modèle reçoit le résultat de chaque appel d'outil. Les outils de recherche web et de récupération web s'exécutent également du côté d'Anthropic, et non dans le sandbox. Consultez [Restreindre les domaines de recherche web et de récupération web](https://platform.claude.com/docs/fr/managed-agents/tools-web-restrictions). Aucune des deux options ne modifie la couverture de conformité de Managed Agents ni la durée de conservation de l'historique de conversation. Consultez [API et conservation des données](https://platform.claude.com/docs/fr/manage-claude/api-and-data-retention#feature-eligibility). ## Ce que vous prenez en charge et ce à quoi vous renoncez avec un sandbox auto-hébergé Un sandbox auto-hébergé fait de vous l'opérateur des hôtes des workers. Vous durcissez l'image du sandbox, contrôlez le trafic réseau sortant, stockez et renouvelez la clé d'environnement, et isolez les sessions les unes des autres. La page [Modèle de sécurité](https://platform.claude.com/docs/fr/managed-agents/self-hosted-sandboxes-security) fournit les détails. Vous renoncez également à ces fonctionnalités de l'environnement cloud : * Les [ressources de session `file` et `github_repository`](https://platform.claude.com/docs/fr/managed-agents/self-hosted-sandboxes#session-resources). Vous [préparez vous-même les fichiers d'entrée](https://platform.claude.com/docs/fr/managed-agents/self-hosted-sandboxes-workers#stage-files-for-a-session), et vous êtes également responsable du montage de votre propre dépôt GitHub. * La [découverte de skills dans un dépôt](https://platform.claude.com/docs/fr/managed-agents/skills#load-skills-from-a-github-repository). * Les [identifiants sous forme de variables d'environnement](https://platform.claude.com/docs/fr/managed-agents/vaults#add-a-credential) dans les coffres. * Les [environnements d'exécution et paquets préinstallés](https://platform.claude.com/docs/fr/managed-agents/cloud-sandboxes-reference) d'un sandbox cloud. Un sandbox auto-hébergé dispose de ce que votre worker fournit. ## Différences sur Claude Platform on AWS Si vous utilisez Claude Managed Agents via Claude Platform on AWS, Anthropic exploite toujours le service. Dans ce cas, un sandbox auto-hébergé ne peut pas utiliser de magasins de mémoire, les workers n'utilisent pas de clé d'environnement et les tunnels MCP ne sont pas disponibles. Consultez [Claude Managed Agents sur Claude Platform on AWS](https://platform.claude.com/docs/fr/build-with-claude/claude-platform-on-aws#claude-managed-agents) et [Fonctionnalités non prises en charge](https://platform.claude.com/docs/fr/build-with-claude/claude-platform-on-aws#features-not-supported). ## Passer d'un environnement cloud à un sandbox auto-hébergé Pour passer à un sandbox auto-hébergé, vous conservez l'agent, créez un environnement `self_hosted` et référencez son ID dans les nouvelles sessions et les nouveaux déploiements. * **Ce qui est conservé :** La définition de l'agent, la clé API ou les identifiants AWS utilisés par votre application, vos skills, vos serveurs MCP et vos [magasins de mémoire](https://platform.claude.com/docs/fr/managed-agents/self-hosted-sandboxes-memory). * **Ce qui est nouveau :** Un environnement `self_hosted`, une clé d'environnement que vous générez dans la Claude Console, et un worker que vous exécutez. Le [guide de démarrage rapide des sandboxes auto-hébergés](https://platform.claude.com/docs/fr/managed-agents/self-hosted-sandboxes#quickstart) couvre ces trois éléments. * **Ce qui cesse de fonctionner :** Les fonctionnalités répertoriées dans [Ce que vous prenez en charge et ce à quoi vous renoncez avec un sandbox auto-hébergé](https://platform.claude.com/docs/fr/managed-agents/choosing-an-environment#what-you-take-on-and-give-up-with-a-self-hosted-sandbox). Sur Claude Platform on AWS, les magasins de mémoire ne sont pas conservés lors du passage à un sandbox auto-hébergé, et le worker n'utilise pas de clé d'environnement. Consultez [Différences sur Claude Platform on AWS](https://platform.claude.com/docs/fr/managed-agents/choosing-an-environment#differences-on-claude-platform-on-aws).