Nettoyage

Ces exemples utilisent un jeton d’accès à l’API CoreWeave défini dans CWSANDBOX_API_KEY. Pour l’authentification par clé API Forge, consultez Premiers pas. Pour les exigences relatives à CKS, consultez Modes de placement. Cette page explique comment arrêter les bacs à sable de manière fiable afin de libérer les ressources lorsque votre code se termine ou s’interrompt de façon inattendue. Appliquez ces approches pour éviter que des bacs à sable orphelins continuent de s’exécuter une fois votre script terminé. Utilisez un gestionnaire de contexte pour gérer le nettoyage automatiquement :

with Sandbox.run() as sandbox:
    sandbox.exec(["echo", "hello"]).result()
# Arrêtée automatiquement

Pour les bacs à sable créés sans gestionnaire de contexte, appelez explicitement .stop() :

sandbox = Sandbox.run()
sandbox.exec(["echo", "hello"]).result()
sandbox.stop().result()

Par mesure de sécurité, le SDK enregistre des handlers de nettoyage globaux pour atexit et pour les signaux (Ctrl+C, SIGTERM). Ces handlers arrêtent les sandboxes rattachées à une Session, de sorte que les sandboxes gérées par une session s’arrêtent même en cas de sortie inattendue. Une sandbox créée directement avec Sandbox.run() n’appartient à aucune session : elle continue donc de s’exécuter après la fin du processus, jusqu’à ce que vous l’arrêtiez ou que sa durée de vie expire. Consultez Configurer Claude Code avec le SDK Sandboxes pour un exemple de flux de travail qui repose sur ce comportement. Pour le nettoyage par lots, les stratégies d’étiquetage et la récupération des sandboxes orphelines, consultez le guide des modèles de nettoyage.

Sandbox

Utiliser les Sandbox

Gérer les bacs à sable

Référence