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.81 (August 27, 2026)
Antigravity CLI v1.1.22 (August 27, 2026)
OpenAI Codex CLI rust-v0.150.1 (August 27, 2026)
Kiro CLI v2.20.0 (August 26, 2026)
OpenAI Codex CLI rust-v0.150.0 (August 26, 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

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.251 (August 28, 2026)
v2.1.246 (August 25, 2026)
v2.1.245 (August 25, 2026)
v2.1.243 (August 24, 2026)
v2.1.241 (August 22, 2026)

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