›_ Claude Code Issues
Claude Code Issues / #23119

[BUG] IDE integration broken in v2.1.23+ - MCP server never connects - Affects Jetbrains IDEs on Windows

Status Fixed / completed
Reported on v2.1.20
Maintainer reply None cached
Workaround ✓ Mentioned in thread ↓
Activity 12 comments · opened Feb 4, 2026 · closed Feb 11, 2026

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?

CLion-Claude Code Integration - Windows Regression Bug Report

Date: 2026-02-04
Regression Introduced: v2.1.23
Last Working Version: v2.1.22
CLion Plugin Version: 0.1.14-beta
Platform: Windows 11 (PowerShell terminal)
Note: This issue is Windows-specific - the same setup works correctly on macOS.

Summary

IDE integration is broken in Claude Code v2.1.31 (and v2.1.29) on Windows. The IDE MCP server never attempts to connect, despite environment variables being correctly set.

Verified: Downgrading to v2.1.20 via npm restores IDE integration functionality.

Verified: Subsequent Upgrade to v2.1.23 via npm results in broken IDE integration functionality again.

Symptoms

  1. /ide command shows no IDEs to connect to (v2.1.31)
  2. CLion plugin shows "Cannot launch Claude Code" error
  3. Code changes only appear in terminal, not in CLion diff views
  4. Shift+Enter does not create new lines in prompt (v2.1.31 native installer)

Confirmed Working vs Broken

| Version | Install Method | IDE Connection | Shift+Enter |
|---------|----------------|----------------|-------------|
| 2.1.20 | npm | ✅ Working | ✅ Working |
| 2.1.22 | npm | ✅ Working | ✅ Working |
| 2.1.23 | npm | ❌ Broken | ❌ Broken |
| 2.1.29 | native (irm) | ❌ Broken | ❌ Broken |
| 2.1.31 | native (irm) | ❌ Broken | ❌ Broken |

Workaround

Install v2.1.22 via npm instead of using the native installer:

# Remove or rename native binary
mv $env:USERPROFILE\.local\bin\claude.exe $env:USERPROFILE\.local\bin\claude.exe.bak

# Install working version via npm
npm install -g @anthropic-ai/claude-code@2.1.22

Architecture Overview

How IDE Integration Should Work

┌────────────────────────────────────────────────────────────────┐
│ CLion + Claude Code Plugin (com.anthropic.code.plugin)         │
│                                                                │
│  1. Plugin starts WebSocket server on port (e.g., 62282)       │
│  2. When opening terminal, plugin sets environment variables:  │
│     - CLAUDE_CODE_SSE_PORT=62282                               │
│     - ENABLE_IDE_INTEGRATION=true                              │
│     - TERMINAL_EMULATOR=JetBrains-JediTerm                     │
│                                                                │
│  3. Plugin creates "Claude Code" terminal tab and runs `claude`│
└────────────────────────────────────────────────────────────────┘
                              ↕ WebSocket (authenticated)
┌────────────────────────────────────────────────────────────────┐
│ Claude Code CLI (running in terminal)                          │
│                                                                │
│  1. Detects ENABLE_IDE_INTEGRATION=true                        │
│  2. Writes lock file: ~/.claude/ide/<port>.lock                │
│     (contains: workspace, PID, transport, authToken)           │
│  3. Connects to plugin's WebSocket server as MCP server "ide"  │
│  4. Enables: diff views, diagnostics, file open, etc.          │
└────────────────────────────────────────────────────────────────┘

Environment Variables (set by CLion plugin)

| Variable | Purpose |
|----------|---------|
| CLAUDE_CODE_SSE_PORT | Port number for WebSocket/SSE server |
| ENABLE_IDE_INTEGRATION | Enables IDE integration features |
| TERMINAL_EMULATOR | Identifies terminal type (JetBrains-JediTerm) |
| TERM_SESSION_ID | Unique session identifier |

Debug Evidence (from logs)

Working Session (v2.1.20, npm)

MCP server "ide": Starting connection with timeout of 30000ms
MCP server "ide": Successfully connected to ws-ide server in 202ms
MCP server "ide": Connection established with capabilities: {"hasTools":true,...}

Broken Session (v2.1.31, native installer)

  • No "MCP server ide" entries in debug log
  • Environment variables ARE set correctly
  • Lock file IS created with valid content
  • WebSocket port IS listening (CLion process)

The CLI never attempts to connect to the IDE MCP server.

Environment Details

  • OS: Windows 11
  • Primary Shell: PowerShell (CLion terminal launches PowerShell by default)
  • Subagent Shell: Git Bash (Claude Code spawns subagents in Git Bash)
  • Native Claude Location: %USERPROFILE%\.local\bin\claude.exe
  • PATH: Correctly includes .local\bin in system PATH

The CLion plugin correctly:

  • Sets environment variables in terminal sessions
  • Runs WebSocket server on allocated port
  • Includes claude.exe location in PATH passed to terminal

Troubleshooting Steps Attempted

  1. ✅ Disabled WSL integration in plugin settings
  2. ✅ Cleared %USERPROFILE%\.claude\ide\ lock files
  3. ✅ Verified environment variables are set
  4. ✅ Verified WebSocket port is listening
  5. ✅ Verified claude.exe is in PATH
  6. ✅ Checked CLion logs for errors
  7. ✅ Restarted CLion completely
  8. ✅ Downgraded to v2.1.20 via npm - FIXED the issue
  9. ✅ Bisected using npm to find latest working version / first with issue.

File Locations (Windows)

| Item | Path |
|------|------|
| Native Binary | %USERPROFILE%\.local\bin\claude.exe |
| Lock Files | %USERPROFILE%\.claude\ide\ |
| Debug Logs | %USERPROFILE%\.claude\debug\ |
| Plugin JAR | %APPDATA%\JetBrains\CLion<version>\plugins\claude-code-jetbrains-plugin\lib\ |
| Plugin Settings | %APPDATA%\JetBrains\CLion<version>\options\claude-code-plugin-settings.xml |
| CLion Logs | %LOCALAPPDATA%\JetBrains\CLion<version>\log\idea.log |

Debug Log Analysis

To investigate, search debug logs at %USERPROFILE%\.claude\debug\<session-id>.txt for:

  • MCP server "ide" - IDE connection attempts (missing in broken versions)
  • ws-ide - WebSocket IDE connection
  • ENABLE_IDE - Environment detection

Plugin Settings Reference

Located at: %APPDATA%\JetBrains\CLion<version>\options\claude-code-plugin-settings.xml

<application>
  <component name="ClaudeCodePluginSettings">
    <option name="enableWindowsDriveMapping" value="false" />
    <option name="enableWslLocalhostMapping" value="false" />
  </component>
</application>

Related to bugs #22232 , #22774

What Should Happen?

  1. /ide command should show no IDEs to connect to
  2. CLion plugin should not show "Cannot launch Claude Code" error
  3. Code changes should appear in CLion diff views
  4. Shift+Enter should create new lines in prompt

Error Messages/Logs

Steps to Reproduce

On Windows with any Claude version 2.1.23 onwards, use a jetbrains IDE to open Claude.
Once open you will see a warning about Cannot launch claude code (despite it having run).
/ide will show that there is no ide detected.

Claude Model

None

Is this a regression?

Yes, this worked in a previous version

Last Working Version

2.1.22

Claude Code Version

2.1.31

Platform

Anthropic API

Operating System

Windows

Terminal/Shell

PowerShell

Additional Information

_No response_

View original on GitHub ↗

12 Comments

gabrieljcs · 6 months ago

What are the odds the first time I tried using this MCP it's broken... thank you so much for reporting, I was losing my mind.

GameDevUmut · 6 months ago

I have the same problem with JetBrains Rider + Claude Code 0.1.14-beta plugin. I use Windows 11.
I downgraded my Claude Code version to v2.1.22, and it's solved for now. Thanks for stating the last working version.
We need a fix for this issue.

prd-ionelv · 6 months ago

When I click the Claude button in the IDE, I get the error message:
Cannot launch Claude Code
Please ensure Claude Code is installed and the 'claude' command is in your system path.

When i type /ide in the Claude terminal i get the message:
No available IDEs detected. Please install the plugin and restart your IDE

JetBrains Intellij IDEA 2025.3.2 + Claude Code 0.1.14-beta plugin. I use Windows 11.

daveelton · 6 months ago
When I click the Claude button in the IDE, I get the error message: Cannot launch Claude Code Please ensure Claude Code is installed and the 'claude' command is in your system path.

Did the workaround (rollback) get it working again?

It's a regression in 2.1.23 - I'm guessing none of the Claude team use Windows + MCP server "ide" or they would have noticed by now.

lemonroti · 6 months ago

using vs code , and facing the same issue as well. No ide detected , i am wondering this is bug or my issue

daveelton · 6 months ago
using vs code , and facing the same issue as well. No ide detected , i am wondering this is bug or my issue

Make sure claudeCode.useTerminal = false in the settings - it only uses mcp "IDE" if that is true.
Otherwise https://marketplace.visualstudio.com/items?itemName=anthropic.claude-code has it's own integration

lemonroti · 6 months ago

i already untick it by default and using the terminal , still same issue , for the extension it working , when i use terminal , it has same issue , old version does not produce this issue

> using vs code , and facing the same issue as well. No ide detected , i am wondering this is bug or my issue Make sure claudeCode.useTerminal = false in the settings - it only uses mcp "IDE" if that is true. Otherwise https://marketplace.visualstudio.com/items?itemName=anthropic.claude-code has it's own integration
lemonroti · 6 months ago

does this issue resolve already ? i am in the v2.1.25 still facing the same issue

daveelton · 6 months ago

This is not fixed in the current version (2.1.37)

If you want to use this version of claude (e.g. for Opus 4.6) then I have found that adding the following to your ~/.claude/CLAUDE.md file and using jetbrain own AI Chat (with Claude Agent) INSTEAD of the claude icon terminal interface is passable.

  1. Add this to your ~/.claude/CLAUDE.md file
# Windows IDE Integration Workaround

The JetBrains MCP server should be preferred for file operations on this machine
(workaround for https://github.com/anthropics/claude-code/issues/23119):

- Use `mcp__jetbrains__get_file_text_by_path` for reading files
- Use `mcp__jetbrains__search_in_files_by_text` / `search_in_files_by_regex` for searching
- Use `mcp__jetbrains__build_project` after edits to validate
- Use `mcp__jetbrains__open_file_in_editor` to show relevant files
- Use `mcp__jetbrains__get_file_problems` to check for errors in modified files
  1. Enable the AI Chat button in Clion or other Jetbrains IDE - this may ask you to install another jetbrains plugin as part of setup, this is expected.
  2. Make sure you pick the Claude Agent mode if you want anthropic models, this should log into your Anthropic account and use those allowances. I've not tested with API allowances.

Ask it to make a trivial change and if you've got it right you should see a diff type code merge again.

Good luck.

lemonroti · 6 months ago

just to update , the latest claude version are work again

2.1.38 (Claude Code)

daveelton · 6 months ago

I can confirm that this is resolved on my system too. (tested in 2.1.39)

To check your workarounds have been removed run claude install from the command line (to revert from npm to native install) and then once inside claude use the /context command to check that any unnecessary mcps have been removed from your claude config files.

github-actions[bot] · 6 months ago

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.

Related Claude Code issues

Matched on shared title terms, labels, topic and reported release — ranked so issues with real discussion come first.

Browse by topic

This issue appears in the ranked issue list on these topic pages, alongside a backlog trend for the whole topic.

MCP server connection issues →Installation & update problems →

Same class of failure, ranked by community engagement — this issue is one of many, so it may not appear in the visible list: IDE & terminal integration, Windows & WSL problems

Browse all Claude Code issue topics →