[DOCS] VS Code docs should clarify relationship between vscode.dev and Claude Code on the web

Open 💬 6 comments Opened Feb 16, 2026 by coygeek

Documentation Type

Missing documentation (feature not documented)

Documentation Location

https://code.claude.com/docs/en/vs-code

Section/Topic

The VS Code extension page and the "Claude Code on the web" page both lack any mention of vscode.dev, which is a common source of confusion for users who encounter vscode.dev/github/... links and assume they relate to "Claude Code on the web."

Current Documentation

The VS Code extension page (https://code.claude.com/docs/en/vs-code) documents the desktop VS Code extension.

The "Claude Code on the web" page (https://code.claude.com/docs/en/claude-code-on-the-web) documents claude.ai/code, which runs tasks on Anthropic-managed VMs.

Neither page mentions vscode.dev or explains how it relates (or doesn't) to these surfaces.

What's Wrong or Missing?

Users encountering vscode.dev/github/{owner}/{repo} URLs (a Microsoft feature that opens GitHub repos in VS Code for the Web) may confuse this with "Claude Code on the web" (claude.ai/code). The two are entirely different:

  • vscode.dev is Microsoft's browser-based VS Code editor — it opens GitHub repos in a lightweight web editor
  • Claude Code on the web (claude.ai/code) runs Claude Code on Anthropic-managed VMs

The documentation never addresses this distinction. A user searching "Claude Code vscode.dev" or "Claude Code web" gets no guidance on which surface they're using or whether the Claude Code extension works in vscode.dev.

Suggested Improvement

Add a brief clarification to the VS Code extension page, either in the "Fix common issues" section or as a new FAQ entry:

Suggested addition:

Note: vscode.dev (VS Code for the Web) is a Microsoft feature for editing GitHub repositories in a browser — it is separate from "Claude Code on the web" (claude.ai/code). The Claude Code VS Code extension requires VS Code desktop (1.98.0+). For running Claude Code tasks in the browser, use Claude Code on the web.

Impact

Medium - Makes feature difficult to understand

Additional Context

Affected Pages:
| Page | Issue |
|------|-------|
| https://code.claude.com/docs/en/vs-code | No mention of vscode.dev or disambiguation |
| https://code.claude.com/docs/en/claude-code-on-the-web | No mention of vscode.dev or disambiguation |

Total scope: 2 pages affected

The term "vscode.dev" appears zero times across the entire Claude Code documentation. Given that users commonly encounter vscode.dev/github/... URLs when browsing GitHub repositories, a clarification would reduce support burden.

View original on GitHub ↗

This issue has 6 comments on GitHub. Read the full discussion on GitHub ↗