Skip to content

[BUG] Claude Code (CC v2.0.42) Does Not Appear to Follow Documented IDE Protocol #156

@jiahaoxiang2000

Description

@jiahaoxiang2000

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.lock

This 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.lock

No 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

ref #70

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions