Claude Code Mode: What It Is, How to Turn It On & Limits
Claude Code Mode lets Claude write JavaScript that runs many tool calls at once. How to enable it (v2.1.323+), supported models, limits and how to turn it off.
Quick answers
- What is Claude Code Mode?
- An experimental Claude Code setting, added in v2.1.323 (November 12, 2026). Claude writes one piece of JavaScript that makes many tool calls, instead of asking for Bash, Read and Edit one at a time.
- How do I turn on Claude Code Mode?
- Update to v2.1.323 or later, then start Claude with CLAUDE_CODE_EXPERIMENTAL_CODE_MODE=1, or put that variable in the env block of ~/.claude/settings.json. Confirm the prompt the first time.
- Which models work with Claude Code Mode?
- Claude Opus 5.5, Sonnet 5.5, Haiku 5.5 and Fable 5.2, on a Claude subscription or Console account.
- Is Claude Code Mode the same as auto mode?
- No. Auto mode decides which tool calls need your approval. Code Mode changes how the calls are made. You can use both together.

Claude Code Mode is a new, experimental way for Claude Code to use its tools. Normally Claude asks for one tool call, reads the result, then decides the next one. With Claude Code Mode on, Claude writes a short JavaScript program that makes the calls for it: it can run commands in parallel, pass one result into the next call and send back only the part it needs to read. Anthropic shipped it in Claude Code v2.1.323 on November 12, 2026, and it is off by default.
Below: how to turn on Claude Code Mode, what it is good at, the limits, and how to turn it off.
How to turn on Claude Code Mode
- Check your version: run
claude --version. If it is older than v2.1.323, runclaude update. - Start with the flag:
CLAUDE_CODE_EXPERIMENTAL_CODE_MODE=1 claude. To keep Claude Code Mode on for every session, add it to theenvblock in~/.claude/settings.json. - Confirm: the first time, pick Yes, turn on Code Mode. Claude Code restarts and shows "Code Mode (experimental) is on" at the top.
- See the code: press
Ctrl+Oand open a Code row to read the JavaScript Claude wrote.
Using Claude Code Mode alone? Run it where your team can watch
Claude Code Mode makes Claude do more per step, which also means more happens before you look. In Sumus you can bring your own Claude Code into a team chat as an AI Employee: teammates see what it is changing, ask it questions and pick up the result, instead of reading your terminal over your shoulder.
A project's own settings file cannot switch on Claude Code Mode for you, so a repo you clone cannot turn it on behind your back.
What Claude Code Mode is good at
The docs say to try Claude Code Mode on tasks with many related tool calls:
- The same change across many files.
- A search whose results need filtering before Claude reads them.
- Several commands that can run at the same time, such as tests and linters.
In one public test, developer Daniel Avila asked Fable 5.2 to find every broken local link in a project's Markdown files. With Claude Code Mode on it made 13 tool calls in just 2 model turns and found all 3 broken links. Without it, that is 13 round trips, each one costing a turn of context and a wait. His post on X about Claude Code Mode spread widely on November 15.
Claude Code Mode requirements
Item | Requirement |
|---|---|
Version | Claude Code v2.1.323 or later, native build |
Account | Claude subscription or Console account |
Not supported | Gateways, Amazon Bedrock, Google Cloud, Microsoft Foundry, custom base URL |
Models | Opus 5.5, Sonnet 5.5, Haiku 5.5, Fable 5.2 |
Surface | Interactive terminal session only (no -p, Agent SDK, VS Code panel, Desktop app, cloud) |
Blocked by | Agent teams, API key helper, OpenTelemetry export, DISABLE_TELEMETRY, HIPAA or zero data retention |
Windows | Git for Windows installed |
Claude Code Mode limits to know first
- Ten-minute cap: code you wait on stops after ten minutes. In auto or bypassPermissions mode it can run in the background for up to two hours.
- Resume: a Claude Code Mode session can only be resumed in the terminal with the flag still on.
- Lost features: no Remote Control, Claude in Chrome or computer use, and you cannot move the session to the Desktop app.
- Hooks: a PreToolUse hook that fails or times out refuses the call. To check the code itself, match the
REPLtool and readtool_input.code.
Claude Code Mode and permissions
Every tool call the code makes still goes through your deny and ask rules and your hooks. The big change is in auto mode: its classifier reviews each piece of code before it runs, not each tool call, and it cannot see values worked out at run time, such as a path taken from search output. Anthropic's advice is to keep rules or hooks for calls you must control. In the other permission modes, you are asked about each call as before.
Claude Code Mode also calls your MCP servers from code. If you lean on many servers, see our Claude Code MCP guide.
How to turn off Claude Code Mode
Remove CLAUDE_CODE_EXPERIMENTAL_CODE_MODE from your shell and from ~/.claude/settings.json, or set it to 0, then start a new session. A 0 in either place wins. Admins can block Claude Code Mode for a whole company by setting the variable to 0 in managed settings.
Is Claude Code Mode worth turning on?
Yes for big, repetitive jobs where most of the time goes to round trips: fewer turns, a cleaner context window and less waiting. Leave it off if you work in VS Code or the Desktop app, use Bedrock or a gateway, run agent teams, or need tight per-call review in auto mode. It is experimental and may change or be removed in any release, so treat Claude Code Mode as a tool to test, not a default.
FAQ
Is Claude Code Mode free?
There is no extra fee. It uses your normal Claude subscription or Console usage.
Does Claude Code Mode work in VS Code?
No. It works only in an interactive claude session in a terminal.
Why does Claude Code Mode not start?
Read the reason at the top of the session or in /status. Common causes: old version, a gateway or Bedrock, an API key helper, agent teams, or telemetry turned off.
Can I use Claude Code Mode with Sonnet?
Yes, Sonnet 5.5 is supported, as are Opus 5.5, Haiku 5.5 and Fable 5.2.
Update log
- — Nov 17: First version: what Claude Code Mode is, how to turn it on and off, requirements, limits, permissions and a real test.
Claude, in your team chat
Use Claude Fable and Opus 5.5 with your whole team as AI Employees in Sumus.
Try Claude in Sumus