### Documentation Type Missing documentation (feature not documented) ### Documentation Location .claude/settings.json ### Section/Topic settings.json ### Current Documentation _No response_ ### What's Wrong or Missing? 1. Schema out of sync: JSON schema at schemastore.org doesn't match current Claude Code implementation 2. Tool name mismatch: Schema expects "Agent" but configs use "Task" 3. Missing tools: "ExitPlanMode" not recognized in schema pattern 4. Property cha

[DOCS] settings.json schema out of sync

Status Fixed / completed

Maintainer reply ✓ Yes — bogini

Activity 3 comments · opened Sep 11, 2025 · closed Sep 29, 2025

💡 Likely answer: A maintainer (bogini, collaborator) responded on this thread — see the highlighted reply below.

Documentation Type

Missing documentation (feature not documented)

Documentation Location

.claude/settings.json

Section/Topic

settings.json

Current Documentation

_No response_

What's Wrong or Missing?

Schema out of sync: JSON schema at

schemastore.org doesn't match current Claude Code
implementation

Tool name mismatch: Schema expects "Agent" but

configs use "Task"

Missing tools: "ExitPlanMode" not recognized

in schema pattern

Property changes: "ask" property was replaced

with "deny" but schema wasn't updated

The configuration change should prevent Claude
from exiting plan mode without your explicit
permission.

Suggested Improvement

Make sure that CC updates settings.json to follow latest schema when updating CC version.

Impact

Low - Minor confusion or inconvenience

Additional Context

_No response_

View original on GitHub ↗

3 Comments

hesreallyhim · 1 year ago

in case my issue gets closed as a duplicate - the schema lists "ToolError" hook and it doesn't exist

bogini collaborator · 1 year ago

Thanks for flagging. https://github.com/SchemaStore/schemastore/blob/master/src/schemas/json/claude-code-settings.json has been updated.

"ask" property was replaced with "deny" but schema wasn't updated

This is not correct, ask is a supported property. See https://docs.claude.com/en/docs/claude-code/iam#configuring-permissions

github-actions[bot] · 1 year ago

This issue has been automatically locked since it was closed and has not had any activity for 7 days. If you're experiencing a similar issue, please file a new issue and reference this one if it's relevant.