[BUG] Claude Code Desktop is crashing with new version
Preflight Checklist
- [x] I have searched existing issues and this hasn't been reported yet
- [x] This is a single bug report (please file separate reports for different bugs)
- [x] I am using the latest version of Claude Code
What's Wrong?
macOS version: 15.4.1
Claude Code Desktop version: 1.2581.0
Exact error: “BuddyBleTransport reportState - No handler registered”
Steps to reproduce (open app, crashes in 2 - 3 seconds)
When I open my Claude Desktop Claude Chat and Cowork works fine but when I click on Code it crashes the window, I am facing this problem starting today after upgrading my laptop to a new version as well upgrading claude to new version. Please let me know if you need any further information to replicate this error.
What Should Happen?
macOS version: 15.4.1
macOS version: 15.4.1
Claude Code Desktop version: 1.2581.0
Exact error: “BuddyBleTransport reportState - No handler registered”
Steps to reproduce (open app, crashes in 2 - 3 seconds)
When I open my Claude Desktop Claude Chat and Cowork works fine but when I click on Code it crashes the window, I am facing this problem starting today after upgrading my laptop to a new version as well upgrading claude to new version. Please let me know if you need any further information to replicate this error.
Error Messages/Logs
Exact error: “BuddyBleTransport reportState - No handler registered”
Steps to Reproduce
macOS version: 15.4.1
Claude Code Desktop version: 1.2581.0
Exact error: “BuddyBleTransport reportState - No handler registered”
Steps to reproduce (open app, crashes in 2 - 3 seconds)
When I open my Claude Desktop Claude Chat and Cowork works fine but when I click on Code it crashes the window, I am facing this problem starting today after upgrading my laptop to a new version as well upgrading claude to new version. Please let me know if you need any further information to replicate this error.
Claude Model
None
Is this a regression?
Yes, this worked in a previous version
Last Working Version
_No response_
Claude Code Version
Claude 1.2581.0 (f10398) 2026-04-14T17:16:40.000Z
Platform
Anthropic API
Operating System
macOS
Terminal/Shell
Terminal.app (macOS)
Additional Information
_No response_
18 Comments
Found 3 possible duplicate issues:
This issue will be automatically closed as a duplicate in 3 days.
🤖 Generated with Claude Code
Bug Report: Claude Desktop — Code Tab Causes OOM Crash on Launch
Summary
Claude Desktop crashes with a V8 JavaScript heap out-of-memory (OOM) error every time the Code tab is opened. The Chat and Cowork tabs work normally. The issue persists across macOS versions and clean reinstalls.
Environment
Steps to Reproduce
Error Log (from terminal launch)
The heap consistently maxes out at ~2697 MB regardless of configuration.
Troubleshooting Already Attempted
Key Observation
This strongly suggests the issue is isolated to the Code tab's initialization or data loading logic, not the Electron shell or rendering pipeline.
Expected Behavior
The Code tab should load and function normally without exceeding memory limits on a 16 GB machine.
Additional Notes
Prior to the crash, the ~/Library/Application Support/Claude/vm_bundles directory had accumulated ~10 GB of data, suggesting the Code module may not be cleaning up old VM bundles properly. Even after removing this directory and performing a completely clean install, the OOM crash persists.
Reproducing on macOS with Homebrew install
Environment:
Claude Desktop: 1.2581.0 (f10398) 2026-04-14T17:16:40.000Z
macOS: Apple Silicon (MacBook Pro)
Claude Code CLI: 2.1.109 (installed via npm + Homebrew Node 25.9.0)
CLI path: /opt/homebrew/bin/claude (symlinked to /usr/local/bin/claude)
Steps to reproduce:
Open Claude Desktop app
Click the "Code" tab/button
App immediately crashes
What happens:
App exits with SIGTRAP (signal 5) — confirmed via macOS Console logs. The crash reporter (chrome_crashpad_handler) attempts to capture a dump but is denied by AMFI: AMFI: Denying core dump for pid 15842 (Claude).
What I've tried:
Cleared ~/Library/Application Support/Claude and ~/Library/Caches/com.anthropic.claudefordesktop
Confirmed Claude Code CLI is installed and functional from terminal (claude --version returns 2.1.109)
Created symlink at /usr/local/bin/claude pointing to /opt/homebrew/bin/claude in case of PATH issue
Fresh reinstall of the desktop app
None of the above resolved the crash. Claude Code works fine directly from terminal.
Workaround: Use claude directly from terminal.
From the terminal it works fine, but I have the same error — I open it and the Claude app closes if I'm in Claude Code. In the normal chat it works without any problem.
Same issue unusable on Mac, no option to roll back no fix for so long
Same issue here. Claude Desktop 1.2581.0, crashes immediately when clicking on Code — Chat and Cowork work fine.
This is really frustrating because it completely breaks the workflow I'm paying for. I rely on Claude Code daily for an active project and having to work around this disrupts productivity significantly.
Looking forward to a fix.
Bug persists in v1.2773.0 (884b37), released 2026-04-15. Code tab still crashes immediately on selection. macOS 26.5 beta 2. Chat and Cowork work fine.
Bug persists in v1.2773.0 (884b37)
Auf #48281 einen 👍 geben und einen kurzen Kommentar posten: "Same issue on Windows 11 with v1.2581.0 (Desktop build f10398). Crash is silent, occurs ~60s after opening Code tab. See #48553 for full Windows details."
Yes, the issue still persists. I will unsubscribe to Claude.
Issue still persists on Claude Code after the latest update
Solution: Claude Desktop Crashes on Code Tab (OOM) — Root Cause Found
Summary
Claude Desktop crashes immediately when switching to the Code tab, while Chat and Cowork tabs work normally. The root cause is not a bug in the desktop app itself, but oversized transcript files under
~/.claude/projects/that cause the V8 JavaScript heap to run out of memory (OOM) during Code tab initialization.Environment
~/Library/Logs/DiagnosticReports/.Root Cause
The Code tab scans all transcript files under
~/.claude/projects/on startup. If a single session has accumulated a very large.jsonltranscript (especially sessions with many embedded base64 images such as PDF page screenshots), the file can grow to multiple gigabytes. Loading it into memory exceeds V8's heap limit (~2.7 GB by default) and crashes the app.Diagnosis Steps
1. Confirm the OOM error
App logs under
~/Library/Logs/Claude/typically show nothing useful. To capture the real error, launch Claude from the terminal:Click the Code tab, wait for the crash, then check stderr:
You should see something like:
The heap consistently maxing out around ~2.7 GB confirms the OOM.
2. Locate the oversized transcript files
In one confirmed case, a single
.jsonlfile was 17 GB, containing ~70,000 base64-encoded images from a session that ran continuously for 30 days.Solution
Move the oversized transcript files out of
~/.claude/(don't delete directly, in case you need them later):Restart Claude Desktop. The Code tab should now load normally.
Once you confirm everything works, you can delete the archived files to free up disk space.
What Does NOT Fix It
These common troubleshooting steps will not resolve this issue because the problem is in
~/.claude/, not in the app's own data directory:~/Library/Application Support/Claude/(Cache, GPUCache, Local Storage, etc.)vm_bundlesdirectory--disable-gpu,--use-gl=swiftshader, etc.)NODE_OPTIONS="--max-old-space-size=8192"(Electron ignores this)Prevention
~/.claude/size regularly:``
bash
``du -sh ~/.claude/
Tips for Debugging Similar Crashes
When Claude Desktop crashes without any visible error:
~/.claude/directory size — if it's unexpectedly large (tens of GB), transcript bloat is likely the cause..jsonlfiles over 100 MB withfind ~/.claude -name "*.jsonl" -size +100M.---
Hope this helps others running into the same issue. Credit to the community members who traced it down to the transcript file size.
Thank you I could fix my issue thanks to you. I had the CLI move things for me.
Fix: archive oversized transcripts in
~/.claude/In Terminal, check for large transcript files:
If you see multi-GB
.jsonlfiles, quit Claude Desktop and archive the folder containing them:Relaunch Claude Desktop. The Code tab should load normally with
"sidebarMode": "code"restored in~/Library/Application Support/Claude/claude_desktop_config.json.Written by Claude .
Confirming this bug on Windows 11 x64 — the
platform:macoslabel should be broadened.Environment
| Field | Value |
|---|---|
| OS | Windows 11 x64 (not ARM64) |
| Claude Desktop | 1.3883.0 (current as of 2026-04-24) |
| Last known good | 1.3561.0 (installed side-by-side in
%LOCALAPPDATA%\AnthropicClaude\app-1.3561.0\) || Plan | Max |
Reproduction
5 renderer crashes in 12 hours (3 within one hour of active use), each correlating 1:1 with an entry in
%APPDATA%\Claude\logs\claude.ai-web.log:<details>
<summary>Crash log excerpt (timestamps + IPC error)</summary>
Each entry is followed by a
cleanupVMBundleIfUnsupportedsequence incowork_vm_node.log, indicating the renderer was torn down and re-initialized.</details>
Diagnostic findings (Windows)
Crashpad/reports/folder is empty — Electron does not dump renderer crashes of this kind, which is why no native crash report is filed.claude.exein the last 24 h — this is not a hard OS-level crash, it's an unhandled promise rejection inside the renderer.HypervisorPlatform, andVirtualMachinePlatformare all enabled on the host, so the virtualization stack is not the cause.yukonSilver not supportedlog line incowork_vm_node.logis unrelated noise (feature is intentionally disabled on this config).Workaround (confirmed)
Downgrading to 1.3561.0 eliminates the crashes:
Previous versions are preserved by Squirrel under
%LOCALAPPDATA%\AnthropicClaude\app-*\after auto-update.Pattern (cross-reference)
This looks like the same class of bug as:
BuddyBleTransport_$_reportStateerror, co-occurring with V8 OOM on macOS 1.2581.0ComputerUseTcc_$_getState— "No handler registered") is the identical pattern on Windows 1.1.7714.0 during the Cowork persistent-thread rolloutIn all three cases, the renderer bundle calls an
@electron/remote-style IPC method that the main process never registers, producing an unhandled promise rejection that kills the renderer.Request
platform:windows— the root cause is platform-agnostic.claude.buddy/BuddyBleTransportfeature is not shipped on the renderer for all users yet, gating the frontend call-site behind a feature flag (or aif (ipcRenderer.has(...))guard) would stop the bleeding without waiting for the handler to be wired up on every platform.Happy to provide the full
claude.ai-web.log,main.log, andcowork_vm_node.logbundle via the in-app "Send feedback" flow if helpful — let me know and I'll attach with a reference to this issue number.Per Anthropic Support's suggestion, I filed a Windows-specific sibling report with the same root-cause analysis and additional Windows-only diagnostics: #52738.
Cross-linking so triagers can fold them together (or apply
platform:windowshere) — the underlying missing-IPC-handler is clearly platform-agnostic.Confirming the fix works for a related crash trigger (worktree-session SIGTRAP, not just the Code tab)
The accepted fix in this thread — archive oversized
~/.claude/projects/*.jsonltranscripts — also resolves a different surface symptom of the same underlying bug. Posting in case it helps others searching for it.My symptom
Claude Desktop 1.4758.0 on macOS, renderer crashing 7 times in ~7 hours with
Main webview render process gone, exitCode: 5(SIGTRAP). My Code tab worked fine — crashes happened when opening a session inside an existing.claude/worktrees/<name>directory. Every crash was preceded within 1–2 seconds byLocalSessions.getPrStateForBranchagainst that worktree path. Filed separately as #54369.Why this thread's fix applies
Same renderer OOM, just hit through a different code path. Both this issue's "click Code tab" and my "open worktree session" funnel into the same renderer that loads project transcripts from
~/.claude/projects/, and both hit the V8 ~2.7 GB heap ceiling when the project has accumulated large.jsonlfiles.My data before applying the fix
~/.claude/projects/total: ~1.5 GB.jsonlfiles in the 15–51 MB range; thousands of small files summing into the danger zoneNot as extreme as the 17 GB case originally documented here, but still enough to OOM the renderer.
Fix applied
Two-pass archive of
~/.claude/projects/to a backup folder outside~/.claude/:.jsonlolder than 14 days regardless of size — 3,294 files, ~896 MB.After:
~/.claude/projects/= ~371 MB (75% reduction). Largest project = ~129 MB. Restarted Claude Desktop. The previously-crashing worktrees now open cleanly. No SIGTRAP since.Practical takeaway for others hitting this on newer builds
If you are on a recent Claude Desktop (e.g. 1.4758.0+) and seeing
exitCode: 5/ SIGTRAP renderer crashes that the rest of this thread's "click the Code tab" repro doesn't quite match, still checkdu -sh ~/.claude/projects/first. If it is anywhere north of ~500 MB on a single project, the fix here (archive, don't delete) is highly likely to resolve it regardless of whether your trigger is the Code tab or worktree session opening.Getting an immediate fix for this in Thursday's desktop release.
Still having the same issue in the MacOS Desktop Client on version Claude 1.9659.4 (8cc655) 2026-06-02T02:30:57.000Z.