📦 Claude Code v2.1.89 - Headless defer permissions, flicker-free rendering

content/CHANGELOG.md

@@ -1,48 +1,59 @@
 # Changelog
 
-## 2.1.88
+## 2.1.89
 
+- Added `"defer"` permission decision to `PreToolUse` hooks — headless sessions can pause at a tool call and resume with `-p --resume` to have the hook re-evaluate
 - Added `CLAUDE_CODE_NO_FLICKER=1` environment variable to opt into flicker-free alt-screen rendering with virtualized scrollback
 - Added `PermissionDenied` hook that fires after auto mode classifier denials — return `{retry: true}` to tell the model it can retry
 - Added named subagents to `@` mention typeahead suggestions
-- Fixed prompt cache misses in long sessions caused by tool schema bytes changing mid-session
-- Fixed nested CLAUDE.md files being re-injected dozens of times in long sessions that read many files
+- Added `MCP_CONNECTION_NONBLOCKING=true` for `-p` mode to skip the MCP connection wait entirely, and bounded `--mcp-config` server connections at 5s instead of blocking on the slowest server
+- Auto mode: denied commands now show a notification and appear in `/permissions` → Recent tab where you can retry with `r`
+- Fixed `Edit(//path/**)` and `Read(//path/**)` allow rules to check the resolved symlink target, not just the requested path
+- Fixed voice push-to-talk not activating for some modifier-combo bindings, and voice mode on Windows failing with "WebSocket upgrade rejected with HTTP 101"
 - Fixed Edit/Write tools doubling CRLF on Windows and stripping Markdown hard line breaks (two trailing spaces)
-- Fixed `StructuredOutput` schema cache bug causing ~50% failure rate in workflows with multiple schemas
+- Fixed `StructuredOutput` schema cache bug causing ~50% failure rate when using multiple schemas
 - Fixed memory leak where large JSON inputs were retained as LRU cache keys in long-running sessions
-- Fixed a potential out-of-memory crash when the Edit tool was used on very large files (>1 GiB)
 - Fixed a crash when removing a message from very large session files (over 50MB)
+- Fixed LSP server zombie state after crash — server now restarts on next request instead of failing until session restart
+- Fixed prompt history entries containing CJK or emoji being silently dropped when they fall on a 4KB boundary in `~/.claude/history.jsonl`
+- Fixed `/stats` undercounting tokens by excluding subagent usage, and losing historical data beyond 30 days when the stats cache format changes
+- Fixed `-p --resume` hangs when the deferred tool input exceeds 64KB or no deferred marker exists, and `-p --continue` not resuming deferred tools
+- Fixed `claude-cli://` deep links not opening on macOS
+- Fixed MCP tool errors truncating to only the first content block when the server returns multi-element error content
+- Fixed skill reminders and other system context being dropped when sending messages with images via the SDK
+- Fixed PreToolUse/PostToolUse hooks to receive `file_path` as an absolute path for Write/Edit/Read tools, matching the documented behavior
+- Fixed autocompact thrash loop — now detects when context refills to the limit immediately after compacting three times in a row and stops with an actionable error instead of burning API calls
+- Fixed prompt cache misses in long sessions caused by tool schema bytes changing mid-session
+- Fixed nested CLAUDE.md files being re-injected dozens of times in long sessions that read many files
 - Fixed `--resume` crash when transcript contains a tool result from an older CLI version or interrupted write
 - Fixed misleading "Rate limit reached" message when the API returned an entitlement error — now shows the actual error with actionable hints
-- Fixed LSP server zombie state after crash — server now restarts on next request instead of failing until session restart
 - Fixed hooks `if` condition filtering not matching compound commands (`ls && git push`) or commands with env-var prefixes (`FOO=bar git push`)
-- Fixed prompt history entries containing CJK or emoji being silently dropped when they fall on a 4KB boundary in `~/.claude/history.jsonl`
-- Fixed `/stats` losing historical data beyond 30 days when the stats cache format changes
-- Fixed `/stats` undercounting tokens by excluding subagent/fork usage
-- Fixed scrollback disappearing when scrolling up in long sessions
 - Fixed collapsed search/read group badges duplicating in terminal scrollback during heavy parallel tool use
 - Fixed notification `invalidates` not clearing the currently-displayed notification immediately
 - Fixed prompt briefly disappearing after submit when background messages arrived during processing
-- Fixed long `/btw` responses being clipped with no way to scroll — responses now render in a scrollable viewport
 - Fixed Devanagari and other combining-mark text being truncated in assistant output
 - Fixed rendering artifacts on main-screen terminals after layout shifts
 - Fixed voice mode failing to request microphone permission on macOS Apple Silicon
-- Fixed voice push-to-talk not activating for some modifier-combo bindings
-- Fixed voice mode on Windows failing with "WebSocket upgrade rejected with HTTP 101"
 - Fixed Shift+Enter submitting instead of inserting a newline on Windows Terminal Preview 1.25
 - Fixed periodic UI jitter during streaming in iTerm2 when running inside tmux
 - Fixed PowerShell tool incorrectly reporting failures when commands like `git push` wrote progress to stderr on Windows PowerShell 5.1
-- Fixed SDK error result messages (`error_during_execution`, `error_max_turns`) to correctly set `is_error: true` with descriptive messages
-- Fixed task notifications being lost when backgrounding a session with Ctrl+B
-- Fixed PreToolUse/PostToolUse hooks not providing `file_path` as an absolute path for Write/Edit/Read tools
+- Fixed a potential out-of-memory crash when the Edit tool was used on very large files (>1 GiB)
+- Improved collapsed tool summary to show "Listed N directories" for `ls`/`tree`/`du` instead of "Read N files"
+- Improved Bash tool to warn when a formatter/linter command modifies files you have previously read, preventing stale-edit errors
+- Improved `@`-mention typeahead to rank source files above MCP resources with similar names
 - Improved PowerShell tool prompt with version-appropriate syntax guidance (5.1 vs 7+)
-- Thinking summaries are no longer generated by default in interactive sessions — set `showThinkingSummaries: true` in settings to restore
-- Auto mode denied commands now show a notification and appear in `/permissions` → Recent tab
+- Changed `Edit` to work on files viewed via `Bash` with `sed -n` or `cat`, without requiring a separate `Read` call first
+- Changed hook output over 50K characters to be saved to disk with a file path + preview instead of being injected directly into context
+- Changed `cleanupPeriodDays: 0` in settings.json to be rejected with a validation error — it previously silently disabled transcript persistence
+- Changed thinking summaries to no longer be generated by default in interactive sessions — set `showThinkingSummaries: true` in settings.json to restore
+- Documented `TaskCreated` hook event and its blocking behavior
+- Preserved task notifications when backgrounding a running command with Ctrl+B
+- PowerShell tool on Windows: external-command arguments containing both a double-quote and whitespace now prompt instead of auto-allowing (PS 5.1 argument-splitting hardening)
 - `/env` now applies to PowerShell tool commands (previously only affected Bash)
 - `/usage` now hides redundant "Current week (Sonnet only)" bar for Pro and Enterprise plans
-- Collapsed tool summary now shows "Listed N directories" for ls/tree/du instead of "Read N files"
 - Image paste no longer inserts a trailing space
 - Pasting `!command` into an empty prompt now enters bash mode, matching typed `!` behavior
+- `/buddy` is here for April 1st — hatch a small creature that watches you code
 
 ## 2.1.87
 

content/blog/engineering/claude-code-sandboxing.md

@@ -68,7 +68,7 @@ Our new sandboxed bash tool and Claude Code on the web offer substantial improve
 To get started with these tools:
 
 1.   Run `/sandbox` in Claude and check out [our docs](https://docs.claude.com/en/docs/claude-code/sandboxing) on how to configure this sandbox.
-2.   Go to [claude.com/code](http://claude.ai/redirect/website.v1.00086a34-31b8-49b6-afd7-84f7cb165327/code) to try out Claude Code on the web.
+2.   Go to [claude.com/code](http://claude.ai/redirect/website.v1.bcb8a49f-354f-40c9-af56-bd1c4d63f22d/code) to try out Claude Code on the web.
 
 Or, if you're building your own agents, check out our [open-sourced sandboxing code](https://github.com/anthropic-experimental/sandbox-runtime), and consider integrating it into your work. We look forward to seeing what you build.
 

content/blog/news/anthropic-acquires-bun-as-claude-code-reaches-usd1b-milestone.md

@@ -23,6 +23,10 @@ If you’re interested in joining Anthropic’s engineering team, visit our [car
 
 ## Related content
 
+### Australian government and Anthropic sign MOU for AI safety and research
+
+[Read more](https://www.anthropic.com/news/australia-MOU)
+
 ### Anthropic invests $100 million into the Claude Partner Network
 
 We’re launching the Claude Partner Network, a program for partner organizations helping enterprises adopt Claude.
@@ -34,7 +38,3 @@ We’re launching the Claude Partner Network, a program for partner organization
 We’re launching The Anthropic Institute, a new effort to confront the most significant challenges that powerful AI will pose to our societies.
 
 [Read more](https://www.anthropic.com/news/the-anthropic-institute)
-
-### Sydney will become Anthropic’s fourth office in Asia-Pacific
-
-[Read more](https://www.anthropic.com/news/sydney-fourth-office-asia-pacific)

content/blog/news/claude-code-on-team-and-enterprise.md

@@ -46,6 +46,10 @@ To explore how Claude for Enterprise can transform your organization's productiv
 
 ## Related content
 
+### Australian government and Anthropic sign MOU for AI safety and research
+
+[Read more](https://www.anthropic.com/news/australia-MOU)
+
 ### Anthropic invests $100 million into the Claude Partner Network
 
 We’re launching the Claude Partner Network, a program for partner organizations helping enterprises adopt Claude.
@@ -57,7 +61,3 @@ We’re launching the Claude Partner Network, a program for partner organization
 We’re launching The Anthropic Institute, a new effort to confront the most significant challenges that powerful AI will pose to our societies.
 
 [Read more](https://www.anthropic.com/news/the-anthropic-institute)
-
-### Sydney will become Anthropic’s fourth office in Asia-Pacific
-
-[Read more](https://www.anthropic.com/news/sydney-fourth-office-asia-pacific)

content/blog/news/claude-code-security.md

@@ -45,6 +45,10 @@ To learn more, visit [claude.com/solutions/claude-code-security](http://claude.c
 
 ## Related content
 
+### Australian government and Anthropic sign MOU for AI safety and research
+
+[Read more](https://www.anthropic.com/news/australia-MOU)
+
 ### Anthropic invests $100 million into the Claude Partner Network
 
 We’re launching the Claude Partner Network, a program for partner organizations helping enterprises adopt Claude.
@@ -56,7 +60,3 @@ We’re launching the Claude Partner Network, a program for partner organization
 We’re launching The Anthropic Institute, a new effort to confront the most significant challenges that powerful AI will pose to our societies.
 
 [Read more](https://www.anthropic.com/news/the-anthropic-institute)
-
-### Sydney will become Anthropic’s fourth office in Asia-Pacific
-
-[Read more](https://www.anthropic.com/news/sydney-fourth-office-asia-pacific)

content/blog/news/enabling-claude-code-to-work-more-autonomously.md

@@ -54,6 +54,10 @@ These updates are available now for Claude Code users.
 
 ## Related content
 
+### Australian government and Anthropic sign MOU for AI safety and research
+
+[Read more](https://www.anthropic.com/news/australia-MOU)
+
 ### Anthropic invests $100 million into the Claude Partner Network
 
 We’re launching the Claude Partner Network, a program for partner organizations helping enterprises adopt Claude.
@@ -65,7 +69,3 @@ We’re launching the Claude Partner Network, a program for partner organization
 We’re launching The Anthropic Institute, a new effort to confront the most significant challenges that powerful AI will pose to our societies.
 
 [Read more](https://www.anthropic.com/news/the-anthropic-institute)
-
-### Sydney will become Anthropic’s fourth office in Asia-Pacific
-
-[Read more](https://www.anthropic.com/news/sydney-fourth-office-asia-pacific)

content/claude-code-manifest.json

@@ -1,12 +1,12 @@
 {
   "name": "@anthropic-ai/claude-code",
-  "version": "2.1.88",
+  "version": "2.1.89",
   "author": {
     "name": "Anthropic",
     "email": "support@anthropic.com"
   },
   "license": "SEE LICENSE IN README.md",
-  "_id": "@anthropic-ai/claude-code@2.1.88",
+  "_id": "@anthropic-ai/claude-code@2.1.89",
   "maintainers": [
     {
       "name": "zak-anthropic",
@@ -73,17 +73,17 @@
     "claude": "cli.js"
   },
   "dist": {
-    "shasum": "c22a001bea2241defb15d0124939836170389daf",
-    "tarball": "https://registry.npmjs.org/@anthropic-ai/claude-code/-/claude-code-2.1.88.tgz",
-    "fileCount": 20,
-    "integrity": "sha512-ukMtYZCi0I7cD3rt89rnXy20D/Zvk0Gj/SW60xYfz17zTslLz+VuhXw/KPb+2ndp3/ATadJdyNEqdKQlcNk7nQ==",
+    "shasum": "f2cb6b8b589a0d4f8a2b83a3920812a747336cf8",
+    "tarball": "https://registry.npmjs.org/@anthropic-ai/claude-code/-/claude-code-2.1.89.tgz",
+    "fileCount": 19,
+    "integrity": "sha512-etjihHqVxj1RjS5Zu/o+rv3ojn1N7AWzfgIOCSSSncfyb4qJn9J677scj0LHIxtwzjgU7j1qAedXlXKxgkFG2w==",
     "signatures": [
       {
-        "sig": "MEUCIHXjhm3IsYM1o1worSMkPW8rIHqSNsV6D08wJoIArNumAiEAtiif6ZPqt/ovlEXSM0sEc8NuCteOb+yIkDZcff2kFSk=",
+        "sig": "MEQCIGE+C8+9YI/pUb190BmNwyXJoCVGOag9G1Y3vLZw2US4AiBS5g+q78qYJmLaQTdAG1Jrz2RfjHAuifZHgchG6+ESCg==",
         "keyid": "SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"
       }
     ],
-    "unpackedSize": 102754401
+    "unpackedSize": 43022346
   },
   "type": "module",
   "engines": {
@@ -115,7 +115,7 @@
     "@img/sharp-linuxmusl-arm64": "^0.34.2"
   },
   "_npmOperationalInternal": {
-    "tmp": "tmp/claude-code_2.1.88_1774910207554_0.1190643563209497",
+    "tmp": "tmp/claude-code_2.1.89_1774999959972_0.700223617424049",
     "host": "s3://npm-registry-packages-npm-production"
   }
 }

content/en/agent-sdk/python.md

@@ -1193,7 +1193,7 @@ SdkBeta = Literal["context-1m-2025-08-07"]
 Use with the `betas` field in `ClaudeAgentOptions` to enable beta features.
 
 <Warning>
-The `context-1m-2025-08-07` beta is retired as of April 30, 2026. Requests using this header with Claude Sonnet 4.5 or Sonnet 4 will return a 400 error. To use a 1M-token context window, migrate to [Claude Sonnet 4.6 or Claude Opus 4.6](/docs/en/about-claude/models/overview), which include 1M context at standard pricing with no beta header required.
+The `context-1m-2025-08-07` beta is retired as of April 30, 2026. Passing this header with Claude Sonnet 4.5 or Sonnet 4 has no effect, and requests that exceed the standard 200k-token context window return an error. To use a 1M-token context window, migrate to [Claude Sonnet 4.6 or Claude Opus 4.6](/docs/en/about-claude/models/overview), which include 1M context at standard pricing with no beta header required.
 </Warning>
 
 ### `McpSdkServerConfig`

content/en/agent-sdk/typescript.md

@@ -2119,7 +2119,7 @@ type SdkBeta = "context-1m-2025-08-07";
 ```
 
 <Warning>
-The `context-1m-2025-08-07` beta is retired as of April 30, 2026. Requests using this value with Claude Sonnet 4.5 or Sonnet 4 will return a 400 error. To use a 1M-token context window, migrate to [Claude Sonnet 4.6 or Claude Opus 4.6](/docs/en/about-claude/models/overview), which include 1M context at standard pricing with no beta header required.
+The `context-1m-2025-08-07` beta is retired as of April 30, 2026. Passing this value with Claude Sonnet 4.5 or Sonnet 4 has no effect, and requests that exceed the standard 200k-token context window return an error. To use a 1M-token context window, migrate to [Claude Sonnet 4.6 or Claude Opus 4.6](/docs/en/about-claude/models/overview), which include 1M context at standard pricing with no beta header required.
 </Warning>
 
 ### `SlashCommand`

content/en/docs/claude-code/agent-teams.md

@@ -225,8 +225,24 @@ Teams and tasks are stored locally:
 * **Team config**: `~/.claude/teams/{team-name}/config.json`
 * **Task list**: `~/.claude/tasks/{team-name}/`
 
+Claude Code generates both of these automatically when you create a team and updates them as teammates join, go idle, or leave. The team config holds runtime state such as session IDs and tmux pane IDs, so don't edit it by hand or pre-author it: your changes are overwritten on the next state update.
+
+To define reusable teammate roles, use [subagent definitions](#use-subagent-definitions-for-teammates) instead.
+
 The team config contains a `members` array with each teammate's name, agent ID, and agent type. Teammates can read this file to discover other team members.
 
+There is no project-level equivalent of the team config. A file like `.claude/teams/teams.json` in your project directory is not recognized as configuration; Claude treats it as an ordinary file.
+
+### Use subagent definitions for teammates
+
+When spawning a teammate, you can reference a [subagent](/en/sub-agents) type from any [subagent scope](/en/sub-agents#choose-the-subagent-scope): project, user, plugin, or CLI-defined. The teammate inherits that subagent's system prompt, tools, and model. This lets you define a role once, such as a security-reviewer or test-runner, and reuse it both as a delegated subagent and as an agent team teammate.
+
+To use a subagent definition, mention it by name when asking Claude to spawn the teammate:
+
+```text  theme={null}
+Spawn a teammate using the security-reviewer agent type to audit the auth module.
+```
+
 ### Permissions
 
 Teammates start with the lead's permission settings. If the lead runs with `--dangerously-skip-permissions`, all teammates do too. After spawning, you can change individual teammate modes, but you can't set per-teammate modes at spawn time.

content/en/docs/claude-code/amazon-bedrock.md

@@ -116,6 +116,9 @@ export AWS_REGION=us-east-1  # or your preferred region
 
 # Optional: Override the region for the small/fast model (Haiku)
 export ANTHROPIC_SMALL_FAST_MODEL_AWS_REGION=us-west-2
+
+# Optional: Override the Bedrock endpoint URL for custom endpoints or gateways
+# export ANTHROPIC_BEDROCK_BASE_URL=https://bedrock-runtime.us-east-1.amazonaws.com
 ```
 
 When enabling Bedrock for Claude Code, keep the following in mind:
@@ -245,6 +248,14 @@ Example configuration:
 
 ## Troubleshooting
 
+### Authentication loop with SSO and corporate proxies
+
+If browser tabs spawn repeatedly when using AWS SSO, remove the `awsAuthRefresh` setting from your [settings file](/en/settings). This can occur when corporate VPNs or TLS inspection proxies interrupt the SSO browser flow. Claude Code treats the interrupted connection as an authentication failure, re-runs `awsAuthRefresh`, and loops indefinitely.
+
+If your network environment interferes with automatic browser-based SSO flows, use `aws sso login` manually before starting Claude Code instead of relying on `awsAuthRefresh`.
+
+### Region issues
+
 If you encounter region issues:
 
 * Check model availability: `aws bedrock list-inference-profiles --region your-region`