SpyBara
Go Premium

vs-code.md 2025-11-19 03:21 UTC to 2025-11-20 18:02 UTC

6 added, 6 removed.

2025
Thu 27 06:02 Wed 26 00:04 Tue 25 03:22 Mon 24 21:01 Fri 21 00:04 Thu 20 18:02 Wed 19 03:21 Tue 18 18:02 Mon 17 03:24 Sun 16 00:04 Fri 14 21:26 Thu 6 18:02 Tue 4 18:02 Mon 3 21:01 Sun 2 18:01 Sat 1 21:01

Visual Studio Code

Use Claude Code with Visual Studio Code through our native extension or CLI integration

Claude Code VS Code Extension Interface

VS Code Extension (Beta)

The VS Code extension, available in beta, lets you see Claude's changes in real-time through a native graphical interface integrated directly into your IDE. The VS Code extension makes it easier to access and interact with Claude Code for users who prefer a visual interface over the terminal.

Features

The VS Code extension provides:

  • Native IDE experience: Dedicated Claude Code sidebar panel accessed via the Spark icon
  • Plan mode with editing: Review and edit Claude's plans before accepting them
  • Auto-accept edits mode: Automatically apply Claude's changes as they're made
  • Extended thinking: Toggle extended thinking on/off using the Extended Thinking button in the bottom-right corner of the prompt input
  • File management: @-mention files or attach files and images using the system file picker
  • MCP server usage: Use Model Context Protocol servers configured through the CLI
  • Conversation history: Easy access to past conversations
  • Multiple sessions: Run multiple Claude Code sessions simultaneously
  • Keyboard shortcuts: Support for most shortcuts from the CLI
  • Slash commands: Access most CLI slash commands directly in the extension

Requirements

  • VS Code 1.98.0 or higher

Installation

Download and install the extension from the Visual Studio Code Extension Marketplace.

How It Works

Once installed, you can start using Claude Code through the VS Code interface:

  1. Click the Spark icon in your editor's sidebar to open the Claude Code panel
  2. Prompt Claude Code in the same way you would in the terminal
  3. Watch as Claude analyzes your code and suggests changes
  4. Review and accept edits directly in the interface
    • Tip: Drag the sidebar wider to see inline diffs, then click on them to expand for full details

Using Third-Party Providers

The VS Code extension supports using Claude Code with third-party providers like Amazon Bedrock, Microsoft Foundry, and Google Vertex AI. When configured with these providers, the extension will not prompt for login. To use third-party providers, configure environment variables in the VS Code extension settings:

  1. Open VS Code settings
  2. Search for "Claude Code: Environment Variables"
  3. Add the required environment variables

Environment Variables

Variable Description Required Example
CLAUDE_CODE_USE_BEDROCK Enable Amazon Bedrock integration Required for Bedrock "1" or "true"
CLAUDE_CODE_USE_FOUNDRY Enable Microsoft Foundry integration Required for Foundry "1" or "true"
CLAUDE_CODE_USE_VERTEX Enable Google Vertex AI integration Required for Vertex AI "1" or "true"
AWS_REGION AWS region for Bedrock "us-east-2"
AWS_PROFILE AWS profile for Bedrock authentication "your-profile"
CLOUD_ML_REGION Region for Vertex AI "global" or "us-east5"
ANTHROPIC_VERTEX_PROJECT_ID GCP project ID for Vertex AI "your-project-id"
ANTHROPIC_FOUNDRY_RESOURCE Azure resource name for Foundry Required for Microsoft Foundry "your-resource"
ANTHROPIC_FOUNDRY_API_KEY API key for Microsoft Foundry Optional for Microsoft Foundry "your-api-key"
ANTHROPIC_MODEL Override primary model Override model ID "us.anthropic.claude-sonnet-4-5-20250929-v1:0"
ANTHROPIC_SMALL_FAST_MODEL Override small/fast model Optional "us.anthropic.claude-3-5-haiku-20241022-v1:0"
CLAUDE_CODE_SKIP_AUTH_LOGIN Disable all prompts to login Optional "1" or "true"

For detailed setup instructions and additional configuration options, see:

Not Yet Implemented

The following features are not yet available in the VS Code extension:

  • MCP server and Plugin configuration UI: Type /mcp to open the terminal-based MCP server configuration, or /plugin for Plugin configuration. Once configured, MCP servers and Plugins will work in the extension. You can also configure MCP servers through the CLI first, then the extension will use them.
  • Subagents configuration: Configure subagents through the CLI to use them in VS Code
  • Checkpoints: Save and restore conversation state at specific points
  • Conversation rewinding: The /rewind command is coming soon
  • Advanced shortcuts:
    • # shortcut to add to memory (not supported)
    • ! shortcut to run bash commands directly (not supported)
  • Tab completion: File path completion with tab key
  • Model selection UI for older models: To use older model versions like claude-sonnet-4-20250514, open VS Code settings for Claude Code (the /General Config command) and insert the model string directly into the 'Selected Model' field

We are working on adding these features in future updates.

Security Considerations

When Claude Code runs in VS Code with auto-edit permissions enabled, it may be able to modify IDE configuration files that can be automatically executed by your IDE. This may increase the risk of running Claude Code in auto-edit mode and allow bypassing Claude Code's permission prompts for bash execution.

When running in VS Code, consider:

  • Enabling VS Code Restricted Mode for untrusted workspaces
  • Using manual approval mode for edits
  • Taking extra care to ensure Claude is only used with trusted prompts

Legacy CLI Integration

The first VS Code integration that we released allows Claude Code running in the terminal to interact with your IDE. It provides selection context sharing (current selection/tab is automatically shared with Claude Code), diff viewing in the IDE instead of terminal, file reference shortcuts (Cmd+Option+K on Mac or Alt+Ctrl+K on Windows/Linux to insert file references like @File#L1-99), and automatic diagnostic sharing (lint and syntax errors).

The legacy integration auto-installs when you run claude from VS Code's integrated terminal. Simply run claude from the terminal and all features activate. For external terminals, use the /ide command to connect Claude Code to your VS Code instance. To configure, run claude, enter /config, and set the diff tool to auto for automatic IDE detection.

Both the extension and CLI integration work with Visual Studio Code, Cursor, Windsurf, and VSCodium.

Troubleshooting

Extension Not Installing

  • Ensure you have a compatible version of VS Code (1.85.0 or later)
  • Check that VS Code has permission to install extensions
  • Try installing directly from the Marketplace website

Claude Code Never Responds

If Claude Code is not responding to your prompts:

  1. Check your internet connection: Ensure you have a stable internet connection
  2. Start a new conversation: Try starting a fresh conversation to see if the issue persists
  3. Try the CLI: Run claude from the terminal to see if you get more detailed error messages
  4. File a bug report: If the problem continues, file an issue on GitHub with details about the error

Legacy Integration Not Working

  • Ensure you're running Claude Code from VS Code's integrated terminal
  • Ensure the CLI for your IDE variant is installed:
    • VS Code: code command should be available
    • Cursor: cursor command should be available
    • Windsurf: windsurf command should be available
    • VSCodium: codium command should be available
  • If the command isn't installed:
    1. Open command palette with Cmd+Shift+P (Mac) or Ctrl+Shift+P (Windows/Linux)
    2. Search for "Shell Command: Install 'code' command in PATH" (or equivalent for your IDE)

For additional help, see our troubleshooting guide.