Skip to content
← Back to release · 2.1.318
Improvements / v2.1.318

Stop auto-installing IDE extension in IDE terminal

CHANGELOG · original

Changed Claude Code to no longer install or update the IDE extension when started in an IDE terminal; use /ide from an outside terminal or your editor's extensions view
Open official changelog ↗

Documentation

Documentation excerpt

VS Code extension vs. Claude Code CLI

Claude Code is available as both a VS Code extension (graphical panel) and a CLI (command-line interface in the terminal). Some features are only available in the CLI. If you need a CLI-only feature, run claude in VS Code's integrated terminal. This requires the standalone CLI install: the extension does not add claude to your PATH. See Run CLI in VS Code.

Feature CLI VS Code Extension
Commands and skills All Subset (type / to see available)
MCP server config Yes Yes: add and manage servers with /mcp in the chat panel
Checkpoints Yes Yes
! Bash shortcut Yes No
Tab completion Yes No

Run CLI in VS Code

To use the CLI while staying in VS Code, press Ctrl+` on Windows/Linux or Cmd+` on Mac to open the integrated terminal, then run claude.

To get features like diff viewing and diagnostic sharing, connect the CLI to the extension from the integrated terminal or an external terminal:

  • Integrated terminal: install the extension, then start claude. The CLI connects automatically. Claude Code v2.1.318 or later doesn't install the extension for you, so until you install it, /ide reports "No available IDEs detected" and /status shows the IDE as "Not connected".
  • External terminal: run /ide inside Claude Code to connect to VS Code. If VS Code is running without the extension, /ide installs it, unless you turned off autoInstallIdeExtension.

Installing the extension does not put claude on your shell PATH. The extension bundles a private copy of the CLI for its chat panel, but typing claude in a terminal requires the standalone CLI install. Run the install once and the commands on this page, including claude mcp add and claude --resume, work in any terminal. If claude is still not found after installing, verify your PATH.

Switch between extension and CLI

The extension and CLI share the same conversation history. To continue an extension conversation in the CLI, run claude --resume in the terminal. This opens an interactive picker where you can search for and select your conversation.

Documentation snapshot · 2026-11-20

Change details