[Docs] Settings reference omits `switchModelsOnFlag`; `skipWorkflowUsageWarning` is app-written but unexplained
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.
3 Comments
switchModelsOnFlagis now in the settings reference, including its default, the/configlabel, and a link to the model fallback behavior: https://code.claude.com/docs/en/settings.skipWorkflowUsageWarningis intentionally internal and managed automatically when you accept the workflow usage warning; it's safe to leave as-is in your settings file. Closing this one; thanks for flagging it.🤖 Generated with Claude Code
I appreciate this setting existing. I don't like the automatic switch (at all) — models can't be swapped like commodities.
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.