[DOCS] Improve documentation for VS Code setting `claude-code.claudeProcessWrapper` with usage examples on different platforms.

Resolved 💬 4 comments Opened Oct 28, 2025 by MatevzFa Closed Jan 9, 2026

Documentation Type

Missing documentation (feature not documented)

Documentation Location

_No response_

Section/Topic

VS Code Extension documentation, specifically for setting claude-code.claudeProcessWrapper.

Current Documentation

The docs currently say:

Executable path used to launch the Claude process.

What's Wrong or Missing?

The documentation does not clearly explain:

  • How the process should be launched (e.g., with what CLI flags),
  • What are the OS-specific intricacies.

See discussion under https://github.com/anthropics/claude-code/issues/8510#issuecomment-3450303154.

Suggested Improvement

The documentation should include:

  • How this setting is supposed to be used
  • What the user has to be mindful of on different platforms (Widows, Linux, macOS).

Impact

High - Prevents users from using a feature

Additional Context

Similarly to #8510, we want to use a wrapper that would set up the environment in which Claude will execute its commands. However, setting

"claudeCode.claudeProcessWrapper": "${workspaceFolder}/claudew.bat",

reports

ReferenceError: Claude Code native binary not found at ${workspaceFolder}/claudew.bat. Please ensure Claude Code is installed via native installer or specify a valid path with options.pathToClaudeCodeExecutable.

When launching Claude Code in VS Code.

View original on GitHub ↗

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