[DOCS] VS Code docs should clarify relationship between vscode.dev and Claude Code on the web
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.
This issue has 6 comments on GitHub. Read the full discussion on GitHub ↗