Jonathon's AI Wiki

Claude Code Week 21 Release Digest (May 12–, 2026)

15 min read

Source: raw/anthropic-watch-claude-code-tag-v2-1-{140,141}.md (release notes), raw/anthropic-watch-anthropic-sdk-python-tag-v0-102-0.md + raw/anthropic-watch-anthropic-sdk-typescript-tag-sdk-v0-96-0.md (SDK releases), four anthropics/claude-cookbooks commits (a0902061, e7b800d4, 96442914, b5b727b7 — CMA Sessions API MCP server + Linear stateless webhook bridge), raw/reddit-1tc9oa0.md (Claude Code weekly limits +50%, ClaudeOfficial 754 score), raw/reddit-1tcetsd.md (--print → SDK credit split June 15, 452 score / 211 comments), YouTube transcripts on the dethroning-and-counter-promo arc and the /goal deep-dive

Week 21 is the commercial-model + business-adoption inflection: Anthropic passes OpenAI in business adoption for the first time (per the same week’s industry data), Claude Code weekly limits jump +50% through July 13, and claude --print flips from CLI-credit usage to SDK-credit programmatic billing on June 15. On the engineering side, v2.1.140 + v2.1.141 ship hook desktop-notification surfaces, workspace-federation auth, agent-view CWD scoping, the Rewind menu’s “Summarize up to here,” and a swarm of UX polish; Python SDK v0.102.0 + TS sdk-v0.96.0 add the BetaManagedAgentsSearchResultBlock types and cache-diagnostics beta; and the cookbook ships the first CMA Sessions API as MCP server + Linear stateless webhook bridge template — Managed Agents now has an off-the-shelf MCP integration surface and a no-SSE/no-DB webhook-bridge pattern.

Headline changes

Claude Code v2.1.141 (May 13)

  • Hook terminalSequence JSON output — hooks can now emit desktop notifications, window titles, and bells without a controlling terminal. Closes the headless-environments gap where hooks could rule on tool use but couldn’t surface a user-visible signal. See Hooks.
  • CLAUDE_CODE_PLUGIN_PREFER_HTTPS env var — clone GitHub plugin sources over HTTPS instead of SSH for environments without a GitHub SSH key. Important for sandboxed CI, ephemeral devboxes, locked-down enterprise terminals. Pairs with plugin distribution surface improvements.
  • ANTHROPIC_WORKSPACE_ID env var for workload identity federation — scopes the minted token to a specific workspace when the federation rule covers more than one. Targeted fix for orgs whose IAM federation grants access to multiple Anthropic workspaces from one identity. See SDK releases for the matching auth surface.
  • claude agents --cwd <path> — scope the agent-view session list to a directory. Companion to the v2.1.139 agent view; the Moritz Kremb / Vibe Coding-style /clients/<client>/ folder layouts now isolate cleanly in the multi-session UI.
  • /feedback can include recent sessions (last 24h or 7d) — for issues spanning more than the current session. Materially better bug reports.
  • Rewind menu: “Summarize up to here” — compress earlier context while keeping recent turns intact. New affordance on the Rewind menu; pairs with the v2.1.139 compaction-prompt improvements.
  • Auto mode permission dialog now explains the permissions.ask rule that caused the prompt. Closes the “why is this dialog showing?” question; relevant when running in --dangerously-skip-permissions=false with curated allowlists.
  • “View diff in your IDE” restored on file-edit permission prompts when an IDE is connected. Small fix to a regression.
  • Background agents launched via /bg or ←← preserve the current permission mode — no more reverting to default. Important for the --dangerously-skip-permissions flows that the W20 agent view walkthroughs depend on.
  • claude agents: agents that finish work but leave a background shell running now move to Completed instead of staying under Working. Polish on the agent-view state machine.
  • Spinner warms to amber after 10 seconds during long thinking periods — signals Claude is still working, not stuck. Small but visible feedback fix.
  • Plugin menu navigation polish — →/Tab switch tabs, ↑ moves to the tab strip, headers + search box clickable in fullscreen mode.

Claude Code v2.1.140 (May 12)

  • Agent tool subagent_type case- and separator-insensitive matching — "Code Reviewer" resolves to code-reviewer. Removes a footgun for human-typed agent invocations in agent-teams / subagents flows.
  • Updated agent color palette — cosmetic but referenced in v2.1.141 polish.
  • /goal silently hanging fix when disableAllHooks or allowManagedHooksOnly is set — now shows a clear message instead of an indeterminate indicator. Closes a class of “is /goal working or stuck?” bugs.
  • Settings hot-reload regression fix where symlinked settings files caused misattributed change events and spurious ConfigChange hooks. Relevant for users with symlinked ~/.claude/settings.json from a dotfiles repo.
  • claude --bg connection-dropped fix when the background service was about to idle-exit. Fewer “background started, immediately died” failures.
  • Background service startup time extended to accommodate enterprise endpoint security. Symptom on locked-down Windows machines was startup timing out before AV scan finished.
  • Remote managed settings: retry on 401 with a force-refreshed token. Closes a token-refresh race condition.
  • Managed extraKnownMarketplaces auto-update policy now persisted to known_marketplaces.json. Fix for enterprise marketplace pinning.
  • /loop no longer schedules redundant wakeups for background tasks that already notify on completion. Token-cost reduction for Routines users.
  • Windows event-loop stall fix when a missing executable (e.g. gh) triggered synchronous where.exe re-spawns on every check. Targeted Windows performance fix.
  • Read tool offset validation now accepts whitespace-padded or +-prefixed strings. Closes an LLM-emits-whitespace bug class.
  • Native terminal cursor stays at input caret when the terminal loses focus.
  • Plugin folder warning when a default component folder (e.g. commands/) is silently ignored because plugin.json sets the matching key. Surfaced in /doctor and plugin details.

Claude Code weekly limits +50% through July 13

Source: r/ClaudeAI 1tc9oa0 (raw/reddit-1tc9oa0.md, ClaudeOfficial post, 754 score / 162 comments, 2026-05-13).

  • All Pro, Max, Team, and seat-based Enterprise users.
  • Applies everywhere Claude Code runs — CLI, IDE extensions, desktop, web.
  • Live now, runs through July 13 at 6PM PDT / 1AM GMT (2 months from announcement).
  • Stacks with the 2× increase to 5-hour limits announced in W20 (post-conference).
  • No opt-in required; check current limits with /usage.

This is the subscription-tier counterweight to the claude --print SDK-billing split below. The weekly-limit increase and the -p repricing land within hours of each other — the framing is “more headroom on the subscription surface, less subsidy on the programmatic surface.”

claude --print → SDK credits (effective June 15)

Source: r/ClaudeAI 1tcetsd (raw/reddit-1tcetsd.md, 452 score / 211 comments, 2026-05-13). Canonical Anthropic doc: support.claude.com/en/articles/15036540-use-the-claude-agent-sdk-with-your-claude-plan.

From June 15 forward, jobs launched via claude --print (and equivalent Claude Agent SDK programmatic usage) bill against a separate monthly SDK credit bucket instead of the Pro/Max plan’s CLI tokens. The Pro/Max plans get an included SDK credit allowance (community reports suggest ~$100/mo on Max), but heavy programmatic use will exceed it.

Why this matters:

  • The “Claude Code as a free programmatic harness” gravy-train is over. Pre-June-15, users could pipe -p from supervisors, hook executors, cron jobs, and custom orchestrators — all metered against subscription tokens. Post-June-15, those workflows draw on a separate SDK bucket.
  • Targeted at always-on harnesses. OP’s post in r/ClaudeAI (452 score) describes “an autonomous self-monitoring self-orchestrating Kanban production system” — the exact pattern Anthropic is repricing. See Routines and the Printing Press CLI factory pattern for the harness-shaped workflows affected.
  • Workaround patterns surfacing in the community. Siigari/claude-heartbeat — a ~100-line stop-hook supervisor that polls an inbox file, injects messages into interactive Claude Code sessions, kills + restarts for fresh context. Achieves stateless-per-message behavior in interactive mode (which still bills against subscription tokens). Pattern unverified at scale; logged here for tracking. (Skipped from a standalone ingest pending repo verification.)
  • Distinct from Claude Platform on AWS / native API billing, which are intentional programmatic surfaces. The --print repricing aligns the CLI’s programmatic mode with those surfaces — -p was an undocumented loophole.

This is the business-model inflection of the week. Combined with the +50% weekly-limit increase, Anthropic is widening the subscription surface for interactive coding work while closing the subsidized-API loophole for programmatic agents.

Anthropic passes OpenAI in business adoption (April 2026)

Source: raw/Anthropic_Just_Dethroned_OpenAI._Here_s_What_Happens_Next..md (YouTube transcript, 2026-05-14, citing an industry-research article published the same morning).

For the first time, Anthropic has surpassed OpenAI in business adoption, per the index referenced in the source video (OpenAI led from early 2023 through March 2026; the crossover landed in April 2026). The dethroning prompted an immediate counter-move from Sam Altman: 2 months of free Codex usage for companies switching from Claude Code, posted to X. Within 45 minutes, Anthropic posted the +50% weekly-limit announcement above — the responses paired in time and intent.

The “free sample phase” framing (from the source video): both vendors are aggressively subsidizing the consumer-developer side of the market. The pace of subsidy is now the second-order tell about which lab is gaining business-share. Worth tracking the next ~60 days for further reciprocal moves.

This pairs with the W20 Claude Platform on AWS GA (distribution) + May 7 SpaceX-Colossus capacity announcement (capacity) + Managed Agents (agent surface). The three-legged production-readiness story Anthropic threaded post-conference is now showing up in the business-adoption numbers.

/goal deep-dive — Claude Code + Codex head-to-head

Source: raw/The_Future_of_AI_Agents_Just_Arrived_goal_for_Claude_Code_Codex.md (YouTube transcript, 2026-05-13). Follow-up coverage of the [[claude-ai/whats-new-2026-w20|W20 /goal command]].

The /goal command was previewed at Code with Claude and shipped in v2.1.139. This week’s deep-dive coverage confirms the patterns:

  • Long-running sessions are now mainstream. 14-hour overnight sessions are routine; the longest documented session in the source video ran 5 days straight. The Ralph-loop pattern is now built into the CLI proper.
  • Codex shipped /goal first (~2 weeks ahead of Anthropic per the source). Anthropic shipped the matching surface in v2.1.139. Same convergent pattern as the Codex-Cursor-Anthropic agent-view convergence in W20.
  • Definition-of-done is the operator skill the new command surfaces. The video frames /goal as “what the Ralph loop did, but native.” Goal-converged sibling to the schedule-driven /loop and the event-driven Monitor tool.
  • Productivity multiplier vs. wall-clock cost. The community framing is “set the goal, walk away, come back to PR-ready output.” Implication for the +50% weekly-limit increase: Anthropic is supplying more headroom precisely because /goal makes the headroom load-bearing.

Cookbook: CMA Sessions API as MCP server + Linear bridge template

Two May-13 commits to anthropics/claude-cookbooks add the Managed Agents programmatic surface to MCP and to webhook-driven bridges:

CMA Sessions API as an MCP server (stdio + HTTP)

Commits a0902061 + merge e7b800d4 (PR #617, author rlancemartin). github.com/anthropics/claude-cookbooks/commit/a0902061.

  • Thin MCP server wrapping the Managed Agents Sessions API so Claude Desktop or claude.ai can drive hosted CMA agents via tool calls. DIY bridge until “publish agent to claude.ai” is first-class.
  • 9 tools in shared src/tools.ts — 8 are 1:1 endpoint wrappers; wait_for_idle is the SSE → request/response shim.
  • Two entrypoints: server.ts (stdio, Desktop) and server-http.ts (Streamable HTTP + bearer auth, claude.ai Connector).
  • Dockerfile for Fly / Railway / Render.
  • list_agents capped + name_contains filter (busy workspaces hang auto-pagination).
  • Authoring / destructive / secret endpoints deliberately excluded — read + drive only, no admin from the MCP surface.
  • README forks on client; CLAUDE.md invokes /claude-api; skill.md has Desktop + Connector setup, relay-mode Project instructions, org-admin gating note.
  • Stdio path proven e2e in Claude Desktop; HTTP smoke-tested via ngrok.

Linear stateless webhook bridge template

Commits 96442914 + merge b5b727b7 (PR #607, author rlancemartin). github.com/anthropics/claude-cookbooks/commit/96442914.

  • Minimal TypeScript/Bun bridge connecting Linear’s Agent Platform to Managed Agents via CMA outbound webhooks — no held SSE streams, no session-map DB. session.metadata carries linear_session_id + org_id.
  • setup/create-agent.ts — one-time agent + environment (claude-opus-4-7).
  • src/agent.ts — Linear @mention → sessions.create + kickoff message.
  • src/cma-webhook.ts — beta.webhooks.unwrap → retrieve-then-filter → createAgentActivity reply.
  • src/oauth.ts — Linear OAuth (actor=app) + token store.
  • README with diagram + bun install && claude quickstart.
  • CLAUDE.md — invokes /claude-api, reads skill.md, offers extensions menu.
  • skill.md — walkthrough + gotchas (workspace-scoped webhooks, actor=app, 10s ack, retrieve-then-filter), debugging.
  • Uses @anthropic-ai/sdk ^0.95.1 (depends on beta.webhooks.unwrap). Proven e2e.

Why this matters: the two cookbook commits ship the off-the-shelf templates for the two most common Managed Agents integration shapes — MCP server (drive CMA from Desktop/claude.ai) and stateless webhook bridge (drive CMA from a third-party agent platform). Pattern likely repeats: expect similar bridges for Slack agents, GitHub agents, Notion agents over the next quarter. See Anthropic Cookbook: Managed Agents Multiagent + Outcomes for the full cookbook surface.

Python SDK v0.102.0 + TS sdk-v0.96.0

Source: raw/anthropic-watch-anthropic-sdk-python-tag-v0-102-0.md + raw/anthropic-watch-anthropic-sdk-typescript-tag-sdk-v0-96-0.md (both 2026-05-13).

Two version-locked features land in both SDKs:

  • BetaManagedAgentsSearchResultBlock types — new content-block type for Managed Agents search results, surfaced through the API spec. First-class type support for the “agent searched, here’s the result block” interaction pattern. Hooks directly into the cookbook MCP server above.
  • Cache diagnostics beta — opt-in beta for surfacing prompt-cache hit/miss diagnostics. Important for cost-optimization work; closes the “is my prompt cache actually hitting?” measurement gap for SDK clients. See Prompt Caching for Agencies for the cost-side discipline this measurement unlocks.

Python v0.102.0 also adds:

  • internal/types: support eagerly validating pydantic iterators — better validation of streaming type-checked iterators. Internal but improves type-safety surface for advanced Python users.

Python v0.102.0 bug fixes:

  • Zod v4-only types in TS (TS-side fix carried in 9e08bcc).

Full SDK refresh details in Anthropic SDK Releases — May 2026.

Smaller wins

  • W20 agent-view walkthroughs continue. raw/Claude_Code_has_a_new_UI_pair_it_with_Claude_OS.md (YouTube, 2026-05-12) — primary-source walkthrough of claude agents flow: /bg continue to migrate existing sessions into the dashboard, Ctrl-S sort by repo, shift up/down reordering, Ctrl-T pinning, spacebar to reply across sessions, terminal-only for now (desktop app surface coming). Validates the v2.1.139 agent-view design end-to-end.
  • 5-level Claude usage progression video. raw/Every_Level_of_Claude_Explained_in_21_Minutes.md covers the claude.ai consumer-surface progression (enthusiast → beginner via projects + screenshots). Maps onto the WEO Marketly Claude Onboarding course; logged here for completeness, no standalone article.

Known caveats (community-reported)

  • -p repricing pain points. The 211-comment thread on claude --print repricing surfaces several patterns that worked under the old billing model but are now uneconomical: long-running orchestrators, supervisor + worker patterns, always-on cron-driven agents. Migrate to native CLI workflows (interactive mode + Routines + agent view) or budget against the SDK credit bucket explicitly.
  • Managed Agents MCP server has explicit safety scope. Authoring, destructive, and secret endpoints are deliberately excluded — agent creation/deletion/secret rotation requires direct CMA API access, not the MCP bridge. Plan workflows accordingly.
  • Linear bridge gotchas documented in the cookbook: workspace-scoped webhooks (not org-scoped); actor=app (not user); 10-second webhook ack window; retrieve-then-filter pattern required.

Try It

  1. Upgrade Claude Code to v2.1.141. claude update. Confirm --version shows 2.1.141. New hooks terminalSequence and agents --cwd <path> are immediately usable.
  2. Bump Python SDK to 0.102.0 or TS SDK to 0.96.0. pip install --upgrade anthropic or npm install @anthropic-ai/sdk@latest. The cache-diagnostics beta is opt-in via header — see release notes for activation.
  3. Audit your -p workflows before June 15. Run grep -r 'claude --print\|claude -p' . against any orchestration code. Each match is a workflow to migrate or budget for under the new SDK credit bucket.
  4. Install the CMA Sessions MCP server in Claude Desktop. Clone the cookbook ref implementation, follow the README quickstart. Useful for any team running Managed Agents that wants to drive them from Desktop chat surfaces.
  5. Watch your /usage numbers. The +50% weekly-limit increase is automatic, but tracking your headroom under the new limit informs whether you should compress workflows further or scale them up while the headroom lasts (through July 13).
  6. Try the Rewind “Summarize up to here” option in a long-context session. Compresses earlier context while keeping recent turns intact — a less destructive alternative to /compact for sessions where you want to keep recent specifics.
  7. Use claude agents --cwd <client-folder> to scope the agent view per-client when running the Moritz Kremb-style folder layout. Closes a real friction point in the W20 agent-view release.

Article counts

claude-ai topic: 129 → 130 articles. Vault total: 280 → 281 articles.

Open Questions

  • What’s the actual size of the included SDK credit bucket on Pro/Max? Community reports cluster around $100/mo on Max; official Anthropic doc framing is “a monthly credit”; needs a primary-source confirm before any cost-modeling decisions.
  • Does the cache-diagnostics beta surface cache write-cost separately? Cookbook coverage doesn’t expand. Open thread until first community measurements land.
  • Will the CMA MCP server pattern get a first-class “publish agent to claude.ai” surface? Cookbook README hints at it (“DIY bridge until…”). Worth watching Code with Claude or future Anthropic blog announcements for the productized version.
  • Anthropic-vs-OpenAI business-adoption crossover — the dethroning claim references an industry-research article quoted in the YT source. Primary source not yet captured in ai-research/; worth a research pass to confirm the exact metric and sample.
  • W17 → W18 → W19 → W20 → W21 release-cadence pattern is now five weeks deep — strong candidate for a connections article on Anthropic’s post-conference release discipline.

Graph View

Backlinks