Skip to content
BENIBIX Learn

Primary Working Directory

AI⌨️ Claude CodeConfiguration

Also known as cwd, launch folder

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

Think of it like

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

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.

Why it matters

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

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 code

console
$ cd ~/code/shop
$ claude
# primary working directory: ~/code/shop
Where you start is where it works.
The inner box is this folder.

Common mistake

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

Key takeaways

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

Compare