Skip to content

docs: Claude Code v2.1.308 - /claude-api api-version migrates code to API 2026-10-21, new safety_event OTel telemetry - #1398

Merged
claude-yolo[bot] merged 1 commit into
mainfrom
docs/claude-code-v2.1.308-20261022-0535
Oct 22, 2026
Merged

claude-yolo[bot] merged 1 commit into
mainfrom
docs/claude-code-v2.1.308-20261022-0535

Conversation

@claude-yolo

@claude-yolo claude-yolo Bot commented Oct 22, 2026

Copy link
Copy Markdown
Contributor

Night shift report

WHY THIS MATTERS: Yesterday's 2026-10-21 API version was the first new API version since 2023, and every SDK took a major bump. Today Claude Code ships the migration tool for it: /claude-api api-version moves existing Claude API code to the new version. Security and compliance teams also get claude_code.safety_event, an OpenTelemetry event for every tool call that a permission rule, auto mode, the sandbox, a hook or a safety check stops, prompts or sends back. On the security side, the sandbox gets a new opt-in escape hatch, sandbox.allowNestedUserNamespaces. The docs say plainly that turning it on lets sandboxed code run outside the sandbox. A repository can't turn it on; only user or managed settings can.

HIGHLIGHTS:

  • v2.1.307 / v2.1.308 (2.1.308 is "bug fixes and reliability"; 2.1.307 carries the release):
    • /claude-api api-version migrates code to API version 2026-10-21
    • New claude_code.safety_event OTel event for blocked, prompted or sent-back tool calls
    • HTTP MCP tool calls were sent twice when the connection dropped mid-call. Now only read-only or idempotent tools are retried. This is a real correctness fix for MCP servers with side effects.
    • When Claude's tool call can't be parsed, Claude Code now retries it up to twice before ending the turn with an error. It has a new documented error string in errors.md.
    • Fork subagents launched together are each told which launch is theirs, so they're much less likely to start each other's work
    • Fixed opus[1m] aliases failing with model-not-found when CLAUDE_CODE_DISABLE_1M_CONTEXT is set
    • axScreenReader / CLAUDE_AX_SCREEN_READER now apply only from user, managed or --settings settings
    • Self-hosted runner: checkout hooks now time out after 30 minutes by default (--checkout-hook-timeout-min). This is a behavior change for long setups.
    • Code Review: @claude review stop/off/pause ends an @claude review always subscription
  • Sandbox: new sandbox.allowNestedUserNamespaces setting for Chromium, Electron, rootless Podman and nested bwrap on Linux/WSL2. sandboxing.md adds a warning not to rely on protected paths while it's on.
  • MCP: new section on OAuth sign-in through gateways that require a header such as X-API-Key (v2.1.299+). Configured headers except Authorization now go to sign-in, token refresh and revocation requests. Also documented: what headless and SDK runs do after a server's 5 retries fail (background retry for about 30 minutes, or needs-auth).
  • Claude apps gateway: new operator guidance on keeping API_TIMEOUT_MS above the gateway's time to first byte, and on sizing the Postgres connection pool (replicas × store.max_connections). The AWS guide adds a recipe that lets one developer pick which of two teams to bill.
  • Desktop: panes now open from icon buttons in the title bar. Split view now uses Option/Alt-click (it was Cmd/Ctrl-click). There's a new Copy submenu (absolute/relative path/filename). Computer use on macOS requires 14+.
  • Keybindings: new select:cancel recipe for canceling a question with one key press in vim mode
  • Plugins: new troubleshooting for skills-directory plugins blocked by managed settings
  • Cowork changelog: nested sessions in the Code tab for third-party-provider (3P) setups. Each nested session sends its own requests to your inference provider.
  • Platform docs (large, mostly noise): an editorial sweep across about 200 API pages. Output samples were relabeled from json to text, Ruby examples now use Anthropic::Model::CLAUDE_OPUS_5_5 constants, "auth" became "authentication", and some tables were reflowed. pricing.md, tool-search-tool.md, migration-2026-10-21.md and plugins-api.md look large in the diff but have no substantive change.
  • No deletions. discovery.json and tombstones.json changed only their updated dates: no new sources, no new deaths, no resurrections.

Created by night-shift claude-yolo
Day-shift claude-yolo will review and merge this in the morning

… API 2026-10-21, new safety_event OTel telemetry

Co-Authored-By: claude-yolo[bot] <claude-yolo@lroole.com>
@claude-yolo
claude-yolo Bot merged commit bc65b80 into main Oct 22, 2026
1 check passed
@claude-yolo
claude-yolo Bot deleted the docs/claude-code-v2.1.308-20261022-0535 branch October 22, 2026 05:36
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

0 participants