Source · release
Claude Code release 2.1.323
Summary
Claude Code 2.1.323 (2026-11-12) adds Code Mode, an experimental opt-in in which Claude
writes JavaScript that calls its tools instead of calling them one at a time. Plugins can
now declare which Claude Code versions they support, claude plugin validate type-checks
TypeScript hook modules, and long-running hooks send a heartbeat in headless sessions. The
release also has a long list of permission and sandbox fixes.
Key points
- Code Mode (experimental, opt-in): Claude writes JavaScript to call its tools. The
release notes point to
https://code.claude.com/docs/en/code-modefor turning it on, or off for an organization; that page returned 404 on 2026-11-13, so the setting name is not yet known. The idea is the same as "code execution with MCP": chaining tool calls in code keeps intermediate results out of the context window. - Plugin version ranges:
engines["claude-code"]inplugin.jsonkeeps a plugin from being installed, updated, or loaded outside its stated range; install and update pick the newest plugin version that fits. - Plugin validation:
claude plugin validatetype-checks a plugin's TypeScript hooks module (warnings;--strictfails on them). A plugin'sagentsetting is deprecated and now warns.claude plugin install --jsonreportsunsetOptionCount. - Hooks: a progress heartbeat every 30 seconds while hooks run long in
claude -pand SDK sessions, so hosts do not treat the turn as hung. If a permission check errors after aPreToolUsehook said "allow", Claude Code now decides as if no hook answered. - Security fixes: wildcard Bash allow rules such as
Bash(ls*)could skip prompts; deny rules missed commands run throughsudoandenv; Write and Edit could write to a path covered by aReaddeny rule; the sandbox could switch off mid-session;--permission-mode autocould start in a looser mode when auto mode was unavailable (it now starts in Manual). A startup warning flags allow rules with*in a variable value, such asBash(PORT=* npm run dev). - Context: an unrecognised model ID is now assumed to have a 1M context window (was
200K); set
CLAUDE_CODE_DISABLE_1M_CONTEXT=1for smaller third-party models. - Other:
CLAUDE_CODE_DISABLE_AGENT_PROGRESS_SUMMARIES=1turns off subagent progress summaries; the VS Code extension adds a workspace trust prompt and live Bash output. - Update with
claude update.
Why it matters
Code Mode is a new way of running tools inside Claude Code itself and may cut token use on tool-heavy tasks. Plugin authors get version pinning and type checks. The permission fixes make it worth updating promptly, especially for anyone using wildcard allow rules.