Search the documentation
25 pages for --add-dir.
Titles and paths first, then pages whose text carries it. Each row opens that page as this site last read it.
Use Claude Code features in the SDK
Claude Code CLI · in the page
agent-sdk/claude-code-features
…ories` or `add_dirs` option, which the SDK passes to Claude Code as [`--add-dir`](/docs/en/permissions#additional-directories-grant-file-access-not-configuration) | | `"user"` | User `settings.json…
Agent SDK reference - Python
Claude Code CLI · in the page
agent-sdk/python
…ories Claude can access. The SDK passes each entry to Claude Code as `--add-dir`, so with the `project` setting source Claude Code also [loads the directory's skills, commands, and subagents](/docs/en…
Extend agents with skills
Claude Code CLI · in the page
agent-sdk/skills
…Python), because the SDK passes those directories to Claude Code as [`--add-dir`](/docs/en/skills#skills-from-additional-directories). If you set `settingSources` explicitly, include `'project'` to ke…
Subagents in the SDK
Claude Code CLI · in the page
agent-sdk/subagents
…Python) or `additionalDirectories` (TypeScript) option, or the CLI's `--add-dir` or `/add-dir`, but doesn't watch them, so a new or edited file there needs a session restart. * **A programmatic agent…
Agent SDK reference - TypeScript
Claude Code CLI · in the page
agent-sdk/typescript
…ories Claude can access. The SDK passes each entry to Claude Code as `--add-dir`, so with the `project` setting source Claude Code also [loads the directory's skills, commands, and subagents](/docs/en…
Manage multiple agents with agent view
Claude Code CLI · in the page
agent-view
…effect: * `--mcp-config` and `--strict-mcp-config` * `--settings` * `--add-dir` * `--plugin-dir` * `--fallback-model` * `--allow-dangerously-skip-permissions` Directories you added during the sessio…
Claude Code changelog
Claude Code CLI · in the page
changelog
…lper` in a project `.mcp.json`, and inline MCP servers in project or `--add-dir` agent files, now require that folder's trust dialog to have been accepted (also under `claude -p`) * MCP `headersHelp…
CLI reference
Claude Code CLI · in the page
cli-reference
…/agent-view#permission-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 ter…
Desktop application
Claude Code CLI · in the page
desktop
…"; on Team and Enterprise plans, organization policy controls it | | `--add-dir` | Add multiple repos with the **+** button in cloud sessions…
Environment variables
Claude Code CLI · in the page
env-vars
…| Set to `1` to load memory files from directories specified with `--add-dir`. Loads `CLAUDE.md`, `.claude/CLAUDE.md`, `.claude/rules/*.md`, and `CLAUDE.local.md`. By default, additional directorie…
Glossary
Claude Code CLI · in the page
glossary
…memory, or CLAUDE.md, apart from skills in a directory you pass with `--add-dir`. Recommended for CI and scripted calls where you need the same result on every machine. Learn more: [Start faster with…
Run Claude Code programmatically
Claude Code CLI · in the page
headless
…t run, because bare mode never reads them. A directory you name with `--add-dir` is a partial exception: bare mode loads skills from its `.claude/skills/` folder, but still skips its `.claude/commands…
Hooks reference
Claude Code CLI · in the page
hooks
…Code doesn't fire this event when: * You pass a directory with the `--add-dir` startup flag; [SessionStart](#sessionstart) covers those directories * You add a directory on the `/permissions` Worksp…
Set up Claude Code in a monorepo or large codebase
Claude Code CLI · in the page
large-codebases
…another repository from the same session | [`--add-dir`](#grant-access-across-packages-or-repositories) or `additionalDirectories` | | Give Claude procedures specific to on…
Connect Claude Code to tools via MCP
Claude Code CLI · in the page
mcp
…ctory](/docs/en/permissions#working-directories) you've granted with `--add-dir`, `/add-dir`, or the `additionalDirectories` setting. Claude Code sends `notifications/roots/list_changed` when that set…
How Claude remembers your project
Claude Code CLI · in the page
memory
…comments remain visible. #### Load from additional directories The `--add-dir` flag gives Claude access to additional directories outside your main working directory. By default, CLAUDE.md files fro…
Configure permissions
Claude Code CLI · in the page
permissions
…r-directory). You can extend this access: * **During startup**: use `--add-dir <path>` CLI argument * **During session**: use `/add-dir` command * **Persistent configuration**: add to `additionalDire…
Create and distribute a plugin marketplace
Claude Code CLI · in the page
plugin-marketplaces
…etplaces) depending on which file declares it. * **Command set in an `--add-dir` directory's settings**: Claude Code ignores it, on a `url` source and on an [inline plugin entry](/docs/en/settings-ref…
Manage sessions
Claude Code CLI · in the page
sessions
…ings`, `--plugin-dir`, `--fallback-model`, or directories added with `--add-dir`, pass them again when you resume; directories added mid-session with `/add-dir` aren't restored either, though the sess…
Claude Code settings reference
Claude Code CLI · in the page
settings-reference
…of directory paths * **Default**: unset * **Per-session overrides**: `--add-dir` and `/add-dir` add directories for one session alongside this key ```json settings.json theme={null} { "permissions"…
Extend Claude with skills
Claude Code CLI · in the page
skills
…s/`, the project `.claude/skills/`, or a `.claude/skills/` inside an `--add-dir` directory, Claude Code picks up the change within the current session, without a restart. If you create a top-level ski…
Customize your status line
Claude Code CLI · in the page
statusline
…| Additional directories added via `/add-dir` or `--add-dir`. Empty array if none have been added…
Create custom subagents
Claude Code CLI · in the page
sub-agents
…ion closest to the working directory. When you add a directory with `--add-dir` or `/add-dir`, Claude Code also loads its `.claude/agents/` folder, alongside your project subagents. See [Additional d…
Tools reference
Claude Code CLI · in the page
tools-reference
…directory](/docs/en/permissions#working-directories) you added with `--add-dir`, `/add-dir`, or `additionalDirectories` in settings. Subagent sessions never carry over working directory changes. *…
Week 20 · May 11–15, 2026
Claude Code CLI · in the page
whats-new/2026-w20
…id"> <div><code>claude agents</code> gained dispatch flags (<code>--add-dir</code>, <code>--settings</code>, <code>--mcp-config</code>, <code>--plugin-dir</code>, <code>--permission-mode</code>, <…