Omniscio

OmniscioGuidesClaude Code in VS Code

Claude Code in VS Code

The Claude Code extension puts the agent in a panel beside your editor, with inline diffs, a plan you can comment on, and the file you are looking at already in the conversation. It installs from the same marketplace as any other extension.

This page covers the requirements, the install, the four ways to open it, the shortcuts and settings worth knowing, and the handful of things the extension still cannot do. Every claim names its source at the end.

Last checked against Anthropic's VS Code extension documentation on November 17, 2026. By the Omniscio team. Updated .

On this page

The extension runs the same Claude Code as the terminal, so most of what you know transfers. If you have not installed the command-line version, the Mac install guide covers it, and Claude Code on Windows covers the Windows route.

What you need

Anthropic lists three things. VS Code 1.94.0 or later, an Anthropic account with a paid Claude subscription or a Console account, and a trusted workspace, because the extension does not work in VS Code's Restricted Mode.

Your VS Code version is under Help, then About. If the folder is in Restricted Mode, open the Command Palette and run Workspaces: Manage Workspace Trust, then trust the folder.

No API key is involved. You sign in when you first open the extension, the same way the terminal version asks you to.

Amazon Bedrock, Google Cloud Agent Platform and Microsoft Foundry work as third-party providers. On those, Anthropic notes that plan usage bars, voice dictation and the Web tab for cloud sessions are not offered.

Cursor works too. Anthropic gives it the same install link with a cursor: prefix, and everything below applies the same way.

Sources: the requirements and limits sections of Anthropic's VS Code extension page, read November 17, 2026.

Install it

Open the Extensions panel with Cmd+Shift+X on a Mac or Ctrl+Shift+X on Windows and Linux. Search for Claude Code, check that the publisher is Anthropic, and click Install.

Anthropic also publishes direct install links, which skip the search step:

vscode:extension/anthropic.claude-code
cursor:extension/anthropic.claude-code

If the extension does not appear after install, restart VS Code, or open the Command Palette with Cmd+Shift+P / Ctrl+Shift+P and run Developer: Reload Window.

One thing surprises people: the extension bundles its own copy of Claude Code for the chat panel, but it does not put claude on your PATH. If you also want the command in the integrated terminal, install the standalone version separately.

If that bundled copy is missing for your platform, the panel says so by name rather than starting a session: The Claude Code program for this computer, the build, could not be found.

Before installing anything, know that Anthropic treats extension marketplaces as third-party software it does not maintain or audit. Install from the publisher's own listing.

Sources: the install section and limits list of Anthropic's VS Code extension page, read November 17, 2026.

Open it and sign in

The quickest way in is the ✻ Spark icon in the editor toolbar, at the top right of the editor. It only appears while a file is open, which is why some people never notice it.

There are three other routes, and one of them works with nothing open. Click the Spark icon in the Activity Bar for the sessions list, use the Command Palette's Open in New Tab, or click ✻ Claude Code in the bottom-right status bar.

On first open, click Sign in and finish the authorisation in your browser. If the panel says Not logged in · Please run /login and no sign-in screen appears, run Developer: Reload Window.

A failed sign-in has its own causes, which the login errors guide works through. An extension that opens but misbehaves is a different problem, covered by the extension troubleshooting guide.

Source: the open-Claude-Code section of Anthropic's VS Code extension page, read November 17, 2026.

Using the prompt box

The prompt box is where most of the difference from the terminal shows. These are the parts Anthropic documents:

  • Permission modes sit at the bottom of the box: Auto, Manual, Plan, and Edit automatically. Auto lets a classifier review most actions instead of asking you.
  • Plan mode opens the plan as a Markdown document you can comment on inline before anything is edited. Type /plan with the task, for example /plan fix the auth bug.
  • @-mentions take a file or folder, with fuzzy matching, so @auth finds the auth files.
  • File and selection reference is Option+K on a Mac or Alt+K on Windows and Linux, which inserts something like @app.ts#5-10 for the lines you have selected.
  • Terminal output can be referenced as @terminal:name, so Claude reads the failing output rather than your description of it.
  • Shift+Enter adds a newline without sending, and /btw asks a side question without derailing the task.

Attachments work differently from the terminal. You attach an image by pasting it from the clipboard, and attach a file by holding Shift while dragging it into the prompt box.

Typing / opens the command menu, which holds the slash commands, output styles, hooks, permissions, memory, sandbox, export and more. The output styles guide covers the style picker in that menu.

Source: the prompt-box and command-menu sections of Anthropic's VS Code extension page, read November 17, 2026.

Keyboard shortcuts

Three are worth learning on the first day. Cmd+Esc or Ctrl+Esc moves focus between the editor and Claude, and Cmd+Shift+Esc or Ctrl+Shift+Esc opens a new conversation as an editor tab.

On Windows, Ctrl+Shift+Esc is also the system shortcut for Task Manager, so the operating system may take it first. VS Code's own Keyboard Shortcuts editor (Cmd+K Cmd+S) is where to rebind either one.

The third is the selection reference, Option+K or Alt+K, which needs the editor focused. It is the fastest way to say “this code” without typing a path.

Anthropic also documents these as macOS keys: Cmd+Shift+T to reopen the most recently closed Claude tab, Ctrl+Option+F for Focus view, and Cmd+D for voice dictation. Cmd+N for a new conversation only works once the setting enableNewConversationShortcut is set to true.

On macOS Tahoe and later the system can take Cmd+Esc for its Game Overlay shortcut. Clear Game Overlay under System Settings, Keyboard, Keyboard Shortcuts, Game Controllers, or rebind Claude Code: Focus input in VS Code's own Keyboard Shortcuts editor.

Source: the keyboard-shortcuts section of Anthropic's VS Code extension page, read November 17, 2026.

Settings worth changing

Settings live in two places. The extension's own settings are under Extensions, then Claude Code, in VS Code's settings (Cmd+, or Ctrl+,). Everything shared with the terminal lives in ~/.claude/settings.json.

Four of the extension settings change daily work. preferredLocation chooses a sidebar or a new tab. initialPermissionMode picks the starting mode. useTerminal switches the panel for terminal mode. autosave saves files before Claude reads or edits them, and is on by default.

attachOpenFile and attachSelection decide whether the open file and your selection go into every message, and both default to on. Turn them off if you would rather say what to look at each time.

For the shared file, where settings.json lives explains the levels and which one wins. Adding Anthropic's schema URL gives you autocomplete and validation for the fields.

Source: the settings section of Anthropic's VS Code extension page, read November 17, 2026.

What the extension cannot do

The extension is not the terminal with a nicer skin. Anthropic's comparison lists what is missing: no ! Bash shortcut, no tab completion, and only a subset of the CLI's commands and skills. Type / in the prompt box to see what your build offers.

The extension's version is the Claude Code version it bundles. A feature that needs Claude Code v2.1.286 needs extension version 2.1.286 or later, so an old extension is an old agent, whatever your CLI says. The Extensions panel shows the installed version.

Large diffs lose their per-change buttons. Per-change diff review arrived in v2.1.275, and Anthropic says a diff with more than 100 changes opens without those buttons.

Reloading VS Code does not restore every conversation. A sidebar conversation comes back only if it had activity in the last 10 minutes; otherwise resume it from Session history. An interrupted step continues after a reload, except when it was interrupted more than an hour earlier or the session is open elsewhere.

When you need something the extension lacks, run claude in VS Code's integrated terminal. That needs the standalone install, because the extension does not add the command to your PATH. From a terminal session, /ide connects it back to the editor, and claude --resume reopens a conversation you started in the panel.

For a message the extension prints that this page does not cover, the extension troubleshooting guide starts from the symptom.

Sources: the extension-versus-CLI comparison and the limits-and-caveats list on Anthropic's VS Code extension page, read November 17, 2026.

Running several sessions at once

The extension gives each conversation a tab, which is enough for two or three. Omniscio, the desktop app we make for running many Claude Code sessions at once, puts every session from every project in one window with a sidebar, and keeps them alive when the editor is closed.

It is free to use with up to 8 projects. Pro is $20/month or $192/year, and neither plan includes an AI allowance.

The multi-session guide compares every way to do it, and the sidebar guide covers watching several sessions at once.

Where these answers come from

  • Anthropic, Claude Code VS Code Extension: requirements, both install routes, the four ways to open it, the prompt box and command menu, every shortcut, the settings table, the extension-versus-CLI comparison, and the limits list. Read November 17, 2026.
  • Anthropic, Settings: the shared settings file at ~/.claude/settings.json. Read November 17, 2026.

The version numbers here are the ones Anthropic's own page named when it was read on November 17, 2026. Read it again before trusting an older copy.

Common questions

How do I install Claude Code in VS Code?

Press Cmd+Shift+X on a Mac or Ctrl+Shift+X on Windows and Linux, search for Claude Code, and click Install. The publisher is Anthropic and the extension id is anthropic.claude-code. If it does not appear afterwards, restart VS Code or run Developer: Reload Window from the Command Palette.

Does the VS Code extension need an API key?

No. It needs VS Code 1.94.0 or later and a paid Claude subscription or a Console account, and you sign in the first time you open it. Amazon Bedrock, Google Cloud Agent Platform and Microsoft Foundry are supported as third-party providers instead.

How do I open Claude Code in VS Code?

Click the Spark icon in the editor toolbar, which only appears while a file is open. The Spark icon in the Activity Bar opens the sessions list, the status bar's Claude Code entry works with no file open, and the Command Palette offers Open in New Tab.

What can the VS Code extension not do?

It has no ! Bash shortcut and no tab completion, and only a subset of the CLI's slash commands and skills. For those, run claude in VS Code's integrated terminal, which needs the standalone CLI installed because the extension does not add claude to your PATH.

Does the extension work in Restricted Mode?

No. The extension does not work in a Restricted Mode workspace. Open the folder as a trusted workspace and VS Code will load it normally.

Can I continue an extension conversation in the terminal?

Yes. Run claude --resume in the integrated terminal and pick the conversation. Going the other way, run /ide inside a terminal session to connect it to the editor.

Tabs are fine until you have six sessions

Omniscio runs many Claude Code sessions in one window, outside the editor. The features page lists what it does today.