Claude Code known issues

Known breaks in Claude Code from github.com/anthropics/claude-code, with quoted workarounds and fixed-in versions where they exist.

Before you upgrade Claude Code

Type the version you're about to install (or just upgraded to). Lists tracked issues that mention it. Same data as /api/issues/claude-code.json.

Mentioned in open issues:

Pulled from public GitHub issues updated in the last 45 days and filtered for always-on problems: install and update breakage, crashes and hangs, gateway/daemon trouble, auth, and headless setups. Ranked by engagement, weighted toward always-on, self-hosting, install/update, crash, auth, MCP and daemon problems (cosmetic desktop-UI issues are down-weighted). Workarounds and "fixed in" versions are quoted only when the issue or its top comments state them. Severity is an automatic estimate from labels, keywords, and engagement, not an official rating. Last refresh: Oct 26, 2026 6:18 AM ET.

Claude Code high open self-host/headless

CC v2.1.100+ inflates cache_creation by ~20K tokens vs v2.1.98 — same payload, server-side

Claude Code versions 2.1.100 and 2.1.101 consume ~20,000 more cachecreationinputtokens per request than v2.1.98, despite sending fewer bytes in the request payload. The inflation is server-side and version-specific (likely User-Agent…

anthropics/claude-code#46917versions 2.1.100, 2.1.98, 2.1.101 215 thumbs up · 43 comments opened 2026-04-12 · updated 2026-10-08
Claude Code high open install/update

[BUG] Permission prompt incorrectly triggers on cd instead of the actual command in compound bash statements

When Claude Code generates a compound bash command using && (e.g.: cd /some/path && git add file && git commit -m "msg"), the permission approval prompt incorrectly identifies cd as the action requiring approval, showing a cd: permission…

anthropics/claude-code#28240versions 2.1.40, 2.1.52 209 thumbs up · 49 comments opened 2026-02-24 · updated 2026-10-18
Claude Code medium open self-host/headless

[BUG] Headless `claude -p` (entrypoint `sdk-cli`) uses ~1.8× more of the 5-hour window per token than interactive `cli`, same workload

On a Max subscription, the same workload uses about 1.8× more of the 5-hour window when it runs headless (claude -p --input-format stream-json, recorded as entrypoint: "sdk-cli" in the transcripts) than when it runs in the interactive TUI…

anthropics/claude-code#97074versions 1.8, 2.1.282, 12.74 64 thumbs up · 29 comments opened 2026-09-25 · updated 2026-10-25
Claude Code high fixed install/update

[Bug] VS Code extension: Tool use concurrency error after Jan 23-24 update

Bug Description VS Code extension update ~13 hours ago (Jan 23-24 2026) causes "API Error: 400 due to tool use concurrency issues" on every tool call. CLI works fine, only VS Code affected Error persists through extension reinstall, VS…

anthropics/claude-code#20571versions 2.1.19 183 thumbs up · 133 comments opened 2026-01-24 · updated 2026-10-13
Claude Code high open install/update

[BUG] Desktop 2.37337.1 (Windows, Store/MSIX): built-in "Routines" sidebar section is forced hidden on every launch, and there is no UI toggle to show it

Claude Desktop 2.37337.1, Windows Store/MSIX package (Claudepzs8sxrjxfjjc), self-updated on 2026-10-13 15:11 local time Windows 11 Pro 10.0.26200 Code tab, sidebar in sections layout (sidebarMode: epitaxy) After the update, the dedicated…

anthropics/claude-code#102150versions 10.0.26200 34 thumbs up · 21 comments opened 2026-10-14 · updated 2026-10-23
Claude Code medium open network

[BUG] Monitor tool: doesn't respect persistent flag and timeout_ms schema caps at 3600000 but actual lifetime is ~30 minutes, even during active (non-idle) sessions

The Monitor tool now hard-rejects persistent and timeoutms above 3600000 (1 hour) even with persistent set, it rejects with a schema validation error, and even a Monitor started with the maximum now allowed (3600000) is reported as…

anthropics/claude-code#94393 30 thumbs up · 13 comments opened 2026-09-14 · updated 2026-10-23
Claude Code medium open always-on/daemon

[BUG] Interactive sessions write the 5-minute prompt cache despite requesting 1h: `cache-keepalive-2026-09-03` beta (2.1.296–2.1.300, Team and Max; `claude -p` unaffected)

Since 2026-10-12 at about 18:18 UTC, every newly started interactive session writes its main-conversation prompt cache under the 5-minute TTL. Headless claude -p runs on the same account, machine, version and model still write under 1…

anthropics/claude-code#101685versions 2.1.296, 2.1.300 12 thumbs up · 11 comments opened 2026-10-13 · updated 2026-10-20
Claude Code medium open self-host/headless

Desktop auto-update ("stealth update") quits and relaunches the app while the user is away, dropping every Remote Control session

Claude Desktop 2.2553.1 (macOS 26.6.2, Apple Silicon) Bundled Claude Code 2.1.275 Remote Control in use daily from claude.ai/code while away from the machine When an update is staged, the app waits for a short idle window and then quits…

anthropics/claude-code#95364versions 2.2553.1, 2.1.275, 2.2553.0 14 thumbs up · 12 comments opened 2026-09-18 · updated 2026-10-23
Claude Code high fixed install/update

[BUG] Desktop 2.37337.1: “Group by” option removed from Code tab sidebar — sessions now only grouped by environment

Claude desktop app: 2.37337.1 Code tab sidebar After a recent update, the Code tab sidebar no longer groups sessions by project/repository. Sessions are now grouped only by environment: "This computer", "Cloud", SSH host (e.g. ubuntu@ )…

anthropics/claude-code#102088 46 thumbs up · 63 comments opened 2026-10-14 · updated 2026-10-19
Claude Code medium open auth/session

[BUG] Weekly limit 0% to 54% in 22h with same token volume that took 4.4 days to reach 60% the prior week

On Claude Max (20x), the weekly "all models" meter went from 0% to 54% in the first 22 hours after the weekly reset. My Claude Code token volume in those 22 hours was nearly identical to the same 22 hours of the previous week. The previous…

anthropics/claude-code#103376versions 4.4, 2.1.299, 2.1.303 12 thumbs up · 9 comments opened 2026-10-19 · updated 2026-10-25
Claude Code medium open always-on/daemon

Scheduled task (routine) runs no longer appear in the desktop sidebar or Remote Control

What I expect I run local scheduled tasks (routines) in Claude Desktop on my Mac. Each run used to show up as a normal session: in the desktop app's left sidebar, and in Remote Control on my phone, so I could open a run and continue it…

anthropics/claude-code#95967versions 2.1.278, 2.2553.1 13 thumbs up · 19 comments opened 2026-09-22 · updated 2026-10-21
Claude Code medium open install/update

[BUG] Desktop 2.37337.1: Code tab Routines section hidden after the sidebar update, reset to hidden on every launch

After updating the Claude desktop app, the Routines section is gone from the Code tab sidebar. My local routines still exist and still run on schedule; only the section is missing. The sidebar has no control to show it again. What I found…

anthropics/claude-code#102142versions 2.1.296 14 thumbs up · 21 comments opened 2026-10-14 · updated 2026-10-22
Claude Code high open self-host/headless

[BUG] Regression in 2.1.269: dictation-tool paste (clipboard + simulated Ctrl+V) not inserted in VS Code integrated terminal (WSL2) — 2.1.268 works

After auto-updating to 2.1.269, text inserted by a voice dictation tool (Wispr Flow — clipboard + simulated Ctrl+V) is no longer inserted into the Claude Code prompt when Claude Code runs in the VS Code integrated terminal (Remote-WSL)…

anthropics/claude-code#93782versions 2.1.269, 2.1.268, 1.6.827 9 thumbs up · 23 comments opened 2026-09-12 · updated 2026-10-07
Claude Code medium open self-host/headless

Mod ui.render (AbovePrompt/Pane) not drawn in desktop/iOS views of a Remote Control session

A mod's ui.render output (e.g. an AbovePrompt band with a Button) is drawn in the terminal but never appears in the Claude desktop app or the Claude iOS app when they view the same session through Remote Control. Only mod-initiated…

anthropics/claude-code#99217versions 2.1.287 11 thumbs up · 10 comments opened 2026-10-03 · updated 2026-10-22
Claude Code medium open mcp/tools

[BUG] MCP elicitation: capability is declared but requests are auto-declined ("print mode") in interactive VSCode sessions

In an interactive VSCode-extension session, Claude Code declares the MCP elicitation capability during initialize, but auto-declines every elicitation/create request without showing any UI. The same session can render permission prompts…

anthropics/claude-code#98256versions 2.1.284 16 thumbs up · 7 comments opened 2026-09-29 · updated 2026-10-16
Claude Code high open install/update

[BUG] Unable to switch off automatic worktree creation

Am I the only one no longer able to figure out how to switch off automatic work tree creation in the newest version. Updated to the latest claude code to do development on the desktop app and now it seems I'm forced into using worktrees?…

anthropics/claude-code#102412versions 2.1.206 9 thumbs up · 9 comments opened 2026-10-15 · updated 2026-10-22
Claude Code high open always-on/daemon

Desktop (Code tab): scheduled task runs no longer visible in the sidebar

After updating Claude Desktop, the Routines section disappeared from the Code tab sidebar. Previously every scheduled task run appeared there, so I could see at a glance which tasks ran, when, and whether they succeeded. Now there is no…

anthropics/claude-code#102677 4 thumbs up · 4 comments opened 2026-10-16 · updated 2026-10-25
Claude Code medium open auth/session

macOS: concurrent claude processes zero MCP OAuth entries in shared Keychain blob despite valid refresh tokens

On macOS, MCP OAuth entries in the shared Keychain item Claude Code-credentials get rewritten with empty accessToken/refreshToken (and no clientId) while the refresh tokens are still valid, when several claude processes touch the store…

anthropics/claude-code#93537versions 2.1.268, 2.1.206, 2.1.263 4 thumbs up · 5 comments opened 2026-09-11 · updated 2026-10-22
Claude Code high open install/update

[BUG] Artifact "Version history" removed from viewer menu across Claude Code, Cowork and claude.ai – saved versions unreachable (related to #95442)

Published artifacts no longer show a "Version history" option anywhere: not in the claude.ai web viewer's title menu, and not in the Claude desktop app's artifact side panel. Earlier versions are still being saved (each publish returns a…

anthropics/claude-code#96718 13 thumbs up · 9 comments opened 2026-09-24 · updated 2026-10-22
Claude Code medium open self-host/headless

[BUG] MCP client rejects valid tools/list response due to strict validation of ttlMs/cacheScope fields (Roblox Studio MCP server)

A user-configured stdio MCP server connects successfully (status: connected) but always reports toolcount: 0, across brand-new sessions, app restarts, and even a full OS reboot. The problem persists indefinitely — no retry ever recovers…

anthropics/claude-code#97319 6 thumbs up · 11 comments opened 2026-09-26 · updated 2026-09-27
Claude Code high open install/update

[BUG] Windows: main process survives beforeQuitForUpdate; relaunch blocked by single-instance lock (update deadlock, reproduced on two versions)

On Windows, the Claude Desktop app's stealth auto-update deadlocks. After an idle timeout, the app tears down its window and any running Claude Code sessions and logs beforeQuitForUpdate handler fired, going down for update, but the main…

anthropics/claude-code#96942versions 2.2553.13, 2.7032.0, 2.9939.2 3 thumbs up · 9 comments opened 2026-09-25 · updated 2026-10-25
Claude Code medium open install/update

[BUG] Windows: security-guidance's sg-python.sh launches `py -3` twice per hook; each launch of the Python Install Manager alias starts an AppX update that leaks ~1.6 MB in AppXSvc, exhausting system commit (21.8 GB in 12 h)

The security-guidance plugin (2.0.8) runs hooks/sg-python.sh on SessionStart, every UserPromptSubmit, every PostToolUse on Edit|Write|MultiEdit|NotebookEdit, PostToolUse on Bash, every Stop and every SubagentStop. On every one of those…

anthropics/claude-code#98929versions 1.6, 21.8, 2.0.8 4 thumbs up · 1 comments opened 2026-10-02 · updated 2026-10-23
Claude Code medium open always-on/daemon

Claude Desktop 3p + custom gateway (`ANTHROPIC_BASE_URL`): sandbox network pinned to gateway + api.anthropic.com, `sandbox.network.allowedDomains` ignored even after full app restart

Claude Desktop (enterprise 3p deployment, deploymentMode: "3p"), macOS (Apple Silicon), app 1.24012.1 Embedded Claude Code: 2.1.236 (second machine: 2.1.270), claude-desktop-3p entrypoint Inference: custom gateway via…

anthropics/claude-code#94758versions 2.1.236, 2.1.270 12 thumbs up · 0 comments opened 2026-09-16 · updated 2026-09-16
Claude Code high open self-host/headless

Remote Control: unarchived server-mode sessions are never re-dispatched to the running host — messages hang at "Sending…", then "Claude Code on <machine> is offline"

A session served by a long-running claude remote-control host (server mode, same-dir spawn) can't be used again after it's archived and then unarchived from claude.ai. The web UI accepts the unarchive, but a message sent to the session…

anthropics/claude-code#98310 3 thumbs up · 3 comments opened 2026-09-30 · updated 2026-10-25
Claude Code critical open install/update

[BUG][REGRESSION] Broken Projects upgrade wiped out classic projects with no no opt-out

This is not a cosmetic redesign. My classic claude.ai chat projects, which I used as sealed folders of separate private conversations with their own instructions, were converted to the coordinator-based Projects without my consent, without…

anthropics/claude-code#101369 4 thumbs up · 5 comments opened 2026-10-11 · updated 2026-10-24
Claude Code medium open self-host/headless

[BUG] Desktop: Remote Control drops on every idle session and can't be re-enabled until a message is sent from the Mac

In the Claude desktop app (Code tab), Remote Control only stays connected while a session's process is running. Once a session finishes its turn and goes idle, the app shuts its process down, and the Remote Control link drops with it. The…

anthropics/claude-code#102534versions 2.1.300 3 thumbs up · 3 comments opened 2026-10-15 · updated 2026-10-22
Claude Code high closed install/update

Desktop app: archived sessions can't be shown in the sidebar anymore

The filter button next to "+" at the top of the session list used to let you show archived sessions. After the update it doesn't. The only way to them now is "View All", which opens a whole separate panel listing every session. You archive…

anthropics/claude-code#102116 13 thumbs up · 12 comments opened 2026-10-14 · updated 2026-10-26
Claude Code medium open crash/hang

[BUG] macOS 12: Desktop app stuck on bundled Claude Code 2.1.260, Opus 5.5 greyed out — yet 2.1.280 lists this app's SDK wrapper (0.3.260) as tested while `stable` (2.1.267) does not

On macOS 12 (Monterey, Intel), the Desktop app's model picker shows Opus 5.5 greyed out with the tooltip "Update Claude to use this model on this computer", while the app's own update check reports "You're using the latest version." The…

anthropics/claude-code#96105versions 2.1.260, 2.1.280, 0.3.260 7 thumbs up · 6 comments opened 2026-09-22 · updated 2026-09-25
Claude Code high open install/update

[BUG] Claude in Chrome 1.0.94: side panel shows "Can't reach the Claude extension." in Vivaldi; classic side panel opt-out removed

This is about the Claude in Chrome browser extension, not the Claude Code CLI. In Vivaldi, the extension's new side panel (the embedded claude.ai Cowork interface) never works. It only shows: Up to extension 1.0.93, you could work around…

anthropics/claude-code#95975versions 1.0.93, 1.0.94 5 thumbs up · 5 comments opened 2026-09-22 · updated 2026-10-25
Claude Code high open install/update

[BUG] Regression of #86362 — Browser pane still blocks same-origin subresources (ERR_BLOCKED_BY_CLIENT) for hostnames resolving to 127.0.0.1

Windows 11 Pro 10.0.26100 Claude desktop app, UA: Claude/2.7032.0 Chrome/152.0.7977.130 (MSIX) Hostname mapped to 127.0.0.1 via the Windows hosts file, e.g. dev.example.test; IIS over HTTPS on 443 Repro (run in the pane's page context…

anthropics/claude-code#96508versions 10.0.26100, 3.7.1 4 thumbs up · 6 comments opened 2026-09-23 · updated 2026-10-20
Claude Code high closed crash/hang

MCP client rejects tool calls omitting optional parameters; deadlocks on tools with mutually-exclusive parameter groups

Every MCP tool call that omits an optional parameter is rejected with a Zod-style invalidtype / expected: "nonoptional", received: "undefined" error for that parameter — even though the tool's own JSON Schema declares a default for it…

anthropics/claude-code#94718versions 8.4.2, 8.4.3, 2026.9.2 7 thumbs up · 8 comments opened 2026-09-16 · updated 2026-10-11
Claude Code medium fixed self-host/headless

Claude Code webview blank in WSL after VS Code update, 401 on webview resources

After updating VS Code, the Claude Code panel is blank when connected to WSL (Ubuntu). The extension activates normally and authentication works (Output log shows no errors), but the webview fails to load its files: GET…

anthropics/claude-code#101865versions 2.1.296-linux, 2.1.296, 1.141.1 5 thumbs up · 2 comments opened 2026-10-13 · updated 2026-10-16
Claude Code medium open install/update

[BUG] Auto Mode classifier false positives in legitimate multi-agent repo workflow after recent Claude Code update

After updating Claude Code to the latest version in order to use Opus 5.5, Auto Mode started blocking legitimate, user-directed actions in an existing multi-session repository workflow. This workflow had been used repeatedly before the…

anthropics/claude-code#96662 3 thumbs up · 4 comments opened 2026-09-24 · updated 2026-10-13
Claude Code medium open self-host/headless

[BUG] Remote Control sessions not accessible from claude.ai/code without session-specific URL

Title: Remote Control sessions not accessible from claude.ai/code without session-specific URL The claude.ai/code landing page and the Code button in claude.ai both redirect to GitHub onboarding with no way to skip. This makes it…

anthropics/claude-code#97226versions 2.1.28 4 thumbs up · 1 comments opened 2026-09-25 · updated 2026-10-01
Claude Code medium open crash/hang

Session stuck showing "Can't reach your computer" when resuming existing conversation, while new conversations connect fine

When resuming an existing conversation in the Claude Code desktop app, the session gets stuck with: "Can't reach your computer — It may be asleep or offline. This session will reconnect when it's back." The message never clears while…

anthropics/claude-code#94229versions 10.0.19045 2 thumbs up · 2 comments opened 2026-09-14 · updated 2026-09-15