[DOCS] Auto mode availability and configuration scope are outdated for third-party providers

Open 💬 0 comments Opened Jul 11, 2026 by coygeek

Documentation Type

Incorrect/outdated documentation

Documentation Location

https://code.claude.com/docs/en/auto-mode-config

Section/Topic

The auto mode availability note and the “Where the classifier reads configuration” section. The same provider-availability guidance is also repeated on the Permission modes, Feature availability, Environment variables, and Desktop pages.

Current Documentation

The auto mode configuration page currently says:

“On Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry, and signed-in Claude apps gateway sessions, you must first set CLAUDE_CODE_ENABLE_AUTO_MODE.”

It also lists this scope for the classifier:

“One project, one developer | .claude/settings.local.json | Per-project trusted buckets or services”

The Permission modes page repeats both behaviors:

“On Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry, and signed-in Claude apps gateway sessions, auto mode is off until you set CLAUDE_CODE_ENABLE_AUTO_MODE.”

and:

“On these providers, Claude Code ignores defaultMode: \"auto\" unless CLAUDE_CODE_ENABLE_AUTO_MODE is also set.”

What's Wrong or Missing?

Claude Code v2.1.207 changed auto mode on Amazon Bedrock, Google Cloud's Agent Platform, and Microsoft Foundry so it is available without the CLAUDE_CODE_ENABLE_AUTO_MODE opt-in. The current instructions therefore tell users to perform an unnecessary setup step and incorrectly describe the providers as only partially supported.

The same release changed auto mode configuration so autoMode is no longer read from the repository-resident .claude/settings.local.json; users should use ~/.claude/settings.json instead. The scope table and related explanations still direct users to the old project-local location, which can lead them to configure trusted infrastructure in a file Claude Code no longer consults for this feature.

The documentation also needs to distinguish the new default availability from the administrator control that disables auto mode with disableAutoMode in settings. Without that distinction, readers cannot tell whether the old environment variable is required, optional for compatibility, or still relevant only to other provider classes.

Suggested Improvement

Update the provider requirements and examples to state that auto mode is available by default on Amazon Bedrock, Google Cloud's Agent Platform, and Microsoft Foundry as of Claude Code v2.1.207. Explain the current role, if any, of CLAUDE_CODE_ENABLE_AUTO_MODE, and remove language saying those providers require it before auto mode can appear.

Update the configuration-scope table and every related example so autoMode is shown in the supported user/managed or inline settings locations, not .claude/settings.local.json. Add a short migration note for users upgrading from versions that read the project-local file.

Document disableAutoMode as the explicit setting for administrators or users who need to prevent auto mode, including its accepted scope and precedence. Keep the provider-specific exception for signed-in Claude apps gateway sessions if it still applies, rather than applying the third-party-provider wording to every provider.

Impact

Medium - Makes feature difficult to understand

Additional Context

Affected Pages:

| Page | Context |
|------|---------|
| https://code.claude.com/docs/en/auto-mode-config | Provider opt-in note and autoMode settings-scope table |
| https://code.claude.com/docs/en/permission-modes | Provider requirements and enablement instructions |
| https://code.claude.com/docs/en/feature-availability | Provider footnote and Bedrock, Vertex, and Foundry summaries still say to set the opt-in variable |
| https://code.claude.com/docs/en/env-vars | CLAUDE_CODE_ENABLE_AUTO_MODE is described as required to make auto mode available on all three providers |
| https://code.claude.com/docs/en/desktop | Third-party-provider auto-mode availability text still describes an opt-in requirement for Google Cloud's Agent Platform |

Total scope: 5 pages affected

Source: Claude Code v2.1.207

Auto mode is now available without CLAUDE_CODE_ENABLE_AUTO_MODE opt-in on Bedrock, Vertex AI, and Foundry; disable via disableAutoMode in settings Changed auto mode to no longer read autoMode from .claude/settings.local.json (repo-resident); use ~/.claude/settings.json instead

View original on GitHub ↗