The handbook/Auto Mode: Beginner Guide to Claude Code
SettingsMy workspaceOfficial docs ↗

Learn one feature at a time

Auto means
fewer interruptions.

Learn what Auto mode does, why it may be selected already, and how to use it with clear boundaries.

STEP-BY-STEP HANDBOOKChecked September 24, 2026

What Auto does

Auto uses a classifier to review actions in the background. It can allow Claude to edit and run commands without a separate approval each time. It is different from bypassing permission checks, and it is not a promise that every action is safe.

Anthropic began making Auto the default for Pro, Max, and Team sessions in August 2026. A pinned default or other session conditions can keep a different mode. Always read the active indicator.

Try a small task first

Our recommendation: use a practice branch with no production secrets. Name the exact outcome, excluded areas, and checks. Review the result before increasing the scope.

Example prompt • Select Auto in Claude Code yourself
On this practice branch, correct the spelling in README.md only. Do not change code, install packages, commit, push, or publish. Show the diff and confirm whether any other files changed.

Auto can push without asking

Auto can approve a push to the current repository, including its default branch, without a prompt. Deploy-named branches, sensitive content, permission rules, and remote branch protections can change that decision. A “do not push” instruction is read from the transcript and can disappear during compaction.

To ask before common push commands, merge this rule into your existing settings rather than replacing the whole file:

Settings JSON example • Review and merge into existing permissions
{"permissions":{"ask":["Bash(git push *)"]}}

Use deny instead of ask to block matching invocations. This matches command text, not every way to push: git -C . push, other tools, or wrappers may take a different path. Protect important branches at the repository host and limit credentials for a firm boundary.

After 3 blocks in a row or 20 total classifier blocks, Auto pauses and prompts again. Approving that prompted action resumes Auto; review it before accepting.

Make the boundary concrete

  • Limit connected access: grant only what this task needs.
  • Keep a recovery point: know which changes can be restored.
  • Read the result: inspect changed files and actual test evidence.
  • Switch when needed: use Plan when you want discussion before implementation.

The selector is beside the prompt in web and Desktop. In the CLI, check the status bar after changing modes with Shift+Tab. Availability varies. Compare all six modes.

References

Was this chapter useful?

Report an error

Votes are shared only if you enable optional measurement in Privacy & Preferences.

CONTINUE THE GUIDEPlan Mode

Edit this example

Changes here affect this copy only. Nothing runs from this site. Closing this window discards your edits.

Search the field guide

Search all chapters and FAQ answers. Use Tab to reach a result and Enter to open it.