# /add-dir Command

> It lets the session work in one more folder.

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

## Think of it like

It is like you open one more room. You keep the first one too.

## Definition

/add-dir gives the session one more folder to work in, besides the one it started in. Claude can then read and edit files there too. Most .claude settings in the added folder are not loaded, so its own skills and rules stay out. Most network paths cannot be added. The --add-dir flag does the same at start-up.

## Example

Jack's app uses a library that lives in a folder next to it. He runs /add-dir ../shared-lib, and Claude fixes the bug in both places in one go.

## Example code

```console
/add-dir ../shared-lib
```

Let Claude work in the shared library too.

## Why it matters

Real work often spans two folders. This lets one session see both without moving.

## Common mistake

Expecting the added folder's CLAUDE.md, skills and settings to load. Most of its .claude setup is not read.

## Three principles

- **One more folder.** The first one stays.
- **Read and edit.** In both.
- **Its setup stays out.** Most of .claude.

## Related terms

- [/cd Command](https://learn.benibix.com/term/ai/cd-command)
- [Permission Rule](https://learn.benibix.com/term/ai/permission-rule)
- [Working Directory](https://learn.benibix.com/term/development/working-directory)

## Told apart from

- [/add-dir vs /cd](https://learn.benibix.com/compare/add-dir-command-vs-cd-command): People often think /add-dir and /cd both just change folders. /add-dir keeps the folder the session started in and lets Claude work in a second one too. /cd moves the whole session to a new folder, so Claude works from there instead. Both keep the chat. Use /add-dir when the task needs both folders, and /cd when the work has moved.

## Taught in

- [Models, Goals and Folders](https://learn.benibix.com/learn/ai-claude-code-commands/models-goals-and-folders): Claude Code Commands, 6/17

![Two panels. With /add-dir the session keeps its folder and reaches a second one. With /cd the session leaves its folder and moves to another.](https://learn.benibix.com/diagrams/cmd-dirs.svg)

---

Source: https://learn.benibix.com/term/ai/add-dir-command
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.
