29 pages for --add-dir.

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… Orchestrate teams of Claude Code sessions Claude Code CLI · in the page agent-teams …inition that came from a project's `.claude/agents/` directory or an `--add-dir` directory only if you've [trusted the folder the agent file is in](/docs/en/permissions.md#what-runs-before-you-trust-a… Manage multiple agents with agent view Claude Code CLI · in the page agent-view …ig` and `--strict-mcp-config` * `--settings` * `--setting-sources` * `--add-dir` * `--plugin-dir` * `--fallback-model` * `--allow-dangerously-skip-permissions` Directories you added during the sessio… Share session output as artifacts Claude Code CLI · in the page artifacts …) without your approval, add its folder as a working directory with [`--add-dir`](/docs/en/cli-reference#cli-flags) at launch or `/add-dir` during the session. Claude already reads files in those dire… Claude Code changelog Claude Code CLI · in the page changelog …e the working directories without asking; add the file's folder with `--add-dir` for the rule to cover it * Fixed `/cost` and SDK `modelUsage` reporting a turn under the wrong model when the server an… 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 folders to a session](#add-folders-to-a-session) in local and SSH sessions, or select [several repositories](#ru… 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 …dit a sibling package or another repository from the same session | [`--add-dir`](#grant-access-across-packages-or-repositories) or `additionalDirectories` | | Give Claude procedures specific to one a… Connect Claude Code to tools via MCP Claude Code CLI · in the page mcp …ry](/docs/en/permissions.md#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 …**Windows**: map the share to a drive letter and pass the drive with `--add-dir` when you launch Claude Code, as [Working directories](#working-directories) describes. Reads under a drive you add late… Host and maintain a marketplace Claude Code CLI · in the page plugins/host-marketplace …en/settings-reference#extraknownmarketplaces). * **Command set in an `--add-dir` directory's settings**: the command is ignored, on a `url` source and on an [inline plugin entry](/docs/en/settings-ref… Plugin loading reference Claude Code CLI · in the page plugins/loading …s-live). | Source | Where you set it | Reaches | | :- | :- | :- | | `--add-dir` | `.claude/settings.json` or `.claude/settings.local.json` in a directory you pass with `--add-dir` | This session only… Configure the sandboxed Bash tool Claude Code CLI · in the page sandboxing ….md#additional-directories-grant-file-access-not-configuration) with `--add-dir`, `/add-dir`, or `permissions.additionalDirectories`. The first time a command needs a new network domain, Claude Code… 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… All settings Claude Code CLI · in the page settings-reference …ed from claude.ai](/docs/en/skills.md#where-synced-skills-load) * An `--add-dir` directory * [Plugins declared with a `.claude-plugin` manifest](/docs/en/plugins/loading#plugins-shared-through-a-repos… Extend Claude with skills Claude Code CLI · in the page skills …`.claude/skills/<skill-name>/SKILL.md` in a directory you pass with `--add-dir` | That session. See [directories outside the project](#skills-from-additional-directories) | | Plugin | `<plugin>/skill… Customize your status line Claude Code CLI · in the page statusline …rkspace.added_dirs` | Additional directories added via `/add-dir` or `--add-dir`. Empty array if none have been added | | `workspace.git_worktree` | Git worktree name when the current directory is ins… 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 …rectory](/docs/en/permissions.md#working-directories) you added with `--add-dir`, `/add-dir`, or `additionalDirectories` in settings. This includes commands Claude runs in response to your later messa… Week 20 · May 11–15, 2026 Claude Code CLI · in the page whats-new/2026-w20 …e-cost-tradeoff) Other wins `claude agents` gained dispatch flags (`--add-dir`, `--settings`, `--mcp-config`, `--plugin-dir`, `--permission-mode`, `--model`, `--effort`, `--dangerously-skip-permissi…