Issue Station
Sign In
Tools hereToolbox

claude-code - 💡(How to fix) Fix [BUG] Claude settings JSON schema does not contain `sandbox.failIfUnavailable` [1 participants]

Official PRs (…)
ON THIS PAGE

Recommended Tools

×6

Utilities matched from this issue’s tags and category — try them while you read without losing context.

GitHub issue graph ai analysis

Paste a GitHub issue URL. We fetch that issue, discover linked issues from bodies/comments/timeline, collect linked pull requests, and produce a structured English report.

The report is written in English Markdown for sharing and archival.

Helpful · Quick feedback

Loading…
GitHub stats
anthropics/claude-code#56321•Fetched 2026-05-06 06:31:14
View on GitHub
Comments
0
Participants
1
Timeline
4
Reactions
0
Author
mfoomfoo
Participants
mfoomfoo
Timeline (top)
labeled ×4

Error Message

Error Messages/Logs

Root Cause

We are maintaining an organisation-wide managed settings file in a git repo, and our CI check validates the file against the settings schema to make sure we don't cause issues (invalid file, or worse, intended change has no effect) when people raise MRs into the settings file. We currently cannot add this setting because it is absent in the schema.

Code Example

N/A
RAW_BUFFERClick to expand / collapse

Preflight Checklist

  • I have searched existing issues and this hasn't been reported yet
  • This is a single bug report (please file separate reports for different bugs)
  • I am using the latest version of Claude Code

What's Wrong?

The sandboxing documentation contains:

To make this a hard failure instead, set sandbox.failIfUnavailable to true.

But the settings schema does not currently document this field.

We are maintaining an organisation-wide managed settings file in a git repo, and our CI check validates the file against the settings schema to make sure we don't cause issues (invalid file, or worse, intended change has no effect) when people raise MRs into the settings file. We currently cannot add this setting because it is absent in the schema.

What Should Happen?

Update the schema.

Error Messages/Logs

N/A

Steps to Reproduce

N/A

Claude Model

None

Is this a regression?

I don't know

Last Working Version

No response

Claude Code Version

2.1.128

Platform

Anthropic API

Operating System

macOS

Terminal/Shell

Terminal.app (macOS)

Additional Information

No response

extent analysis

TL;DR

Update the settings schema to include the sandbox.failIfUnavailable field to allow validation of the organisation-wide managed settings file.

Guidance

  • Review the settings schema and identify the section where the sandbox settings are defined.
  • Add the failIfUnavailable field to the sandbox settings section in the schema, with the correct data type (likely a boolean).
  • Validate the updated schema to ensure it is correctly formatted and can be used for validation.
  • Update the CI check to use the updated schema for validating the organisation-wide managed settings file.

Example

No code snippet is provided as the issue is related to updating a schema, not code.

Notes

The issue is specific to the Claude Code version 2.1.128 and the Anthropic API platform, so the solution may not apply to other versions or platforms.

Recommendation

Apply workaround: Update the settings schema to include the missing field, as this will allow the organisation-wide managed settings file to be validated correctly.

Vote matrix · Quick signals

Works
Did the solution work? Tap to confirm.
Easy Fix
Was it a quick fix?
Time Saver
Did it save you time?
Blocking
Was it severely blocking?
Common Issue
Are others likely hitting this too?
Flaky / Intermittent
Is it intermittent?
Verified / Reproducible
Can you reproduce it reliably?
Loading…
#api#chain error#conversation history#tool integration#LLM response

Still need to ship something?

×6

Another batch ranked right after the header list — different links, same matching logic.

Back to top recommendations

TRENDING