# Additional Directories

> More folders Claude may read and edit, beside the first one.

**Field:** Artificial Intelligence  
**Category:** Claude Code  
**Also known as:** additionalDirectories, --add-dir, /add-dir

## Think of it like

It is like you open a door to a second room.

## Definition

Additional directories are extra folders Claude may read and edit, beside the one you started in. Add them with a flag, a command or a list in settings. They follow the same rules as the main folder. They give file access only. Most of their own settings do not load.

## Example

Jack's app uses a shared library in the next folder over. He adds it, and Claude can fix both in one session.

## Example code

```json
{
  "permissions": {
    "additionalDirectories": ["../shared-lib"]
  }
}
```

Let Claude work in a sibling folder too.

## Why it matters

Real work often spans two folders. This opens the second one and no more.

## Common mistake

Expecting the added folder's settings and hooks to load. It grants file access, not setup.

## Three principles

- **Flag, command or setting.** Three ways.
- **Same rules.** As the main folder.
- **Files only.** Not settings.

## Related terms

- [Primary Working Directory](https://learn.benibix.com/term/ai/primary-working-directory)
- [/add-dir Command](https://learn.benibix.com/term/ai/add-dir-command)
- [CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD](https://learn.benibix.com/term/ai/claude-code-additional-directories-claude-md-variable)
- [additionalDirectories Option](https://learn.benibix.com/term/ai/additional-directories-option)

## Told apart from

- [Additional Directories vs Primary Working Directory](https://learn.benibix.com/compare/additional-directories-vs-primary-working-directory): People think an added folder works just like the folder Claude Code started in. For files it does: Claude reads and edits both under the same rules. But only the start folder is a home for setup. Its settings, hooks, MCP servers and CLAUDE.md load. An added folder gives file access, and most of its setup stays asleep.

![The primary working folder, the added folders, and what lies outside them.](https://learn.benibix.com/diagrams/permission-working-directories.svg)

---

Source: https://learn.benibix.com/term/ai/additional-directories
Author: Behnia Zarei (a developer in Vienna, Austria, who builds and teaches data, AI and business intelligence at BENIBIX)
Publisher: BENIBIX Learn (https://learn.benibix.com/)
Last updated: 2026-11-17
Licence: CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/). Quote freely with attribution.
