Claude Code v2.1.248
Claude Code v2.1.248 was released on .
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).
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)
- Factory Droid v0.208.0 (August 29, 2026)
- Factory Droid v0.208.1 (August 29, 2026)
- OpenCode v1.18.25 (August 28, 2026)
Compare Claude Code
- Claude Code vs OpenAI Codex CLI
- Claude Code vs Cursor
- Claude Code vs Gemini CLI
- Claude Code vs Kiro CLI
- Claude Code vs GitHub Copilot CLI
- Claude Code vs Devin Desktop
- Claude Code vs Antigravity CLI
- Claude Code vs Grok Build
- Claude Code vs Cline
- Claude Code vs OpenCode
- Claude Code vs Zed
- Claude Code vs Factory Droid
- Claude Code vs Devin
- Claude Code vs Lovable
- Claude Code vs Amp
- Claude Code vs GitHub Copilot in VS Code
- Claude Code vs Replit Agent
- Claude Code vs Bolt
- Claude Code vs v0
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
Other Recent Claude Code Releases
- v2.1.305 (October 20, 2026)
- v2.1.304 (October 19, 2026)
- v2.1.303 (October 18, 2026)
- v2.1.302 (October 16, 2026)
- v2.1.301 (October 15, 2026)
Upgrading from v2.1.248? See all 47 releases since.
All Claude Code releases ยท All AI coding tool releases on Havoptic