What to Do When You Can’t Run Claude From VS Code

Dominic Anderson May 29, 2026

Key Takeaways

VS Code can add Claude as an extension, but it must be connected via a Pro, Max, Team, Enterprise, or Console account.
Ensure that your extension is properly integrated; if installing via npm, Node.js 18 or higher is required, but native installs do not require Node.js.
Check that your firewall or VPN isn’t interrupting the connection, and that other extensions aren’t interfering.

Visual Studio Code is a handy tool in its own right, but sometimes you might need a little extra assistance from an integrated source, like Claude. Though the app does go a long way to making this integration easy, you may still encounter a few different errors. This article is here to help you make VS Code with Claude work.

VS Code with Claude – Making Things Work

If you can’t run Claude from VS Code, we’ve got a few troubleshooters below for you to try. Let’s get started:

Check Your Claude Integration

First, you need to ensure that VS Code and Claude are talking to each other properly. Claude integrates through the “Claude Code” extension. To install this:

Step 1. Open the Extensions view by clicking (Ctrl + Shift + X).

Step 2. Type “Claude Code” into the Search and choose the extension for you.

What to Do When You Can’t Run Claude From VS Code 1

Step 3. Click the “Install” button.

What to Do When You Can’t Run Claude From VS Code 2

Step 4. If you already have an extension installed and it isn’t working, you can try removing it and reinstalling it to see if this resolves the error.

Choose Your Use

What to Do When You Can’t Run Claude From VS Code 3

Claude can be used in VS Code with an active subscription to Pro, Max, Team, or Enterprise, or through a Console account. Third-party providers – Amazon Bedrock, Google Vertex AI, and Microsoft Foundry – are also supported. If you can’t use Claude, ensure that you are either logged in to the Claude window or have an API key or provider configured.

Error Search With Output

VS Code also has built-in methods to help you check for errors. It could help with troubleshooting Claude. Here’s what to do:

Step 1. Open VS Code’s integrated terminal (Ctrl+` on Windows/Linux).

Step 2. Type “claude doctor” and press “Enter.” This checks your installation and configuration and reports any problems it finds.

What to Do When You Can’t Run Claude From VS Code 4

Check Node.js Version

For Claude to stay functional in VS Code, the Claude CLI requires a Node.js version of 18 or higher. To check that it’s installed, do the following:

Step 1. In Windows, open the Run dialog (Win + R) and type “cmd” before clicking (Ctrl + Shift + Enter) to run as Admin.

Step 2. In Command Prompt, type “node -v” and press “Enter.”

What to Do When You Can’t Run Claude From VS Code 5

Step 3. If this command isn’t recognized and you used the npm installation method, you’ll need to install Node.js.

To install or update Node.js dependency, do the following:

Step 1. Visit the Node site to download the latest version.

Step 2. Once the installer has downloaded, double-click it and run through the steps.

What to Do When You Can’t Run Claude From VS Code 6

Step 3. Completely restart VS Code and try running Claude again.

Check Your Firewall and VPN

Seeing as Claude needs internet connectivity to do its job, it’s important to ensure your VPN or Firewall isn’t blocking it. Temporarily turn off any VPN you have installed, and check your Firewall to make certain VS Code isn’t being blocked.

Turn Off Other Extensions

Third-party extensions aren’t always going to play well together. If you suspect this might be hampering your Claude extension, then it’s a good idea to disable all others and check functionality again. You can do this in the extensions window (Ctrl + Shift + X). If it does help, then turn on other extensions one by one until you encounter the troublemaker.