Claude Code v2.1.312

Claude Code v2.1.312 adds an oidc.user_id_claim setting for the Claude apps gateway and click-to-send for queued messages, stops Claude from overwriting very large CLAUDE.md or rules files after reading only their start, and caps prompt and agent hooks at 24 running at once per session.

Visit Claude Code ↗Repository ↗Release notes ↗

PaidProprietary (© Anthropic PBC; use subject to Anthropic's Commercial Terms)TypeScript (repo)★ 153,678 (as of 2026-10-28)by Anthropic

Why it matters

For developers and teams using Anthropic's Claude Code agent: this release mostly fixes reliability issues around large instruction files, skills discovery and headless claude -p runs, and adds an identity option for companies on Microsoft Entra ID.

What's new

New oidc.user_id_claim for the Claude apps gateway, so people can be identified by a claim other than sub, such as Entra ID's oid.
Fixed Claude overwriting a very large CLAUDE.md, rules or @-included file after seeing only its start; Write now asks it to read the whole file or edit in place.
Fixed per-directory and paths: skills not being found after a Bash cd deeper into a repo, and a bad command name stopping all commands from loading (which could leave claude -p with no output).
Prompt and agent hooks now run at most 24 at a time per session, sub-agents included; a timeout under 1 second counts as 1 second.
Bedrock, Vertex, Foundry and Mantle now send the shorter built-in instructions for model names Claude Code doesn't recognize; set CLAUDE_CODE_SIMPLE_SYSTEM_PROMPT=0 to keep the full version.

Taken from the project's own release notes. Claims about speed or accuracy are the maker's unless stated otherwise.

Try it if: You keep big CLAUDE.md or rules files, run Claude Code headless with claude -p, or deploy it on Bedrock or Vertex under a custom model name.

Worth knowing: If you run a custom Bedrock, Vertex, Foundry or Mantle deployment name and want Claude Code's full built-in instructions, set CLAUDE_CODE_SIMPLE_SYSTEM_PROMPT=0 after updating.

Quick facts

Pricing	Requires a Claude account or Anthropic API access (plan details not checked)not verified
Free or paid	Paid
License	Proprietary (© Anthropic PBC; use subject to Anthropic's Commercial Terms)
Language	TypeScript (repo)
Platform	macOS, Linux, Windows; terminal, IDE, desktop
GitHub stars	★ 153,678 (as of 2026-10-28)
Maker	Anthropic

Related ranking

See how established tools compare in Best AI Coding Tools for Developers. New releases aren't scored until we review them against the rubric.

What we couldn't verify

quick_facts.pricing

Checked 2026-10-28 from the release notes's own pages. Prices and star counts change, so confirm on the official site. Listing here is not a ranking or an endorsement.