Claude Code v2.1.248

Claude Code v2.1.248 was released on August 27, 2026.

Summary

Claude Code 2.1.248 now lets you run code safely with a restricted mode that blocks risky operations, while a new cache setting helps agents work faster by reusing prompts. Check the full release notes to see all the improvements we've added.

Release Context

This was the 200th Claude Code release of 2026 tracked by Havoptic.
It shipped 1 day after Claude Code v2.1.247 (August 26, 2026).
Claude Code: ships every 0.8 days — 24 releases in the last month.

Why it matters: Lock down Claude with restricted mode security.

Shipped around the same time

Within 3 days of this release, other AI coding tools also shipped:

GitHub Copilot CLI v1.0.82 (August 29, 2026)
OpenAI Codex CLI rust-v0.151.0 (August 29, 2026)
Grok Build v1.0.13 (August 28, 2026)
GitHub Copilot CLI v1.0.81 (August 27, 2026)
Antigravity CLI v1.1.22 (August 27, 2026)

Compare Claude Code: vs OpenAI Codex CLI · vs Cursor · vs Gemini CLI · vs Kiro CLI · vs GitHub Copilot CLI · vs Devin Desktop · vs Antigravity CLI · vs Grok Build

Release Notes

Added --restricted (or CLAUDECODERESTRICTED=1): removes the built-in tools that run commands or code and WebFetch (unless named in --tools), keeps file tools inside the working directory, refuses bypassPermissions, and ignores user, project and local settings files
Added experimental.cacheTtl ("5m" or "1h") to agent frontmatter: a per-agent prompt cache TTL used when no subagent TTL setting is configured
Added claude self-hosted-runner --client-label <label> (or SELFHOSTEDRUNNERCLIENTLABEL) to override the label the runner registers with (default: hostname)
Added server-managed settings diagnostics: a startup warning when the settings fail to load, and a /doctor and /status line explaining a load failure or why they weren't fetched (Bedrock/Vertex/third-party provider, custom ANTHROPICBASEURL)
Added a warning in /web-setup when the GitHub CLI token lacks the workflow scope, since pushes to very large repositories can be rejected without it
Added /usage-credits for Enterprise organi

View original release

Other Recent Claude Code Releases

v2.1.276 (September 18, 2026)
v2.1.275 (September 17, 2026)
v2.1.274 (September 16, 2026)
v2.1.273 (September 15, 2026)
v2.1.272 (September 14, 2026)

All Claude Code releases · All AI coding tool releases on Havoptic