CLAUDE_CODE_PROCESS_WRAPPER

Launch the processes Claude Code starts from its own binary through a wrapper executable, given as an argv prefix such as /opt/corp/launcher. Covers the background service that hosts agent view sessions, every session it spawns, and the relaunch Claude Code performs of itself to finish installing an update. The first token must be the absolute path of an executable that ends by running exec "$@", and most launchers are that single path. The value is an argument list, not a shell command: whitespace separates tokens, double quotes group a path that contains spaces, and a value that starts with is read as a JSON string array. Set it in the env block of user or [managed settings, not as a shell export, so the detached background service inherits it; project and local settings can't set it. The VS Code extension configures its own launcher separately through its claudeProcessWrapper setting. Ignored on Windows. CLAUDE_CODE_SHELL_PREFIX is a separate control: it wraps the shell commands Claude runs as a single quoted string, while this variable wraps Claude Code's own processes as an argv prefix. See Run Claude Code behind a corporate launcher