[Docs] Settings reference omits `switchModelsOnFlag`; `skipWorkflowUsageWarning` is app-written but unexplained

Open 💬 0 comments Opened Jul 8, 2026 by urda

Both keys ship in the settings schema (verified in the v2.1.205 binary) and get written into user settings.json, but neither appears in the settings reference.

switchModelsOnFlag (default true) is a user-facing /config toggle under "Model & output", not marked internal. Schema description:

When safety measures flag a message, automatically switch to a different model to keep chatting. When off, your session will pause instead.

It has a real routing/safety consequence and an env counterpart (CLAUDE_CODE_DISABLE_REFUSAL_FALLBACK). Please add it to the settings reference. Related behavior/feature threads: #67469, #74311.

skipWorkflowUsageWarning is marked @internal in the schema and auto-written when the workflow usage warning is accepted (see #65608). If it is intentionally internal, understood, but since it lands in user config a one-line "managed automatically, do not hand-edit" note in the reference would prevent confusion for anyone auditing their settings.json.

Version: 2.1.205.

View original on GitHub ↗