# sandbox.filesystem.allowWrite

> A list of more folders that fenced commands may write to.

**Field:** Artificial Intelligence  
**Category:** Claude Code  
**Also known as:** allowWrite

## Think of it like

It is like giving a child one more room to draw in.

## Definition

sandbox.filesystem.allowWrite is a settings key that opens more folders for writing. By default a fenced command may write only in a few spots. Those are the work folder, the temp folder and folders added with /add-dir. Add a path when a tool such as kubectl must write somewhere else. On Linux, the path must exist first.

## Example

Emma's build writes to /tmp/build and fails in the sandbox. She adds that path to allowWrite, and the build works.

## Example code

```json
{
  "sandbox": {
    "filesystem": {
      "allowWrite": ["~/.kube", "/tmp/build"]
    }
  }
}
```

Let kubectl and the build write outside the project.

## Why it matters

It opens just the one folder a tool needs. The rest of the fence stays up.

## Common mistake

Adding a Linux path that does not exist yet. The entry does nothing until the folder is made.

## Three principles

- **Extra write paths.** Beyond the project.
- **Default is narrow.** Project, temp.
- **Linux: path must exist.** Make it first.

## Related terms

- [sandbox.filesystem.denyWrite](https://learn.benibix.com/term/ai/sandbox-deny-write-setting)
- [/add-dir Command](https://learn.benibix.com/term/ai/add-dir-command)
- [sandbox.enabled](https://learn.benibix.com/term/ai/sandbox-enabled-setting)

![What a sandboxed command may read and write: write is open only in the project and a few folders, read is open almost everywhere, and the deny and allow keys cut holes in both.](https://learn.benibix.com/diagrams/sandbox-filesystem-rules.svg)

---

Source: https://learn.benibix.com/term/ai/sandbox-allow-write-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-16
Licence: CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/). Quote freely with attribution.
