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
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 --textOpen one file and select a narrow region
Ask the IDE panel to explain the selection and cite related files before requesting an edit.
Request one reversible change
Use the panel's plan or diff review, reject unrelated hunks, and avoid mixing simultaneous edits from the terminal session.
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.
claude auth status --text
claude doctorRequirements
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 guideInstall
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 guideOpen the panel
Click the Spark icon in the editor toolbar, Activity Bar, Command Palette, or status bar to start a session.
Read guideTerminal integration
Open the integrated terminal and run `claude` for CLI workflows with IDE diff viewing and diagnostic sharing.
Read guideJetBrains 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.
| Command | Description |
|---|---|
/ide | Connect a terminal session to the open JetBrains IDE. |
/config | Set diff tool, theme, model, and other IDE-related preferences. |
claude doctor | Verify CLI install health when the plugin reports command-not-found. |
Install the plugin
Install Claude Code from the JetBrains Marketplace, restart the IDE, and open Settings β Tools β Claude Code.
Read guideSet the CLI path
If the IDE cannot find `claude`, set the full path in the Claude command setting.
Read guideActivate integration
Run `claude` from the integrated terminal, or use `/ide` from an external terminal to connect to the open JetBrains IDE.
Read guideDiff tool
Run `/config` inside Claude Code and set Diff tool to `auto` to show changes in the IDE instead of only in the terminal.
Read guideEditor 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.
Selected code prompts
Highlight only the code relevant to the requested change.
Read guideChrome for UI bugs
Reproduce browser issues, then return to IDE for the patch.
Read guideDesktop handoff
Move to desktop when GUI diff review is faster than terminal output.
Read guideDiff 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 guideJetBrains
Enable the plugin, open the project root rather than a subfolder, and verify the CLI path in plugin settings.
Read guideDesktop handoff
Use /desktop to continue a terminal session in the desktop app when visual review is easier.
Read guideRemote control
Use remote-control flows when you need to continue a local session from another device or the web UI.
Read guideWhen 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: 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
Use selections deliberately
Select only the relevant code when asking for focused edits or explanations.
Read guideInspect diffs visually
Review UI, refactor, and generated test changes in the IDE before accepting them.
Read guideKeep CLI available
Even with IDE integration, keep the CLI working for broad repository checks and automation.
Read guideTrust the workspace
Open the repository root and mark the folder trusted so file access and extensions behave consistently.
Read guide