CLAUDE_CODE_DESKTOP_PLUGIN_INSTALL_FRAMES
Updated by Alex Sorokoletov
CLAUDE_CODE_DESKTOP_PLUGIN_INSTALL_FRAMES is a Claude Code environment variable: When plugins are enabled, turns on desktop plugin install frames, then removes the variable from the environment. Added between v2.1.321 and v2.1.323 and still present in v2.1.324. It is not in the official reference.
| Status | Present in v2.1.324 |
|---|---|
| Added | Added between v2.1.321 and v2.1.323 |
| Category | Plugins and skills |
| Official docs | Not listed |
How to set it
For one session, export it in the shell that starts Claude Code:
export CLAUDE_CODE_DESKTOP_PLUGIN_INSTALL_FRAMES=<value>
claudeTo apply it to every session, add it to the env object of a settings file:
// ~/.claude/settings.json
{
"env": {
"CLAUDE_CODE_DESKTOP_PLUGIN_INSTALL_FRAMES": "<value>"
}
}Related variables
CLAUDE_CODE_DESKTOP_SKILLS_PLUGIN_DIR: Holds a directory path the desktop app passes for its skills plugin; the client reads it into the desktop-skills plugin directory, then clears it from the environment.CLAUDE_CODE_SYNC_PLUGIN_INSTALL: Install plugins synchronously (block until done).CLAUDE_CODE_COWORK_PLUGIN_SKILL: Enables the built-in plugin-building skill when set, provided another check does not already disable it.CLAUDE_CODE_DISABLE_PLUGIN_FORWARDING: When set, disables forwarding this machine's enabled plugins to cloud and remote sessions and hides the cloud-plugins setting.CLAUDE_CODE_ENABLE_BACKGROUND_PLUGIN_REFRESH: Enables automatic background plugin refresh when the runtime detects updates are needed.CLAUDE_CODE_PLUGIN_ATTRIBUTION: Provides per-plugin attribution metadata as JSON (fields such as marketplace name, server plugin id, installation preference and marketplace kind), looked up by plugin and used before the default source; capped at 65536 bytes.CLAUDE_CODE_PLUGIN_CACHE_DIR: Local cache directory for downloaded plugins.CLAUDE_CODE_PLUGIN_DIR_WATCH
Frequently asked questions
What does CLAUDE_CODE_DESKTOP_PLUGIN_INSTALL_FRAMES do?
When plugins are enabled, turns on desktop plugin install frames, then removes the variable from the environment.
Which Claude Code version has CLAUDE_CODE_DESKTOP_PLUGIN_INSTALL_FRAMES?
Added between v2.1.321 and v2.1.323 and still present in v2.1.324.
How do I set CLAUDE_CODE_DESKTOP_PLUGIN_INSTALL_FRAMES?
Export it before starting Claude Code (export CLAUDE_CODE_DESKTOP_PLUGIN_INSTALL_FRAMES=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.