Claude Code v2.1.252 Changelog
What changed in Claude Code CLI v2.1.252, released 2026-08-31 — explained in plain English.
TLDR
- Squashed several annoying bugs that could interrupt your workflow.
- Fixed an issue where Claude wouldn't remember your "always allow" preferences for new projects.
- Stopped massive error messages from breaking the chat.
- This release is all about making Claude Code more stable and less frustrating to use. It matters most to developers using Macs or connecting to Claude through editors like VS Code, because it fixes annoying freezes and glitches that used to get in the way of getting work done.
Want a heads-up when Claude Code updates?
We email you the moment a new Claude Code version drops — plus plain-English release notes like these. No spam.
This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.
Fixes
- Fixed a Mac terminal error: Sometimes, on Mac computers, regular terminal commands would fail with a confusing error about a "task output swap." Claude would basically get confused about where to put the results of a command it ran. This is now fixed.
- Fixed saved permissions: If you were using Claude in a brand-new project and told it to "always allow" a certain action, it wasn't actually saving that preference. Now, Claude will correctly remember your choices for next time, even if the project's settings folder doesn't exist yet.
- Fixed remote connection freezes: If you use Claude through an app like VS Code or Claude Desktop and your internet connection to claude.ai gets weak, the screen used to freeze for several minutes after Claude finished doing something. It now handles bad connections smoothly without stalling.
- Fixed giant error messages crashing the chat: If a background task failed and created a massive wall of error text (like a "disk full" error from Git), it used to make the chat message too big to send. Claude now handles these giant errors without breaking the conversation.
How to upgrade
Update to Claude Code v2.1.252 by running:
claude update
This is our plain-language summary. Read the complete, official notes on the Claude Code official changelog ↗.
