> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mirage.strukto.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Claude Code

> Connect Claude Code to a Mirage workspace through the CLI or a FUSE mount.

| Way | Claude Code gets | Needs |
| - | - | - |
| [CLI](#cli) | Mirage's seven tools, beside its own | the `mirage` CLI |
| [FUSE](#fuse) | its own tools, on the workspace as a folder | a [FUSE driver](/home/setup/fuse) |

## Install

```bash theme={null}
npm install -g @struktoai/mirage-cli
```

On macOS, FUSE also needs the [macFUSE 4 workaround](/typescript/setup/fuse#macos-4-symlink-workaround). Install [Claude Code](https://docs.claude.com/en/docs/claude-code/setup) separately.

## Workspace

```yaml workspace.yaml theme={null}
mode: write
mounts:
  /:
    vfs: ram
    backend: fuse                 # FUSE only
    mountpoint: /tmp/mirage-demo  # FUSE only
  /s3:
    vfs: s3
    mode: read
    config:
      bucket: my-bucket
```

```bash theme={null}
mirage workspace create workspace.yaml --id demo
```

## CLI

```bash theme={null}
claude mcp add mirage -- mirage mcp -w demo
```

Claude Code gets `shell`, `read`, `write`, `edit`, `ls`, `grep` and `glob` from the workspace's [MCP server](/home/access/mcp).

## FUSE

```bash theme={null}
cd /tmp/mirage-demo && claude
```

Every file and shell call Claude Code makes goes through Mirage: `/tmp/mirage-demo/s3` is the bucket. `mirage workspace delete demo` unmounts it. On macOS the daemon holds one FUSE mount at a time.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.