[BUG] Claude Code does not detect Jetbrains IDE on Windows WSL
Resolved 💬 113 comments Opened May 22, 2025 by masda70 Closed Aug 23, 2025
💡 Likely answer: A maintainer (hackyon-anthropic, collaborator)
responded on this thread — see the highlighted reply below.
Environment
- Platform (select one):
- [X] Anthropic API
- [ ] AWS Bedrock
- [ ] Google Vertex AI
- [ ] Other: <!-- specify -->
- Claude CLI version: 1.0.0
- Operating System: Windows 10 - WSL 2.2.4.0 with Ubuntu 22.04
- Terminal: bash over WSL launched from Powershell 7
Bug Description
Jetbrains / PyCharm integration with Claude using the new Claude Code 0.1.3-beta plugin does not work
Steps to Reproduce
- Install claude on WSL
- Isntall Claude Code plugin on Jetbrains
- run Claude Code from Jetbrains
- run /config , and /ide commands within Claude Code
- let Claude Code edit files
- Restart multiple times IntelliJ as per the docs https://docs.anthropic.com/en/docs/claude-code/ide-integrations
- Repeat tests
Expected Behavior
/config -> Set the diff tool to auto for automatic IDE detection
/ide -> should command show integration with Jetbrains
Claude should show "Opened changes in IntelliJ..." when editing files and IntelliJ should display the diff
Actual Behavior
/config -> there are no "diff tool" settings
/ide command returns "No available IDEs detected. Make sure your IDE has the Claude Code extension or plugin installed and is running."
Let Claude Code edit files -> Changes are shown on the Claude Code's terminal
Additional Context
N/A
113 Comments
Thanks for the report, will take a look!
even jetbrains with their own ai agent "junie" do not support WSL2, I mean.. who cares that most developers on this planet use windows... crazy.... 🤷
Same problem here.
Is there any version of this plugin that actually works with Windows WSL?
A little bigger miss here - junie runs in Windows so you could still use it - claude code on windows means WSL - so this a strange miss to not at least note...
It's Irrelevant, fact is: both have not (well, or not at all) tested an environment, that most windows web developers are using, and that is extremely hard to understand, at least for me. It's more important to spin up the marketing Maschine, release first, fix later... With that attitude, of course, nobody cares about these pseudo apple users using a strange Virtualization. Let's be honest, it's our fault, we should have switched to Linux/Mac a long time ago 😏 now we have to live with the consequences constantly being ignored whenever someone releases something (cool) for jetbrains, nobody wants to deal with that stupid WSL2 thing. 😁
Thanks for the report and patience. We're actively working on fixing this!
@hackyon-anthropic thanks a lot for your work
Could you take on the VSCode issue as well?
https://github.com/anthropics/claude-code/issues/1276
Same issue on Mac - /ide shows none, typing "claude" into the integrated terminal in VSCode or Cursor doesn't connect to the ide.
<img width="708" alt="Image" src="https://github.com/user-attachments/assets/a0d6def3-f7fd-4835-9577-e0d06043fc90" />
We've released an updated plugin (v0.1.6-beta) that should address some of the issues with WSL! It should work with the latest Claude Code release v1.0.6
Steps:
wsl -d Ubuntu) or equivalentclaude/idecommand to select the running IDE to usePlease let me know if you're running into any issuee! Thanks!
Is this issue also addressing the fact that you can not give claude code images while served in WSL ?
Sill not working for me
!Image
!Image
@poppabear8883 don´t start CC in a regular windows WSL2, click the icon inside phpstorm (top right) so phpstorm opens a terminal inside phpstorm - and there CC will be started automatically.
!Image
Yes I have tried it that way as well, the
/idestill is not connecting ... and the reason i don't use that method typically is because you can not useescwhen in the embedded JB terminal, it simple just switches focus to the editor and doesn't send theescsignal to the terminal.!Image
Thanks @poppabear8883.
From within your WSL environment, can you check if the
/mnt/c/Users/[YourWindowsUser]/.claudedirectory exists? This is where we save the plugin metadata for the plugin connection.Cool, thanks for the info. This is super useful, and we're looking into it now!
I have both catalogues :
/mnt/c/Users/[user_name]/.claude$ ls
ide
_always empty_
and in wsl:
~/.claude/ide$ ls
55399.lock
_visible when Cursor is open._
JetBrains doesn't work.
Cursors works and configuration is under wsl.
Same here. In the logs I can see claude starting from the plugin with
diff_envs={CLAUDE_CODE_SSE_PORT=50101, ENABLE_IDE_INTEGRATION=true, ...}, but theidedirectory is empty and nothing shows in claude. Let me know if you need anymore info. Same for 1.0.6 and 1.0.7Same: plugin 1.0.6, claude code 1.0.6, terminal on
wsl.exe -d Ubuntu, shell aszsh, claude launched with the asterisk button:the
.claude/idefolder is empty both when read from ubuntu or windows.Note, for people trying to at least make something work, this is how you can get
Escto work to stop the current gen/exit menus:Uncheck this option:
!Image
I finally made it work on Windows by installing WSL Extension in Visual Studia Code.
Previously I just ran
code .from WSL but Claude didn't recognize IDE. Now after installing WSL extension VSC opens "in Linux mode" (all paths are /mnt/c/... and CC finally can find IDE:!Image
Just a note: I actually tried launching PyCharm from WSL when it didn't working launching from Windows originally, and I didn't really test anything out thoroughly, but the IDE was detected. I doubt many run that way, but just to note, that may already work.
For older versions of jetbrains or as an alternative way, this also achieves this and additionally allows rebinding if you still want to be able to switch to the editor with your keyboard (from the plugin reviews):
---
Sadly this does not work for me in goland 2025.1.1. or pycharm 2025.1.1.1. Must be some subtle difference between our machines. Sounds like a nightmare to debug. Maybe can you specify what you mean by "running from wsl"? Just starting it from the wsl console, so just
pycharm?I got it to work. At least in my case, I had to have claude already opened in a terminal BEFORE opening the ide. Then starting the IDE, then doing /ide in claude.
I can also see a file in the
.idedirectory now:I think the IDE extension is correctly creating the lock file but claude deletes it on startup. Having claude already running when the file is created seems to work around this.
Edit: Well at least the initial connection from Claude Code works, it is still very unstable during usage however.
Edit2: Funnily enough I can get claude code to connect from the IDEs terminal by starting the ide, waiting for the lockfile to be created, setting the
idedirectory to readonly, then starting claude via the extension-button. Doesn't stay connected though.Edit3:
<details>
<summary>Stacktrace</summary>
</details>
jetbrains plugins + WSL2 = always a FAIL
jetbrains junie: FAILED
claude code: FAILED
continuedev/continue: FAILED
while one single developer was able to solve such problems in less than a month... 🤷
Fixed spelling: i´m not a kotlin/java developer, but I have a hard time understanding why a simple mapping takes ages to fix 😞
@YetiCGN Thanks for pointing out my lack of English skills 🙏
You're coming across pretty arrogant and demanding, Micha. By the way, "ich tu mich schwer mit..." is not "I do myself hard" ...
Thanks for the feedback. We're doing our best on this and hope to have it fixed asap!
We understand it can be frustrating at times, and we appreciate your patience while we iron out the issues!
I can only get Rider to show up in /ide if I run claude code before i open Rider. Then I can select Rider from /ide, but it simply says IDE disconnected.
!Image
Just want to plus 1 and say I am getting the same experience with using Rider on windows and Claude Code via WSL2 terminal. I believe WSL is the only supported way to use Claude Code on windows right?
I have tried some of the solutions proposed here re: making a .wslconfig and setting registry keys and did not have any luck with them. As some other users have mentioned, I have been able to momentarily get claude code to find an ide via /ide, assuming I have launch claude code before launching my IDE - but I also find that it immediately says it is disconnected and doesn't seem to work, so I am not sure if I ever truly get connected with it.
Thanks so much as it seems like you are prioritizing a fix. I am curious if there is any way to run Claude Code outside WSL on windows since this does kinda seem like a WSL sandboxing thing.
Plus 1'ing here too, having the same experience with PHPStorm and wsl on claude code 1.0.9
I see this issue also with IntelliJ Ultimate on Windows 11. Claude Code cannot connect to the IDE according to a balloon notification in IntelliJ and the IDE is not listed when running
/ideinside Claude.Plugin Version: 0.1.7-beta
Claude Code Version: 1.0.10
Recreation Steps:
1) Open IntelliJ
2) In my home folder's
.claudefolder anidefolder is created containing a lock file.3) Click the Claude icon
4) The WSL terminal opens and launches Claude
5) The lock file is deleted from the
idefolder._Solved_ 😄
After installing WSL ubuntu (or your favorite flavor), go into JetBrains IDE -> Settings -> Tools -> Terminal. Under "Application Settings", there's a dropdown with all terminals installed on your system. I selected "wsl.exe -d Ubuntu". Restart IDE and _poof_, clicking Cluade icon now opens WSL in the terminal window.
Note: the "/ide" command doesn't seem to work, but I don't know it's needed, since it's obviously working with the IDE.
Maybe just update your documentation? 😎
When you (@lelandg) say it is obviously working with the IDE what do you mean? What features should be working because when I see IDE Disconnected I assume the plugin is not working.
That's what I wrote in my review, but without IDE integration all you have is a shortcut to invoke Claude Code, which is pointless.
So until this is fixed I wouldn't say it's _solved_.
If I can help in any way troubleshooting this issue, just let me know how.
Oh, I see. I guess you're right. I stand corrected. However, it will run stuff. I mean, when I run "/init", it is working. And I think "claude doctor" is (not tested yet, but after init, it has worked before).
In retrospect, I don't know what features we should have in the IDE. So I don't know it's working. Therefore, my apologies for that.
When the ide is connected, Claude is able to see which files are currently opened in the editor to use as context, its also able to see any selected text in the editor to use as context. This is just a few of the additional features we get with a properly connected IDE!
My hope is additionally, When the claude team is able to understand the disconnect between Windows and WSL in regards to Claude that it will also come with a fix for being able to paste/drag images into the WSL CLI for claude (as this does not work either)
I love Claude Code, but use of WSL feels like a horrific kludge which is never going to work smoothly. I'm hoping it's a stopgap that will very soon disappear entirely, in favour of fully native Windows support.
On 4 June 2025 16:29:27 BST, "Everett (Mike) Wiley" @.***> wrote:
And I wish people would spend their time more wisely instead of trying to build some half-working hack at all costs, something that probably won’t even work anymore by the time this is finally fixed. Claude Code doesn’t need an IDE; it’s just a nice add-on. So really, it shouldn’t be a big deal to go without something you never had in the first place. Patience is a virtue 🧘
Why are you spending your time on this thread then 😅
Patience is a virtue... right after I finish venting about how everything FAILED and why this isn't fixed already! 🧘➡️😤➡️🧘
Agreed that we should have patience and I appreciate the response that Anthropic devs have had on this thread.
Re: WSL isn't a great choice for windows.. I almost agree, but I think of it as a minor headache more than a full nonstarter. I already used WSL for my windows dev terminal environment due to the superiority of linux tools w/ ZSH and related terminal stuff. Since it has access to full windows file system and calling windows functions - its just some 1 time plumbing and then minor inconvenience in exchange for IMHO a better dev environment than what powershell can provide. ( I tried to use powershell as my main environment for years as well! )
If agentic tools ever get to the point where they can view or manipulate GUIs, I would guess we would feel more pain with Claude Code in windows due to WSL.. Since it is all terminal based at the moment, I'm fine with it as long as it works as advertised.
I think this particular issue of a Riders windows app, talking to WSL Claude Code, seems like one of the main considerations they would need to figure out due to the WSL choice. So it does seem a bit odd that the plugin was released without seemingly testing this? ( Or maybe there is some other work around floating out there, but I haven't found one that works in this thread ).
I wonder whether it would be possible for Claude to use WSL under the covers, eg by creating shells to do its work.
As an example, I'd like Claude to be able to create, run and fix Playwright tests, including looking at the test debug outputs. It's good enough to have a go. But I don't want to have to maintain an identical working Playwright environment on both Windows native (for me) and WSL (for Claude), and it becomes a faff for me to dive into WSL to view Playwright debug trace from failed Claude attempts.
I can't see that ever working nicely via WSL. I might be missing something, of course.
I had a similar issue (assuming I understand correctly), where I wanted claude to be able to compile a program that would only compile on windows.
I solved this by creating a bridge between WSL and Windows: On the Windows side, I set up a local rest server that receives toolchain commands, verifies them, runs them, and streams the results back. On the WSL side, I put a small executable that just acts as a proxy - it takes whatever arguments it receives, sends them to the host server via http request, and prints the output it receives to stdout. I then put into claudes memory to use this executable as a drop-in replacement for the toolchain.
This has mostly worked well for me. Maybe this would also be feasible for your playwright scripts.
It's probably feasible, but it's insane 😊.
Kudos for getting that up and running, but in terms of UX for Windows developers using Claude it nicely illustrates the absurdity. If plumbing like that is needed, then it would be better to build it in so that wheels can sleep peacefully unreinvented.
Maybe I'm not understanding but I have Claude Code building and running things that are outside of WSL without issue using cmd.exe. I also have it using stdio MCP tools that are using commands running on windows instead of WSL. WSL isn't really an issue other than needing to inform it in CLAUDE.md how to properly do things on windows and in MCP providing the full path for the command executable instead of using the default which would typically select from the WSL env.
Youre right lol. I had a weeks long brainfart. No telling how many wheels would have been reinvented without you. :D
Yup! I am same as you. Just use cmd.exe and Claude Code in WSL can kick off Windows build commands and then read the output. I am doing this for an Unreal Engine project where I want it to just build with the windows toolchain for a variety of reasons.
I'm using it for UE as well :) I've almost closed the loop on Claude Code building tools for UE and testing them itself with MCP. Too bad CC doesn't support notifications/tools/list_changed yet though so I have to reboot CC to give it access to its new MCP tools.
New version of the plugin out ( 0.1.7-beta ) .. release notes:
.. updated and.. Nothing for me! Curious if anyone else has had any luck with this new update, or if these are some other tier of WSL issue?
same. updated the cli as well (auto update doesn't work for me)
!Image
There is some progress, but the IDE remains disconnected. And there are no visible IDEs inside the Pycharm terminal.
Managed to "connect" when I started Pycharm after Claude Code.
plugin v 0.1.7-beta does not fix the above issues for me. IDE is not being detected via /ide command on windows vis wsl nor can i use any diff-views. It seems like we have to wait a bit longer
Is there anything we can do to help with this issue? Happy to provide a remote desktop to my machine or something. I really like to use Claude Code on mac, but it's not working on my main dev machine (win 11 / wsl).
Hey everyone! Found a way to get it working with windows! Not sure if it is ideal but...
Mirrored, and turn on Host Address Loopbackwsl -d Ubuntu -- bash -i -c "claude", and turn on "Skip the Claude Command not found check"EDIT: Maybe you don't need the Host Address Loopback actually, just the networking mode to mirrored seems to already help you find the windows-running IDE
You absolute legend. This worked for me as well, but I'll note the 2 slight tweaks to these instructions I had for my setup:
Anywho. Thanks so much for sharing! I am connected and it seems to be working but I'm excited to try it out more. Will report back if any issues, but thanks so much for sharing 🍻
Generally all working, I am not sure how required the " bash -i -c " part of launching Claude is.
Then I'll note as well, for every query I do, I am now getting this error, but then it ends up totally just working after that - so seems benign? So many moving parts to the auth and such, it might just be my environment. I will just deal with it for now since it is generally working
This error originated either by throwing inside of an async function without a catch block, or by rejecting a promise which was not handled with .catch(). The promise rejected with the reason:
McpError: MCP error -32603: Tool not found: closeAllDiffTabs
at Mc1._onresponse (file:///home/tim/.nvm/versions/node/v22.16.0/lib/node_modules/@anthropic-ai/claude-code/cli.js:1358:20090)
Since you're already opening your terminal with wsl -d Ubuntu, you are probably just waiting for it load and then opening claude, which you can just type "claude" and enter. But the command I put is for keeping the terminal a regular windows terminal, and then when you click the "Claude" icon up there, it opens both the wsl -d Ubuntu, and once the ubuntu is open it opens the claude and that
bash -i -cis for that (wait for the interactive terminal then run "claude" etc.)I'm also receiving that error, but just sometimes, don't know why... Maybe something to do with closing the rider diff tool
Finally! Worked for me in PyCharm, thanks!
Also you can setup wsl settings by creating C:\Users\[your_user_profile]\.wslconfig with following config:
Do you guys use stadard windows paths with this workaround? Cause after setting networking mode I get:
Found 1 other running IDE(s). However, their workspace/project directories do not match the current cwd.
!Image
Like here: https://github.com/anthropics/claude-code/issues/1411
One small limitation is that mirrored networking is seemingly only supported on windows11.
It is strange to me that this seems to be a networking issue. Not what I would have thought.
Yes, I prefer using windows paths. It looks like you have your project files in the wsl storage. When you have them in the windows filesystem, it gets mounted at
/mnt/c/and then just the windows path. Probably an unrelated bug suitable for its own issue.I'm also getting this.
I also notice that while in
Mirrorednetworking mode my projects within a docker container run significantly slower and is almost unusable.I may try storing on the windows storage as some of the others suggested, if I do I will report back with those results.
Me three. Using Mirrored networking on wsl2.
Claude runs in wsl with a cwd: "/home/name/projects/myproject"
Claude complains that the project workspace is: "//wsl$/Ubuntu/home/name/projects/myproject/"
Here's some info on how I just got this working in IntelliJ (without mirrored networking). Hint: disable the firewall and create a port forward. Caveat: It's preliminary, fragile, and might not be feasible for you. 🫣
File | Settings | Tools | Terminal | Shell path).Alt-F12).Help | Show Log in Explorer).CLAUDE_CODE_SSE_PORT=. The timestamp should be from the last minute (when the terminal was opened)--if it isn't, try restarting the terminal, or all of IntelliJ. Your port number will vary. Let's assume it's61805.netsh interface portproxy add v4tov4 listenport=61805 listenaddress=0.0.0.0 connectaddress=127.0.0.1wsl -d Ubuntu;cd /mnt/c/my-project-path;claude;/ideNotes:
netsh interface portproxy show allnetsh interface portproxy delete v4tov4 listenport=[your-port] listenaddress=0.0.0.0I succeeded with WSL in mirrored but it doesn't keep the ide in the configuration.
I must redo
/ideand register Pycharm each time, is this normal behavior?Good research! Here's my attempt at some improvements.
Firewall: Leave it active. Run once in powershell as admin:
Note: Not sure if these IPs are identical for everyone
Claude Code Port: Instead of looking for the port in the log, use the lock-file:
Loving how much hacking is going on in this thread 💯 . Everyone here is a total rockstar for helping debug and resolve some of the issues here! ❤
Just a headers up that we are still actively working on this, and should have a solution soon to 1) not require mirror networking mode, and 2) fix some of the file path mapping issues between WSL and Claude Code (for
C:\or//wsl$/Ubuntu/paths).We really appreciate your patience as we work through this, and we're really excited that everyone in the community has been so helpful in debugging and tracking down the issues with us!
@hackyon-anthropic that's great news. The mirror mode got the IDE integration working, but I started having port binding issues with it that I wasn't having before:
This only goes away if I kill the
wsl.exeprocesses and restart Claude Code.I can confirm that this bug seems resolved with the 0.1.8-beta version of the Intellij IDEA Claude Code [Beta] plugin, coupled with the 1.0.18 version of Claude Code itself. This works without needing to set up network mirroring in WSL or any of the other workarounds mentioned already in this thread.
Thanks, Anthropic team, for the quick response on this!
The latest versions (0.1.8-beta and 1.0.18) only make it work for me with networkingMode=mirrored on. Progress. However this breaks my git, so its not an option.
Without mirrored networking: "No available IDEs detected."
Windows 11
PhpStorm
I was ready to dismiss this as it didn't work initially for me, but after some testing it started working. It may be necessary to restart the IDE a couple of times for whatever reason. I think the troubleshooting docs also mention this.
I can also see a new incoming connection from 172.23.160.1 to the IDE that wasn't there previously.
I can confirm that version 0.1.8-beta fixes the IDE detection, and mirrored network mode in WSL is no longer needed! 🚀
The only issue that persists is that I have to manually connect the IDE every time Claude Code is opened with the
/idecommand. According to the documentation this should be automatic when Claude Code is invoked through the built-in terminal in the IDE, but that doesn't happen.I just tried exiting Claude Code and restarting it, and I see that behavior, too. The IDE is listed in the
/idesettings, but "None" is selected by default.Hey everyone - thank you so much for your patience! ❤
We've just pushed out a new Claude Code version and and JetBrains plugin update this morning, and it should now support more WSL configurations!
Specifically, it should now work without mirrored networking mode, and there should be automatic path translations between WSL and Claude Code (ie. it will try to map between
\\wsl$\Ubuntu\home\and/home/, as well as between/mnt/c/andC:\, configurable in the settings)For now, you will still need
/ideto connect, but we're actively looking into options to auto-connect!Please continue to let us know if you encounter issues. We'll do our best to fix any other issues that come up!
https://github.com/anthropics/claude-code/issues/1232#issuecomment-2963331331
I cannot get it to work without mirrored networking mode. Now on versions 1.0.21 and 0.1.8-beta.
I can provide logs or do screen share -- claude code is amazing so I want it to get it fully working!
On
1.0.21 (Claude Code)via Windows 11 WSL2,/ide!detects on JB Rider2025.1.2; Claude Code plugin0.1.8-beta!Image
/ideNOT using mirrored networking unless that's default - I didn't touch those settings (or know what they do).
/
!Image
!Image
Finally, I connect WSL <-> Claude
!Image
Thanks to sudo ln -s "my global npm path" /usr/local/bin/claude
Nice!
@dylanh724 @DerekLJ - would you be able to try these steps?
/idecommandLet me know what shows up in the
/idecommand. Thanks!Also, do you know if you're running WSL2 or WSL1 (it's normally WSL2 by default)
@hackyon-anthropic
For me it helped. Claude Code now sees IntelliJ IDEA.
But when i select IntelliJ IDEA I immidiately see "IDE disconnected"
!Image
@if-of thanks for checking! Looks like there's a connection issue.
Are you running on WSL2? When you are run the command
ip route show | grep -i default, does it print out anything? (don't need to post what the output is, but just to see if there is a correct network interface installed in your WSL2 env)@hackyon-anthropic
when running inside my wsl2 ubuntu image i get
default via 172.24.0.1 dev eth0 proto kernelA few additional points:
Mine never works without mirrored networking.
Powershell as admin:
Then leaving that running I open PhpStorm and run this (and I tried clicking the Anthropic logo with the same results):
/ide returns no ides.
Networking debug:
WSL version. It shows Windows version 10 but I'm using Windows 11; this is expected according to Claude.
Claude Code Status v1.0.22and plugin Version 0.1.8-beta
It runs Claude Code, now (if I set WSL as terminal), but my IDE list is empty. (I'm currently in WebStorm. Haven't tried others.)
It can be helpful as-is.
I also ran into some issues with the ide showing disconnected immediately, but it started working again after some IDE restarts and me adding back the network rule as powershell-admin:
It can be removed again by doing
Not entirely sure if this was the reason it started working again
I noticed a new icon at the top-right for Claude Code in Rider. When I click it, it opens PowerShell and errors out since it should be opening wsl2. This bug could be related to !detection with /ide
!Image
Yes, you can customize the command, but I can't simply
wsl -e claude; I tried. It's a rabbit hole to hell. This needs to open in wsl before the command hits or it won't work without tremendous effort.If this is running in the background to be detected via /ide, this could be why it's !detected?
Here are a couple of scenarios to help developers reproduce the bug:
Scenario 1
cdinto your project and typeclaude.Scenario 2
.../claude/ide/63535.lock– note that the port number may vary.)---
Potential Firewall Issue
The problem might be related to the firewall. If I check the IP address like this:
And then set a firewall rule as follows (run as administrator):
With this rule in place, everything works. The immediate disconnection issue is resolved, and the IDE can be detected regardless of the order in which the IDE or Claude is opened.
Can't make it work, what the solution now ?
I still can't use it. I can use the claude code plugin to call claude normally, but I still can't find the rider for '/ide'
It works! But why does it need an external powershell, rather than using claude button in the IDE?
I'm glad others have gotten it working, which gives me hope, but nothing I've tried makes it appear in /ide EXCEPT turning on mirrored networking.
Start claude code first then WebStorm, I can see WebStorm in
/ide, but after click it, it is just shown "IDE disconnected".No
diff viewin/config, so I assume the issue is still there.!Image
!Image
!Image
Not sure what the rabbit hole you are speaking about is.
There are 2 simple options I am aware of:
<details>
<summary>aliasing</summary>
Open powershell profile in notepad:
In the following code, replace the path
/home/user...with the output fromwhich claude(run in wsl), then put it in the fileRestart IDE/powershell. Obviously for this to work, your default editor in the IDE needs to be powershell, which it was for my by default.
</details>
<details>
<summary>changing ide terminal defaults</summary>
Settings>Tools>TerminalC:\Windows\System32\wsl.exe -d ubuntu(replace ubuntu with your wsl instance – I found that specifying it is necessary for colors to work in the terminal).Downside being that by default, the terminal now opens in wsl. You can still click the
vicon though.</details>
Now try clicking on the claude icon. It should work.
---
However, you will notice, that the ESCAPE key doesn't work in the IDEs terminal. You again have two options to fix this:
<details>
<summary>Rebinding</summary>
</details>
<details>
<summary>Terminal Option (as mentioned by @enricoros), may not be available on older ide version (android studio for example does not seem to have that option yet, but rebinding works)</summary>
</details>
---
Obviously, both of these should be handled by the plugin natively, but it is not clear if jetbrains' api offers these capabilities.
Also, I don't personally like using jetbrains IDE terminal for running claude (neither the old one nor the reworked beta). I find using the normal microsoft terminal to be a better experience currently. Maybe if the beta gets better. So this may not even be worth it :D
---
If you have connection issues (immediate disconnection), try in PowerShell as admin
Edit: Got some feedback from a colleague. On many installations,
wsl hostname -Iwill not work for our purposes. As such, I changed the command to include the wsl instance specifically. I also made the rule broader to use /16 as they may change.This has been working for me for 5 days straight now on windows10.
!Image
My system is Windows, and I’ve already installed the Claude plugin on Cursor (version 1.0.29). However, I’m still getting the above error when running the /ide command.
Could you please advise how I should resolve this?
just throwing some input in here. My install worked fine with root user on arch linux. however after I made a non root user, it didn't detect the IDE anymore.
Thanks everyone again for their input and support!
We are working on a bigger change that will hopefully alleviate Windows issues even more. In the meantime, we now have a setting in
/configthat allows you to auto-connect to an IDE (the setting only shows up when you are already connected to an IDE).@DerekLJ - just to verify, it works fine with mirrored networking, but doesn't work without? If so, it sounds like there's still a networking/firewall issue with WSL that's blocking the connection. If you 1) close all IDEs, 2) start Claude in a separate terminal (Powershell+WSL) instance [edited from before], 3) open up your IDE, and 4) run
/ide, can you verify that something does show up? It might show disconnected if you choose one of those items, but wanted to check if something actually shows up with these steps@zeroarst - can you please try to add the networking rule here? https://github.com/anthropics/claude-code/issues/1232#issuecomment-2983198969
Does Claude now work in Powershell?
Sorry for the confusion, I meant starting Claude in from a separate terminal (Powershell+WSL) instance!
!Image
I followed your steps, and it works! Note the Claude plugin does not work, but I can now select Rider in the IDE. Thank you!
Edit: The plugin only does not open Claude when I click it. But that's okay. (See below.)
However, I don't see WebStorm in the list of IDEs, even though I have the plugin installed, and it's open. Does it only find the first IDE that's open? Or is this a bug?
For clarity, "your steps" that I followed are:
1) close all IDEs,
2) start Claude in a separate terminal (Powershell+WSL) instance [edited from before],
3) open up your IDE, and
4) run
/ide4 is in the original Claude session.
This is fine, and good enough for me to keep my Claude subscription. I mean, I _always_ have a shell open, anyway.
There are few steps that need to be done as temporary bypass until Claude team will fix the plugin for Windows:
ctrl+esc, is catched by Windows. I recommend changing the shortcut: Settings/Keymap, search for 'claude code', and add another keymap (I usedctrl+f1. which is close to the original. It's already used for something else, but I never used it until now, so it seems OK to remove it from the other command)shift+shift,Claude command:) and modify the command towsl -d Ubuntu -- bash -lic "claude"(assuming Claude Code is installed on Wsl + Ubuntu)escapefrom inside the terminal, by default it's not passed to the terminal, but to the IDE. to fix this: go to settings/Tools/Terminal, and uncheckMove focus to the editor with Escape/ide, and make sure that it's OK. Strangely, it used to be OK for me, but now it's not...If I use an external terminal (non-Rider integrated terminal) I can get it to work but I still need to close Rider and re-open it after entering a claude code session.
So it seems like there is some necessary event happening when Rider IDE initially loads the project to allow claude code to reach it... But claude code needs to be already in an active session and listening / scanning to capture this event.
PS: To confirm it's not the rider terminal environment causing issues, I opened 2 Rider IDE instances (target project + some other project). In the other project, I used the integrated terminal to enter a claude code session and for the target project I closed and re-opened the Rider IDE. Before closing and re-opening, it could not find rider. After re-opening, it could. So whatever event is happening on re-opening... Maybe it could be triggered again somehow when the claude code /ide command fires?
Seems to be reliably re-producible so I have full confidence it will be eventually fixed in a later release.
In the meantime, using an external terminal is a fine workaround 😃
Is there any reason to stay in WSL given CC has been released for native Windows and seems to work with JB IDEs?
CC for native windows? Hadn't see that info anywhere. Unless you mean perhaps through git bash on Windows?
That is probably what I mean....
Not fixed yet ? What the current solution ?
Wasted an hour to uninstall / reinstall just to find out it is still not fixed. works fine under linux.
The use of git bash on Windows is working fine for me.
even if I start claude with git bash, the plugin is not working.
Everything works on WSL in Windows if you switch the WSL networking from NAT to Mirroring (with NAT, the IDE is detected but stays in a 'IDE disconnected' state). I don't want to do that, so I'm hoping for a proper solution.
Thank you I followed @ZvikaZ steps and @msokolnickiitt by creating file
%userdir%\.wslconfigconfig to enable mirroring:and finally Claude Code detects the IDE for me..
Thanks everyone for their comments and working through this issue with! The origin cause of the WSL2 detection should have been resolved, so I will closing this.
For those who are still having issues connecting to your JetBrains IDE on Windows with WSL2, we have documented some troubleshooting tips here: https://docs.anthropic.com/en/docs/claude-code/troubleshooting#jetbrains-ide-not-detected-on-wsl2
Also, we recommend using the Windows Powershell (git bash) version of Claude Code with your IDE as it is more reliable.
If you continue to encounter any issues after trying out the troubleshooting tips, feel free to open up another issue and we can take a look. Thanks!
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.