The handbook/Accept Edits: Beginner Guide to Claude Code
SettingsMy workspaceOfficial docs ↗

Learn one feature at a time

Let Claude edit.
Keep reviewing.

Understand which approvals Accept Edits reduces and why the label differs between local and cloud sessions.

STEP-BY-STEP HANDBOOKChecked September 24, 2026

What the label means

Accept Edits reduces prompts for file changes. Locally, acceptEdits also auto-approves mkdir, touch, rm, rmdir, mv, cp, and sed within its permitted scope, including deletions; other actions remain subject to permission rules. In cloud sessions, the label maps differently because file edits are already pre-approved. It does not mean every possible command is approved.

Use it for a change you understand

Select Accept Edits in the interface. In a local terminal:

Terminal • Run from a practice project
claude --permission-mode acceptEdits
Claude Code conversation
Implement the README change we just agreed on. Keep the edit to that file. Show the diff and explain the result. Ask separately before committing or publishing anything.

Review the edit itself

  1. Open the diff, which shows added and removed lines.
  2. Check for unexpected files or unrelated changes.
  3. Read any command approval request before accepting it.
  4. Run the relevant checks for the approved change.

A mode change is not a quality check. If a change is unclear, ask Claude to explain it or return to Plan. For local review of individual actions, Manual mode is another option. Choose it when the extra interruptions help you understand the work.

Do not confuse these controls

“Accept Edits” is a permission mode. Accepting a proposed plan, applying a diff, and merging a GitHub pull request are separate decisions. Check the control’s label and the scope of the action each time.

References

Was this chapter useful?

Report an error

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

CONTINUE THE GUIDEModels & Effort

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.