Features · Built in · since version 2.1.86

Auto mode

Let a safety check approve Claude's actions for you, so it can work through a task without constant prompts.

What it is

Auto mode is a permission mode. Instead of asking you about each action, Claude Code sends it to a separate classifier model first. Reading files and editing inside your project go ahead; actions that go beyond what you asked for, touch unfamiliar systems or seem driven by untrusted content are blocked. Your own deny and ask rules still apply on top.

Why it matters

  • Longer tasks without babysittingClaude keeps going through routine steps instead of stopping for approval at each one.
  • Guardrails stay onRisky actions are blocked, and after several blocks in a row Claude Code goes back to asking you.
  • Your rules still winDeny rules block in every mode, and ask rules still force a prompt.

How it works

  1. Press Shift+Tab until the status bar shows auto mode, or start with claude --permission-mode auto.
  2. To start in it every time, set permissions.defaultMode to auto in ~/.claude/settings.json (project files can't set it).
  3. Read-only actions and edits in the working folder are approved; other actions are checked by the classifier first.
  4. Blocked actions don't run, and you can review them later under /permissions.
  5. It needs a recent model, and admins can turn it off with permissions.disableAutoMode.

Hands-on example coming

This feature has no reviewed example yet. The official documentation below has the details.

Update history

  1. Version 2.1.89 · Mar 31, 2026

    Updated Denied actions show a notification and can be retried from /permissions.

  2. Version 2.1.86 · Mar 27, 2026

    Introduced First changelog mention of auto mode; it shipped earlier without an entry.

Official documentation