Claude Code in IDEs

IDE integrations bring Claude Code closer to the files, selections, diffs, and development context a programmer already uses. They are useful when visual review and editor navigation matter.

Last verified
Applies to
Claude Code 2.1.x. CLI spellings were checked on local version 2.1.198; current official docs may describe newer 2.1.x behavior.
Verification method
Official documentation, CLI reference, and changelog reviewed on 2026-07-19. VS Code and JetBrains flows were reviewed in official docs. Local CLI availability was checked; no IDE extension was installed or exercised in this audit.
Official sources
VS Code integrationJetBrains integrationCLI referenceChangelog

Reproducible practice

Verify an IDE-assisted edit without confusing extension and CLI state

Prove editor context, diff review, terminal verification, and rollback on one disposable change.

Prerequisites

  • VS Code 1.94+ or a supported JetBrains IDE, a trusted workspace, and the official integration.
  • A valid account; JetBrains and integrated-terminal CLI flows require the standalone claude executable.
  • A clean task branch and a known targeted test.

Steps

  1. Verify the terminal path separately

    The VS Code panel bundles a private CLI, but the integrated terminal does not inherit it on PATH.

    Step 1
    command -v claude
    claude --version
    claude auth status --text
  2. Open one file and select a narrow region

    Ask the IDE panel to explain the selection and cite related files before requesting an edit.

  3. Request one reversible change

    Use the panel's plan or diff review, reject unrelated hunks, and avoid mixing simultaneous edits from the terminal session.

  4. Verify in the integrated terminal

    Run the project-owned targeted test and inspect git diff after the IDE reports completion.

    Step 4
    git diff --check
    git diff --stat
    # Run the targeted project test

Expected result

The IDE shows the intended selection and inline diff, the terminal test evaluates the saved files, and the diff is independently reviewable.

Validation

  • Confirm the file is saved before running tests.
  • Check that selected-code context did not silently expand the task scope.
  • Reload the IDE and verify the changed file remains the same on disk.

Failure handling

Spark icon or panel missing

Open a file, check VS Code 1.94+, reload the window, and confirm the workspace is trusted.

Terminal says command not found

Install the standalone CLI; the extension's bundled copy does not add claude to PATH.

JetBrains cannot connect

Check the configured CLI path and run /ide from the terminal after the plugin is enabled.

Cleanup or rollback

  • Reject the proposed diff or use the IDE checkpoint for changes made by that session.
  • Confirm with git diff that rollback did not remove pre-existing user changes.

Boundaries and when not to use it

  • IDE availability and menus vary by editor version, remote environment, provider, and rollout.
  • Checkpoints cover Claude edits, not every external edit or irreversible command.

VS Code setup

The VS Code extension is the recommended graphical interface for Claude Code in VS Code. It supports inline diffs, @-mentions, plan review, and keyboard shortcuts. The extension bundles its own CLI for the chat panel, but running `claude` in the integrated terminal still requires the standalone CLI install.

Verify CLI from VS Code terminal
claude auth status --text
claude doctor

Requirements

Use VS Code 1.94.0 or higher and sign in with a paid Claude subscription or Claude Console account when the panel opens.

Read guide

Install

Open Extensions with Cmd+Shift+X or Ctrl+Shift+X, search for Claude Code, and click Install. Cursor and other VS Code forks can install from the marketplace or Open VSX.

Read guide

Open the panel

Click the Spark icon in the editor toolbar, Activity Bar, Command Palette, or status bar to start a session.

Read guide

JetBrains setup

JetBrains integration works through a marketplace plugin for IntelliJ, PyCharm, WebStorm, and related IDEs. The plugin runs the standalone `claude` command from the IDE terminal and does not bundle its own CLI copy.

CommandDescription
/ideConnect a terminal session to the open JetBrains IDE.
/configSet diff tool, theme, model, and other IDE-related preferences.
claude doctorVerify CLI install health when the plugin reports command-not-found.

Editor context

IDE usage lets Claude Code work with selected files, open buffers, and local project state. This reduces prompt length when the relevant code is already visible.

Diff review

Visual diffs make it easier to inspect changes before accepting them. This is especially helpful for UI code, generated tests, and refactors that touch several files.

Terminal and IDE together

Many teams use the CLI for broad repository work and IDE integration for focused edits. The right surface depends on whether the task is command-heavy, visual, or review-heavy.

Common setup checks

If IDE integration is not working, verify that the CLI is installed, authentication works, the extension is enabled, and the project folder is trusted by the editor.

VS Code

Install the Claude Code extension, trust the workspace, and confirm `claude auth status` succeeds in the integrated terminal.

Read guide

Remote control

Use remote-control flows when you need to continue a local session from another device or the web UI.

Read guide

When to prefer IDE over terminal

IDE integration shines when you need inline diffs, selected-code prompts, and fast navigation across many files. Terminal mode remains better for broad repository automation and scripting.

Terminal plus IDE pattern
# Terminal: broad repo exploration
claude "Map auth modules and test commands."

# IDE: focused edit with selected code
# Select a component, ask for a targeted refactor, review inline diff.

IDE checklist

Related topics