CLAUDE_CODE_DISABLE_REFUSAL_FALLBACK
Updated by Alex Sorokoletov
CLAUDE_CODE_DISABLE_REFUSAL_FALLBACK is a Claude Code environment variable: After a flagged message, Claude Code switches models automatically, now including model names it doesn't recognize such as custom deployment names. Set it to 1 to turn the switches off. Removed in v2.1.318, so current releases ignore it. It is listed in the official reference.
| Status | Removed in v2.1.318 |
|---|---|
| Added | Added between v2.1.143 and v2.1.212 |
| Category | Feature toggles |
| Official docs | Listed |
How to set it
For one session, export it in the shell that starts Claude Code:
export CLAUDE_CODE_DISABLE_REFUSAL_FALLBACK=<value>
claudeTo apply it to every session, add it to the env object of a settings file:
// ~/.claude/settings.json
{
"env": {
"CLAUDE_CODE_DISABLE_REFUSAL_FALLBACK": "<value>"
}
}Release notes that mention it
- Claude Code Version Tracker: Undocumented Env Vars, Feature Gates & Models
- claude-code-env-vars-v2-1-312
Related variables
CLAUDE_CODE_DISABLE_ADMIN_ENV_UNION: When set to true, uses only the leading admin tier's environment settings instead of merging (unioning) the environment across all admin tiers.CLAUDE_CODE_DISABLE_ARTIFACTCLAUDE_CODE_DISABLE_ATTACHMENTS: File/image attachments.CLAUDE_CODE_DISABLE_AWAITING_USER_IDLE: When set, stops the session from being treated as idle while it waits for user input, so time parked on the user is not counted as idle.CLAUDE_CODE_DISABLE_CFC_PROMPTCLAUDE_CODE_DISABLE_COMMAND_INJECTION_CHECK: Previously allowed disabling command injection detection.CLAUDE_CODE_DISABLE_CRON: Disable cron/scheduled task functionality.CLAUDE_CODE_DISABLE_DIR_SYNC: Turns off the background directory-sync worker on a remote session.
Frequently asked questions
What does CLAUDE_CODE_DISABLE_REFUSAL_FALLBACK do?
After a flagged message, Claude Code switches models automatically, now including model names it doesn't recognize such as custom deployment names. Set it to 1 to turn the switches off.
Which Claude Code version has CLAUDE_CODE_DISABLE_REFUSAL_FALLBACK?
Removed in v2.1.318, so current releases ignore it.
How do I set CLAUDE_CODE_DISABLE_REFUSAL_FALLBACK?
Export it before starting Claude Code (export CLAUDE_CODE_DISABLE_REFUSAL_FALLBACK=value), or add it to the "env" object in ~/.claude/settings.json to apply it to every session.
All variables, searchable: Claude Code environment variables.