[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.
This issue has 4 comments on GitHub. Read the full discussion on GitHub ↗