-
Notifications
You must be signed in to change notification settings - Fork 106
Description
Issue: Claude Code (CC v2.0.42) Does Not Appear to Follow Documented IDE Protocol
We are attempting to integrate with or debug the Claude Code extension (v2.0.42) using the official IDE protocol specification , which states that communication between the IDE and the Claude backend should occur over WebSocket on localhost:61022.
However, our observations suggest that no network activity is occurring on this port, indicating a possible deviation from the documented protocol or a failure in the local server component.
🔍 Observations
Lock file exists The expected lock file is present, suggesting the IDE integration subsystem initialized:
$ ls .claude/ide/
61022.lockThis implies the extension intended to use port 61022. No listening or established sockets for the Claude process
We identified the PID of the Claude Code backend process (CC-PID) and checked for active network connections:
$ sudo ss -tnp | grep "pid=CC-PID"
# (no output)
61022.lockNo TCP sockets (listening or connected) are associated with the process.
No traffic on loopback port 61022
We monitored the loopback interface for any packets on port 61022:
$ sudo tshark -i lo -f "port 61022" -n
# (no packets captured, even during IDE interaction)Confirms no WebSocket or TCP traffic is being sent or received.
Log output also shows "no handshake" errors With log_level = "trace", the logs repeatedly report:
:messages
[ClaudeCode] [server] [DEBUG] Starting WebSocket server with authentication enabled
[ClaudeCode] [server] [DEBUG] Auth token length: 36
[ClaudeCode] [terminal] [DEBUG] Focus toggle: creating new terminal
[ClaudeCode] [queue] [DEBUG] Queued @ mention: /home/xxxx (queue size: 1)
[ClaudeCode] [ClaudeCodeSend] [DEBUG] Queued @ mention and launched Claude Code: /home/xxxx
[ClaudeCode] [selection] [DEBUG] Visual selection sent as at-mention.
[ClaudeCode] [queue] [DEBUG] Clearing 1 queued @ mentions
env
- NVIM v0.11.4 Build type: RelWithDebInfo LuaJIT 2.1.1760617492
- https://github.com/coder/claudecode.nvim branch main commit 1552086
- 2.0.42 (Claude Code)
- OS Arch linux
ref #70