# plansDirectory

> The key that sets the folder where plan mode saves its plans.

**Field:** Artificial Intelligence  
**Category:** Claude Code  
**Also known as:** plansDirectory setting

## Think of it like

It is like picking the shelf where your notes go.

## Definition

plansDirectory is a settings key that sets where Claude Code saves the plan files it writes in plan mode. The path is read from the project root. Left unset, plans go in ~/.claude/plans. If the path points outside the project root, Claude Code uses ~/.claude/plans instead.

## Example

Lucy wants her plans kept with the code so the team can read them. She sets plansDirectory to docs/plans.

## Example code

```json
{
  "plansDirectory": "docs/plans"
}
```

Keep plans in the repo, next to the docs.

## Why it matters

Plans in the repo can be read, reviewed and kept with the work they describe.

## Common mistake

Pointing it at a folder outside the repo, such as ../plans. Claude Code then falls back to ~/.claude/plans.

## Three principles

- **Where plans go.** From plan mode.
- **From the repo root.** A path.
- **Inside the repo.** Or it falls back.

## Related terms

- [Plan Mode](https://learn.benibix.com/term/ai/plan-mode)
- [~/.claude Directory](https://learn.benibix.com/term/ai/home-claude-directory)

---

Source: https://learn.benibix.com/term/ai/plans-directory-setting
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.
