MultiEdit - Claude Code

MultiEdit applies a set of edits to one or many files in a single tool call. It's the fastest way to make coordinated changes.

What it does

You pass MultiEdit a list of file + old_string + new_string triples. It applies them in order, either all succeeding or the whole batch rolling back. This is ideal for refactors that touch several files at once - renaming an export, updating an API signature, shifting a config key across consumers.

When to use it

• Refactors that span multiple files and must stay consistent.
• Coordinated edits where a partial failure would leave the repo broken.
• Repetitive changes you'd otherwise do with ten sequential Edit calls.
• Reducing turn count in long sessions.

Gotchas

• A single failed edit rolls back the whole batch. Order matters.
• Each edit still has the unique-old-string requirement. A typo in one triple blocks everything.
• Large batches are harder to review. Keep them focused on one logical change.

Official docs: https://code.claude.com/docs/en/tools-reference.md