Watch the Short
One painter or a crew?
The regular workflow can feel like watching one painter finish a whole hotel room by room. /batch changes the job: one worker per independent room, all moving at once.
The painter analogy
You’re not the painter anymore.
A normal AI coding session is like hiring one painter to do a whole hotel. It fixes one file, then the next one, then the next one—and you sit there watching.
With /batch, you become the person walking the halls and checking the rooms. Claude decides which rooms can be painted independently, assigns the work, and brings the completed jobs back together.
How /batch works
One request becomes a coordinated set of jobs.
Step 1
Describe the whole job
Start with /batch and explain the result you want. For example, ask it to migrate a folder from JavaScript to TypeScript.
Step 2
Review the plan
Claude studies the project, finds work that can be separated safely, and presents the jobs before the parallel work begins.
Step 3
Let the crew work
Separate AI workers take independent jobs at the same time instead of one session editing every file in sequence.
Step 4
Check the finished work
Each job can make its changes and run the relevant checks. You still review the combined result before keeping it.
Before you start: /batch requires your project to be a git repository, and it opens pull requests with the finished work — so you’ll want a GitHub remote connected too.
A real example
Move a folder from JavaScript to TypeScript.
Instead of converting every file in one long line, start with a request like this:
/batch Migrate the files in this folder from JavaScript to TypeScript. Preserve behavior, update imports and types, and run the relevant tests when each job is complete.Claude finds the safe dividing lines.
It might group independent files or features into separate jobs. If two files depend heavily on each other, they should stay together rather than being handed to workers that could collide.
Good jobs for /batch
- Migrating a large folder from JavaScript to TypeScript
- Updating many independent pages to follow the same pattern
- Fixing a group of separate test failures
- Making similar changes across files that do not depend on one another
Use a normal request instead
- A one-file change
- A bug that needs careful investigation before anyone knows the cause
- Work where every step depends on the step before it
- A small edit that would take longer to divide than to finish
FAQ
Claude Code /batch questions
Behind the video
The gear I use to make these.
Everything here is sitting in my office right now. If you buy through an Amazon link, I earn a small commission — it helps the channel, and costs you nothing extra.
Sony Alpha a5000
Compact mirrorless camera for talking-head videos.
View on Amazon →Elgato Facecam
Dedicated webcam when I don't want to rig the mirrorless.
View on Amazon →Elgato Key Light
Bright, dimmable, computer-controlled key light.
View on Amazon →Elgato Stream Deck +
One-press control for lights, scenes, and apps.
View on Amazon →Elgato Wave:3 Mic
Clean mic for voiceovers and screen recordings.
View on Amazon →DJI Mic Mini
Wireless lav mic for away-from-desk shots.
View on Amazon →Elgato Prompter
Built-in screen so I can read while looking at the lens.
View on Amazon →Meross Smart Plug
Reliable HomeKit smart plugs for fans and lamps.
View on Amazon →Govee Smart Bulbs
Color Wi-Fi bulbs with app and voice control.
View on Amazon →EMART Umbrella Lights
Budget-friendly fill lights for even coverage.
View on Amazon →Amazon Associates disclosure: I earn from qualifying purchases. I only list gear I own and use.
More from Chad