[DOCS] VS Code extension data storage path undocumented beyond uninstall cleanup

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 path ~/.vscode/globalStorage/anthropic.claude-code/ is mentioned only in the "Uninstall the extension" section as a cleanup target. There is no documentation about what this directory contains or how it relates to conversation history.

Current Documentation

The only mention of this path is in the uninstall section:

To also remove extension data and reset all settings: `` rm -rf ~/.vscode/globalStorage/anthropic.claude-code ``

No other page documents what is stored in this directory.

What's Wrong or Missing?

Users have no documentation explaining:

  1. What's stored in ~/.vscode/globalStorage/anthropic.claude-code/ (conversation history, session state, OAuth tokens, extension data)
  2. How conversation history relates between the extension and CLI — the VS Code page says "The extension and CLI share the same conversation history" but doesn't explain where that history is stored
  3. How to back up or migrate this data when switching machines

A user asking "where are my Claude Code conversations stored?" has no answer in the documentation. The only hint is a destructive rm -rf command in the uninstall section.

Suggested Improvement

Add a brief subsection to either the "Configure settings" section of the VS Code page or to the Settings page under "Other configuration":

Suggested addition:

### Extension data storage The VS Code extension stores conversation history, session state, and extension data in: `` ~/.vscode/globalStorage/anthropic.claude-code/ ` This directory is shared between the VS Code extension and the CLI — conversations started in the extension can be resumed with claude --resume` in the terminal, and vice versa. To back up your conversation history, copy this directory. To reset the extension completely, delete it.

Impact

Medium - Makes feature difficult to understand

Additional Context

Affected Pages:
| Page | Issue |
|------|-------|
| https://code.claude.com/docs/en/vs-code | Path only mentioned in uninstall section, not explained |
| https://code.claude.com/docs/en/settings | "Other configuration" section mentions ~/.claude.json but not extension storage |

Total scope: 2 pages affected

Users migrating between machines, troubleshooting lost conversations, or auditing what Claude Code stores on disk need this information.

View original on GitHub ↗

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