40 pages for --plugin-dir.

Manage multiple agents with agent view Claude Code CLI · in the page agent-view …ict-mcp-config` * `--settings` * `--setting-sources` * `--add-dir` * `--plugin-dir` * `--fallback-model` * `--allow-dangerously-skip-permissions` Directories you added during the session with [`/add-… Claude Code changelog Claude Code CLI · in the page changelog …rojects on exFAT or FAT32 drives, including in sessions started with `--plugin-dir` * \[VSCode] Fixed text after an unclosed code block in a list showing as plain text while a reply streams, then turn… CLI reference Claude Code CLI · in the page cli-reference …ermission-mode-model-and-effort). Accepts `--settings`, `--add-dir`, `--plugin-dir`, and `--mcp-config` like the top-level `claude` command. Opening agent view requires an interactive terminal… Run Claude Code programmatically Claude Code CLI · in the page headless …hoose-the-subagent-scope) | `--agents <file-or-json>` | | A plugin | `--plugin-dir <path>`, `--plugin-url <url>` | Bare mode also limits what happens while the session runs: * **MCP servers**: only… Deploy managed settings Claude Code CLI · in the page managed-settings …ags`](/docs/en/settings-reference#disablesideloadflags) | Reject the `--plugin-dir`, `--plugin-url`, `--agents`, and `--mcp-config` flags at startup. In cloud sessions, Claude Code instead starts the… Choose a permission mode Claude Code CLI · in the page permission-modes …ession started without `--restricted` * A directory you loaded with [`--plugin-dir`](/docs/en/plugins/mods/create#change-a-mod-with-claude), because Claude Code reloads and runs a mod's code from it w… Test plugins with evals Claude Code CLI · in the page plugin-evals …as you. Pointing it at a plugin is the same trust decision as `claude --plugin-dir`, so only evaluate plugins you trust. The isolation described in this section limits what the agent under test can r… Plugin commands reference Claude Code CLI · in the page plugins/cli-reference …: plugins you installed from a marketplace * **`Session-only plugins (--plugin-dir / --plugin-url):`**: plugins loaded by those flags in the same command, as in `claude --plugin-dir ./my-plugin plugin… Code intelligence plugins Claude Code CLI · in the page plugins/code-intelligence …nd and the file extensions it handles. 2. Then load the plugin with [`--plugin-dir`](/docs/en/plugins/cli-reference#flags-that-load-a-plugin-for-one-session) or publish it to a marketplace. For the f… Create a Claude Code plugin Claude Code CLI · in the page plugins/create …lugin whose only component is one skill, a greeting, and run it with `--plugin-dir`, which loads a plugin for one session without installing it. A plugin can hold any mix of [components](/docs/en/plug… Create a marketplace Claude Code CLI · in the page plugins/create-marketplace …anthropics-directory). > * **Using a plugin yourself**: load it with `--plugin-dir` or save it in your skills directory. See [Develop without a marketplace](/docs/en/plugins/create#develop-without-a-m… Plugin dependencies Claude Code CLI · in the page plugins/dependencies …the same time, start Claude Code from your shell and load both with [`--plugin-dir`](/docs/en/plugins/cli-reference#flags-that-load-a-plugin-for-one-session): ```bash theme={null} claude --plugin-dir… Install and manage plugins Claude Code CLI · in the page plugins/install …copy of your plugin on disk, start Claude Code from your shell with `--plugin-dir` to load it for one session instead of installing it. See [Flags that load a plugin for one session](/docs/en/plugins… Plugin loading reference Claude Code CLI · in the page plugins/loading ….claude/plugins/`: [Find plugins on disk](#find-plugins-on-disk) * A `--plugin-dir` plugin didn't load, or a same-named plugin loaded instead: [Name conflicts](#name-conflicts) * A plugin under `~/.cl… Plugin manifest reference Claude Code CLI · in the page plugins/manifest-reference …lace entry, or from the directory name when you load the plugin with `--plugin-dir`. Write a manifest when you want metadata, a component outside its default directory, `userConfig`, or an inline com… Marketplace reference Claude Code CLI · in the page plugins/marketplace-reference …t don't come from a marketplace**: `inline` for plugins loaded with [`--plugin-dir`](/docs/en/cli-reference), `builtin` for built-in plugins, `skills-dir` for plugins auto-loaded from [`.claude/skills… Measure plugin cost and usage Claude Code CLI · in the page plugins/measure …n has to be loaded: installed, in a skills directory, or passed with `--plugin-dir` in the same command, as in `claude --plugin-dir ./formatter plugin details formatter`. This example reads an instal… Manage mods for your organization Claude Code CLI · in the page plugins/mods/admin …that covers a mod in a plugin the user installed, a mod loaded with `--plugin-dir`, and a mod [Claude wrote during a session](/docs/en/plugins/mods/create#ask-claude-for-a-mod) * **Your organization'… Create a mod Claude Code CLI · in the page plugins/mods/create …to load it: * **In a session you start**: in your shell, run `claude --plugin-dir ~/mods/git-branch` * **For other people**: [add it to a marketplace](#share-your-mod) so they can install it ### Ses… Interface gallery for mods Claude Code CLI · in the page plugins/mods/gallery …from the directory that holds `gallery`: ```bash theme={null} claude --plugin-dir ./gallery ``` At the Claude Code prompt, run `/gallery`. A pane opens with `Plain text` in it. **3. Swap in a sampl… Draw in the interface with a mod Claude Code CLI · in the page plugins/mods/interface …**3. Open the pane** In your shell, start Claude Code with `claude --plugin-dir ./hello-tabs`. At the Claude Code prompt, run `/hello-tabs`. A pane opens with `1: One` and `2: Two` across the top.… Mods overview Claude Code CLI · in the page plugins/mods/overview …/en/plugins/create#load-a-directory-or-archive-for-one-session) with `--plugin-dir`. To confirm the mod loaded, [check which mods the session loaded](#see-which-mods-a-session-loaded). To keep one, [… Mods reference Claude Code CLI · in the page plugins/mods/reference …r `env` in `~/.claude/settings.json` | Plugin directories to load as `--plugin-dir` does, for apps you can't pass a flag to. Absolute paths separated by `:`, or `;` on Windows. | | `CLAUDE_CODE_PLUGIN… Troubleshoot a mod Claude Code CLI · in the page plugins/mods/troubleshoot …ne in the transcript. That's an interactive session you started with `--plugin-dir`, or one where you [enabled hot reloading](/docs/en/plugins/mods/create#ask-claude-for-a-mod) for mods Claude wrote.… Manage Claude Code plugins for your organization Claude Code CLI · in the page plugins/org …ad. A managed entry also overrides a same-name marketplace entry or `--plugin-dir` copy from another source: * **Marketplaces**: a managed marketplace entry replaces a lower-precedence entry with th… Plugins overview Claude Code CLI · in the page plugins/overview …you don't need a marketplace: load it straight from its folder with `--plugin-dir`, as [Develop without a marketplace](/docs/en/plugins/create#develop-without-a-marketplace) shows. ### Make an insta… Publish and distribute a plugin Claude Code CLI · in the page plugins/publish …r one session**: they start Claude Code from their shell with `claude --plugin-dir ./deploy-helper`, where the path is the clone, the unzipped folder, or the `.zip` itself. See [Flags that load a plug… Plugin security and trust Claude Code CLI · in the page plugins/security …ne the repository that holds the plugin's directory, then run `claude --plugin-dir <plugin directory> plugin details <plugin name>` in your shell to see what Claude Code finds in it. The command reads… Troubleshoot plugins Claude Code CLI · in the page plugins/troubleshooting …e plugin validate` didn't check `.mcp.json`. #### Server works with `--plugin-dir` but fails after install You're the plugin's author, and the server starts when you load the plugin from its source… How Claude Code uses prompt caching Claude Code CLI · in the page prompt-caching …/create#load-a-directory-or-archive-for-one-session) you passed with `--plugin-dir`, the change applies right away. If applying it would trigger a full re-read, Claude Code holds the change instead an… Manage sessions Claude Code CLI · in the page sessions …s restored. If the session depended on `--mcp-config`, `--settings`, `--plugin-dir`, `--fallback-model`, or directories added with `--add-dir`, pass them again when you resume; directories added mid-s… Claude Code settings Claude Code CLI · in the page settings …sableSideloadFlags` | (Managed settings only) Reject the `--plugin-dir`, `--plugin-url`, `--agents`, and `--mcp-config` CLI flags at startup, which users could otherwise pass to bypass [`s… Week 19 · May 4–8, 2026 Claude Code CLI · in the page whats-new/2026-w19 …#2-1-128) 2 features · May 4–8 Plugins from .zip archives and URLs `--plugin-dir` now accepts a `.zip` plugin archive in addition to a directory, and the new `--plugin-url` flag fetches a plugin arc… Week 20 · May 11–15, 2026 Claude Code CLI · in the page whats-new/2026-w20 …s` gained dispatch flags (`--add-dir`, `--settings`, `--mcp-config`, `--plugin-dir`, `--permission-mode`, `--model`, `--effort`, `--dangerously-skip-permissions`) to configure background sessions, and… Week 37 · September 7–11, 2026 Claude Code CLI · in the page whats-new/2026-w37 …atform, and Microsoft Foundry; any higher level runs at the capPoint `--plugin-dir` at a folder of plugins to [load each immediate subfolder that has a manifest](/docs/en/plugins/create#load-a-directo… What's new Claude Code CLI · in the page whats-new/index …6-w20) **Week 19** **Plugins load from `.zip` archives and URLs**: `--plugin-dir` now accepts `.zip` files, and `--plugin-url` fetches a plugin archive for the current session. Also this week: **`w… Build for Claude Claude Documentation · in the page build/overview …o check the manifest and component files before you push * **[`claude --plugin-dir`](https://code.claude.com/docs/en/plugins/create#load-a-directory-or-archive-for-one-session)**: start Claude Code wi… Plugin structure and testing Claude Documentation · in the page plugins/build …on each surface your users will use. * **Claude Code**: run `claude --plugin-dir ./expense-reports` to start a session with the plugin loaded from your working copy. Your skills appear as `/expense-… Plugin feature support across platforms Claude Documentation · in the page plugins/platform-support …m a file | **Add > Upload plugin** with a zip of the folder | `claude --plugin-dir <path>` for one session | [Plugin structure and testing](/docs/plugins/build#test-the-plugin-on-each-surface) | | Bro… Build your first plugin Claude Documentation · in the page plugins/quickstart …ude Code session with the plugin loaded: ```bash theme={null} claude --plugin-dir ./expense-reports ``` In that session, your skill appears as `/expense-reports:file-expense`. If you added the conne…