CLAUDE_CODE_WORKSPACE_HOST_PATHS
Updated by Alex Sorokoletov
CLAUDE_CODE_WORKSPACE_HOST_PATHS is a Claude Code environment variable: Specifies host-side filesystem paths that should be mapped or accessible within a workspace context. This is relevant for containerized and remote development scenarios where Claude Code runs inside a devcontainer or remote environment but needs to reference files on the host machine. Added between v2.1.77 and v2.1.79 and still present in v2.1.310. It is not in the official reference.
| Status | Present in v2.1.310 |
|---|---|
| Added | Added between v2.1.77 and v2.1.79 |
| Category | Other |
| Official docs | Not listed |
How to set it
For one session, export it in the shell that starts Claude Code:
export CLAUDE_CODE_WORKSPACE_HOST_PATHS=<value>
claudeTo apply it to every session, add it to the env object of a settings file:
// ~/.claude/settings.json
{
"env": {
"CLAUDE_CODE_WORKSPACE_HOST_PATHS": "<value>"
}
}Release notes that mention it
Related variables
CLAUDE_RUNNER_WORKSPACE_PATHSANTHROPIC_WORKSPACE_IDCLAUDE_CODE_HOST_PLATFORM: Override platform detection: win32, darwin, linux.CLAUDE_AI_HOSTCLAUDE_ARTIFACT_HOST_GRANTCLAUDE_CODE_AUTOUPDATER_DISABLED_BY_HOSTCLAUDE_CODE_HOST_CREDS_FILECLAUDE_CODE_HOST_GATEWAY_LINEAGE
Frequently asked questions
What does CLAUDE_CODE_WORKSPACE_HOST_PATHS do?
Specifies host-side filesystem paths that should be mapped or accessible within a workspace context. This is relevant for containerized and remote development scenarios where Claude Code runs inside a devcontainer or remote environment but needs to reference files on the host machine.
Which Claude Code version has CLAUDE_CODE_WORKSPACE_HOST_PATHS?
Added between v2.1.77 and v2.1.79 and still present in v2.1.310.
How do I set CLAUDE_CODE_WORKSPACE_HOST_PATHS?
Export it before starting Claude Code (export CLAUDE_CODE_WORKSPACE_HOST_PATHS=value), or add it to the "env" object in ~/.claude/settings.json to apply it to every session.
All variables, searchable: Claude Code environment variables.