CLAUDE_CODE_PLUGIN_MCPB_DIR
Updated by Alex Sorokoletov
CLAUDE_CODE_PLUGIN_MCPB_DIR is a Claude Code environment variable: Sets the directory for plugin MCPB files; it is used only when it exists and lies outside the default cache directory, which otherwise supplies the 'mcpb' subfolder. Added in v2.1.324 and still present in v2.1.324. It is not in the official reference.
| Status | Present in v2.1.324 |
|---|---|
| Added | Added in v2.1.324 |
| Category | MCP |
| Official docs | Not listed |
How to set it
For one session, export it in the shell that starts Claude Code:
export CLAUDE_CODE_PLUGIN_MCPB_DIR=<value>
claudeTo apply it to every session, add it to the env object of a settings file:
// ~/.claude/settings.json
{
"env": {
"CLAUDE_CODE_PLUGIN_MCPB_DIR": "<value>"
}
}Related variables
CLAUDE_CODE_PLUGIN_REMOTE_MCP_REACHABLE_HOSTS_HINT: A comma-separated list of host patterns, with wildcards like *.CLAUDE_CODE_SKIP_PLUGIN_MCP_SERVERS: When set, skips discovering a plugin's MCP servers unless the plugin is exempted through CLAUDE_CODE_SKIP_PLUGIN_MCP_SERVERS_EXCEPT.CLAUDE_CODE_SKIP_PLUGIN_MCP_SERVERS_EXCEPT: Comma-separated list of plugins to exempt from the plugin MCP skip flags; an entry containing @ matches the plugin's repository, otherwise its name.CLAUDE_CODE_SKIP_PLUGIN_LOCAL_MCP_SERVERSCLAUDE_CODE_SKIP_PLUGIN_MCP_BUNDLESCLAUDE_CODE_ARTIFACT_MCP: Enables MCP runtime-capability support for artifacts; on by default.CLAUDE_CODE_CHROME_LATE_MCP_SERVER: When true, loads the alternate late Claude-in-Chrome MCP server module and skips installing the Chrome native host early.CLAUDE_CODE_CHROME_MCP_ORG_DENIED: When set, forces Claude-in-Chrome to be treated as denied by organization policy, with the cause reported as parent_org_policy.
Frequently asked questions
What does CLAUDE_CODE_PLUGIN_MCPB_DIR do?
Sets the directory for plugin MCPB files; it is used only when it exists and lies outside the default cache directory, which otherwise supplies the 'mcpb' subfolder.
Which Claude Code version has CLAUDE_CODE_PLUGIN_MCPB_DIR?
Added in v2.1.324 and still present in v2.1.324.
How do I set CLAUDE_CODE_PLUGIN_MCPB_DIR?
Export it before starting Claude Code (export CLAUDE_CODE_PLUGIN_MCPB_DIR=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.