{"version":"2.1.281","anchor":"sandbox-survives-an-invalid-settings-change-instead-of-faili","canonical_anchor":"sandbox-survives-an-invalid-settings-change-instead-of-faili","heading":"Bad sandbox settings no longer break the sandbox until restart","tier":null,"area":null,"url":"https:\/\/changelogs.core-directive.com\/v\/2.1.281\/e\/sandbox-survives-an-invalid-settings-change-instead-of-faili","release_url":"https:\/\/changelogs.core-directive.com\/v\/2.1.281","markdown":"### Bad sandbox settings no longer break the sandbox until restart\n\nBroken sandbox settings now wait to be fixed and retried, and a later bad edit keeps the running sandbox instead of failing\n\n**What**\n\nThe sandbox is the protected environment Claude Code can run commands in. Claude Code builds its sandbox setup from your settings. It now handles settings that cannot be turned into a working setup more gracefully:\n\n- At startup, if the sandbox settings cannot be built, Claude Code records a `configBuildFailed` state and waits for your next settings change to try again. It no longer counts the failure as a general sandbox startup failure.\n\n- The `configBuildFailed` state is cleared again when your settings change.\n\n- If the sandbox is required and its setup failed to build, the error now reads \"Fix the sandbox settings to retry (a --settings file is pinned for the process: restart).\" It used to say only \"Restart to retry.\"\n\n- If the sandbox is already running and a later edit to your settings is invalid, Claude Code keeps the setup it is running and logs \"Sandbox config rebuild skipped, keeping the running config\". Before, settings updates rebuilt the setup with no guard against errors.\n\nThe exception is settings passed with the `--settings` flag, a command-line option that points Claude Code at a settings file or inline settings for one session. Those are fixed for the life of the process, so to change them you still restart.\n\n**Why**\n\nA typo in your sandbox settings is less disruptive. You can usually fix it in place without restarting, and a mistake made while the sandbox is running leaves the working sandbox as it was."}