# Primary Working Directory

> The folder you start Claude Code in, where it reads freely.

**Field:** Artificial Intelligence  
**Category:** Claude Code  
**Also known as:** cwd, launch folder

## Think of it like

It is like the room you are let into. You can look around it freely.

## Definition

The primary working directory is the folder you start Claude Code in. Claude can read files there without asking. Edits follow your permission mode. Project settings, CLAUDE.md and .mcp.json are all found from it. The /cd command moves the session to another one.

## Example

Lucy starts Claude Code in her app's folder. It reads every file there without a prompt, but asks before it reads her home folder.

## Example code

```console
$ cd ~/code/shop
$ claude
# primary working directory: ~/code/shop
```

Where you start is where it works.

## Why it matters

It is the line between free reads and asked reads, and where project settings come from.

## Common mistake

Starting in your home folder. Then every file you own is in reach without a prompt.

## Three principles

- **Where you start.** The launch folder.
- **Free reads.** Edits follow the mode.
- **/cd moves it.** Mid-session.

## Related terms

- [Additional Directories](https://learn.benibix.com/term/ai/additional-directories)
- [/cd Command](https://learn.benibix.com/term/ai/cd-command)
- [Project Trust](https://learn.benibix.com/term/ai/project-trust)

## 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/primary-working-directory
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.
