[BUG] VS Code extension fails to point node path causing "Error: Claude Code requires Node.js version 18 or higher to be installed"

Resolved 💬 34 comments Opened Oct 2, 2025 by mentasuave01 Closed Nov 18, 2025
💡 Likely answer: A maintainer (hackyon-anthropic, collaborator) responded on this thread — see the highlighted reply below.

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?

node v24.9.0
<img width="1522" height="999" alt="Image" src="https://github.com/user-attachments/assets/9cbb5ecd-7d21-4aae-859d-8fcc87e8deb1" />

What Should Happen?

It should find node like inside the terminal

Error Messages/Logs

Steps to Reproduce

open vscode
launch the extension

Claude Model

None

Is this a regression?

Yes, this worked in a previous version

Last Working Version

_No response_

Claude Code Version

2.0.3

Platform

Anthropic API

Operating System

Other Linux

Terminal/Shell

VS Code integrated terminal

Additional Information

_No response_

View original on GitHub ↗

34 Comments

github-actions[bot] · 9 months ago

---

Found 3 possible duplicate issues:

  1. https://github.com/anthropics/claude-code/issues/8410
  2. https://github.com/anthropics/claude-code/issues/8439
  3. https://github.com/anthropics/claude-code/issues/8704

This issue will be automatically closed as a duplicate in 3 days.

  • If your issue is a duplicate, please close it and 👍 the existing issue instead
  • To prevent auto-closure, add a comment or 👎 this comment

🤖 Generated with Claude Code

---

sandboxcode · 9 months ago

For me the recent Update vor VS Code und Claude Extension fixed this issue.

projecthamburg · 9 months ago

facing the same issue in my mac/cursor. anyone got any fix?

markgoho · 9 months ago

might be related to using nvm

rafaelsalves · 9 months ago

With Visual Code opened:

  • Press ⇧⌘P (Command Palette)
  • Write Shell Command: Install 'code' command in PATH
  • Restart Visual Code
LIdro · 9 months ago

Fixed on Linux with nvm

The issue occurs because VS Code launched from the GUI doesn't inherit the PATH from nvm (which is set in ~/.bashrc).

Solution:

Add nvm to your ~/.profile:

Add to ~/.profile

export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"
[ -s "$NVM_DIR/bash_completion" ] && \. "$NVM_DIR/bash_completion"

Create systemd environment config:

mkdir -p ~/.config/environment.d
echo 'PATH=$HOME/.nvm/versions/node/v22.16.0/bin:$PATH' > ~/.config/environment.d/node.conf

(Replace v22.16.0 with your Node.js version)

Log out and log back in. Claude Code should now work when launching VS Code from the GUI.

For me, i just restarted my machine for the hell of it. After all it has been like 4 months between restarts ;)

dapperdandev · 9 months ago

I'm on Windows . For me, I had to use the local installation:

claude migrate-installer

Set up Claude Code - Local Installation

Follow the prompts, then close and re-open shells and VS Code.

Today's update probably played a role too.

mentasuave01 · 9 months ago
Fixed on Linux with nvm The issue occurs because VS Code launched from the GUI doesn't inherit the PATH from nvm (which is set in ~/.bashrc). Solution: Add nvm to your ~/.profile: # Add to ~/.profile export NVM_DIR="$HOME/.nvm" [ -s "$NVM_DIR/nvm.sh" ] && . "$NVM_DIR/nvm.sh" [ -s "$NVM_DIR/bash_completion" ] && . "$NVM_DIR/bash_completion" Create systemd environment config: mkdir -p ~/.config/environment.d echo 'PATH=$HOME/.nvm/versions/node/v22.16.0/bin:$PATH' > ~/.config/environment.d/node.conf (Replace v22.16.0 with your Node.js version) Log out and log back in. Claude Code should now work when launching VS Code from the GUI. For me, i just restarted my machine for the hell of it. After all it has been like 4 months between restarts ;)

This solves the issue on my end
Thank you @LIdro I own you a drink

lamazzing · 9 months ago

Upgrade to node v24.9.0. close completely your ide, restart, worked for me

mentasuave01 · 9 months ago
Upgrade to node v24.9.0. close completely your ide, restart, worked for me

node v24.9.0 was the starting point

lamazzing · 9 months ago

Ah missed that, have you tried just switching node versions?

elektricM · 9 months ago

@LIdro Im on mac, solved my issue too

adhikary97 · 9 months ago

Updating node fixed the issue for me

Reapor-Yurnero · 9 months ago

I want to make it very clear that this issue is more on the compatibility with nvm but not the other irrelevant issue (e.g. updating node) mentioned above. It is not a standard behavior to have the nvm scripts in .profile as suggested by @LIdro (though it does solve the problem) and it is definitely CC's job to work with NVM properly. A simple enough potential solution is to allow to configure the PATH of node for VSC extension.

asyncawaitpromise · 9 months ago
Fixed on Linux with nvm The issue occurs because VS Code launched from the GUI doesn't inherit the PATH from nvm (which is set in ~/.bashrc). Solution: Add nvm to your ~/.profile: # Add to ~/.profile export NVM_DIR="$HOME/.nvm" [ -s "$NVM_DIR/nvm.sh" ] && . "$NVM_DIR/nvm.sh" [ -s "$NVM_DIR/bash_completion" ] && . "$NVM_DIR/bash_completion" Create systemd environment config: mkdir -p ~/.config/environment.d echo 'PATH=$HOME/.nvm/versions/node/v22.16.0/bin:$PATH' > ~/.config/environment.d/node.conf (Replace v22.16.0 with your Node.js version) Log out and log back in. Claude Code should now work when launching VS Code from the GUI. For me, i just restarted my machine for the hell of it. After all it has been like 4 months between restarts ;)

This solved the problem for me using Cursor code editor on Ubuntu. I did not have to reboot, used ctrl + alt + f1 to log back in and restart my session, and I had to restart the code editor itself to see changes take place.

sunovivid · 9 months ago

@projecthamburg

facing the same issue in my mac/cursor. anyone got any fix?

I'm using mac/cursor and I have tried @rafaelsalves's suggestion and then tried >Cursor: Attempt Update following @sandboxcode' suggestions, and it fixed the issue

mentasuave01 · 9 months ago
Fixed on Linux with nvm The issue occurs because VS Code launched from the GUI doesn't inherit the PATH from nvm (which is set in ~/.bashrc). Solution: Add nvm to your ~/.profile: # Add to ~/.profile export NVM_DIR="$HOME/.nvm" [ -s "$NVM_DIR/nvm.sh" ] && . "$NVM_DIR/nvm.sh" [ -s "$NVM_DIR/bash_completion" ] && . "$NVM_DIR/bash_completion" Create systemd environment config: mkdir -p ~/.config/environment.d echo 'PATH=$HOME/.nvm/versions/node/v22.16.0/bin:$PATH' > ~/.config/environment.d/node.conf (Replace v22.16.0 with your Node.js version) Log out and log back in. Claude Code should now work when launching VS Code from the GUI. For me, i just restarted my machine for the hell of it. After all it has been like 4 months between restarts ;)

Launching VS Code from the GUI is the root cause of this particular bug, for the node update commends please read that the issue is happening on node v24.9.0, do not mix issues, that issue is unrelated to this one.

Opening vscode from console solves the issue as well as the solution from @LIdro

amowu · 9 months ago

For some reason, after I installed other versions of the extension and then reinstalled the latest version, the problem disappeared when I restarted VS Code.

crimama · 9 months ago
Fixed on Linux with nvm The issue occurs because VS Code launched from the GUI doesn't inherit the PATH from nvm (which is set in ~/.bashrc). Solution: Add nvm to your ~/.profile: # Add to ~/.profile export NVM_DIR="$HOME/.nvm" [ -s "$NVM_DIR/nvm.sh" ] && . "$NVM_DIR/nvm.sh" [ -s "$NVM_DIR/bash_completion" ] && . "$NVM_DIR/bash_completion" Create systemd environment config: mkdir -p ~/.config/environment.d echo 'PATH=$HOME/.nvm/versions/node/v22.16.0/bin:$PATH' > ~/.config/environment.d/node.conf (Replace v22.16.0 with your Node.js version) Log out and log back in. Claude Code should now work when launching VS Code from the GUI. For me, i just restarted my machine for the hell of it. After all it has been like 4 months between restarts ;)

Thanks to these guidelines, I was able to resolve this issue. I instructed the cursor to perform the task, and after completion, I was able to use Claude Code in VSCode.

evemilano · 9 months ago

any possibility this bug will be fixed anytime?
it is pretty annoyng for a paid account...

WiredWonder · 9 months ago

Why does Claude Code need node at all? The claude.exe program is self contained.

hackyon-anthropic collaborator · 8 months ago

We have removed the node dependency for Linux and Mac versions (and are working towards Windows as well). Please update to the latest version and give it a spin. Thanks!

coleea · 8 months ago

Deleting nvm and using fnm solved this issue in my case

evemilano · 8 months ago

@hackyon-anthropic hello, does it take so much to fix the bug on win11??!!

NonicaTeam · 8 months ago

Same issue here with Max plan. Looking forward to the fix anytime soon. It didn´t appear before with version 2.0.36 but with 2.0.37 is back.

evemilano · 8 months ago

Two months after reporting the bug, it's still there. And it's a paid service.

tbuiatti · 8 months ago

windows 11

To fix the Claude Code error, manually install Node.js:

  1. Download the Windows Installer (.msi) from [](https://nodejs.org/en/download/)<https://nodejs.org/en/download/> (choose the latest LTS version, which is 20.x or higher).
  2. Run the downloaded file as administrator (right-click > Run as administrator).
  3. Complete the installation.
  4. Restart VS Code.
  5. Open a new terminal in VS Code and run node --version to verify (it should show v20.x or higher).

Claude Code should now work since Node.js 18+ is installed.

hackyon-anthropic collaborator · 8 months ago

Can you update the extension and try again? This should have been fixed.

Also, can you please add your development setup in the bug report?

evemilano · 8 months ago

why should I install node.js to run a chatbot in vsc? No-other llm extension requires additional software

BK0STAR · 7 months ago

same problem with the latest extension

MacOS 15.7.1 M2 Max

node --version
v25.2.1
‚npm --version
11.6.2

blois collaborator · 7 months ago
jaxenvisuals · 7 months ago

Fix for Windows (Should Also Work on macOS)

  1. Start a completely fresh VS Code window — no folder or project opened.
  2. Open the Integrated Terminal and run:

``
node -v
``

If it shows a version below 18, update Node.

  1. Using NVM or Volta? Switch to Node 18+.
  2. Fully close VS Code, reopen, and Claude should work normally.

The “fresh, empty window” part is crucial — that’s what makes VS Code load the correct Node version.

<img width="704" height="399" alt="Image" src="https://github.com/user-attachments/assets/01ba71f4-2c7e-4995-87c0-13d9fe004521" />

blois collaborator · 7 months ago

@jaxenvisuals latest versions should have no requirement for node. If you are still seeing this please make sure you're running the latest version.

github-actions[bot] · 7 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.