[BUG] Claude Code extension webview tab restoration hangs Cursor IDE on workspace startup
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?
The Claude Code extension for Cursor (anthropic.claude-code) hangs Cursor's renderer process when Cursor attempts to restore previously open Claude Code editor tabs at workspace startup. The same extension, with the same session data, restores cleanly in VS Code — this is a Cursor-specific interaction, but I'm filing here as well in case the extension can mitigate from its side or coordinate with Cursor on a fix.
Cursor forum threads with detailed analysis:
- https://forum.cursor.com/t/claude-code-tabs-cause-cursor-to-freeze-on-startup-stuck-loading/155722/18
- https://forum.cursor.com/t/extension-host-fails-to-initialize-timeout-waiting-for-auth-and-plugins-breaking-ai-agents-and-source-control/158539
Root cause (per Sanskar's analysis in the linked Cursor thread): the hang occurs in Cursor's registerWebviewPanelSerializer restore path for claudeVSCodePanel panels, before the extension's deserializeWebviewPanel handler executes. Even patching the handler to immediately dispose the panel doesn't prevent the hang.
Workarounds:
- In-session: close the Claude Code tabs while Cursor is hung; the extension host completes activation within seconds.
- Preventive: close Claude Code tabs before quitting Cursor.
- Heavy-handed: delete the workspace's state.vscdb or remove claudeVSCodePanel entries from memento/workbench.parts.editor.
Possible mitigations on the extension side:
- Defer or guard webview panel serializer registration so restoration never blocks the renderer.
- Detect Cursor as the host and disable webview tab persistence until the upstream issue is fixed.
Environment:
- Cursor 3.2.16 (also reproduced on 3.0.12, 3.2.11)
- macOS Apple Silicon, also reported on Windows
- Claude Code extension 2.1.126 (and possibly earlier versions)
This bug has had an active Cursor forum thread for over a month with multiple users affected. Filing here for cross-team visibility.
What Should Happen?
Cursor should open and load in Claude Code open chats in the open claude code extension tabs.
Error Messages/Logs
Steps to Reproduce
- Open a project in Cursor with the Claude Code extension installed.
- Open a Claude Code session as an editor tab (not the sidebar).
- Quit Cursor with that tab still open.
- Reopen the project. Cursor hangs on startup — terminal, extensions, settings all become non-functional. Dev tools console shows extension host health-check failure, auth ready timeout, and No Connect transport provider registered cascades.
Claude Model
Opus
Is this a regression?
I don't know
Last Working Version
_No response_
Claude Code Version
VSCode/Cursor extension (anthropic.claude-code): 2.1.126
Platform
Anthropic API
Operating System
macOS
Terminal/Shell
Other
Additional Information
_No response_
4 Comments
Found 3 possible duplicate issues:
This issue will be automatically closed as a duplicate in 3 days.
🤖 Generated with Claude Code
Closing for now — inactive for too long. Please open a new issue if this is still relevant.
macOS, Cursor 3.6.31, recurring intermittent renderer hang that I saw in Terminal and any jupyter notebook tabs, error appeared mid-session not at startup, fixed by uninstalling anthropic.claude-code extension despite never opening any Claude Code panels or tabs.
This issue has been automatically locked since it was closed and has not had any activity for 7 days. If you're experiencing a similar issue, please file a new issue and reference this one if it's relevant.