---
title: "Run Claude Code inside a box"
description: "Run a coding agent in a throwaway box, so the code it writes and runs never touches your machine."
order: 6
verified:
  cli: "0.0.0-mock"
  date: "2026-10-20"
---

Run it with `vakna run --rm -- <agent>`: Vakna creates a box, runs the agent in it, and deletes the box when the agent exits.

## How do I run Claude Code in a box?

```sh
$ vakna run --rm -- claude -p "fix the failing test"
```

```prints
created box-1 · started in 0.41s · cold boot
ran claude -p fix the failing test · exit 0 0.40s
deleted box-1
```

`--rm` deletes the box afterwards. Leave it off to keep the box, its files and its history for a second look.

## How do I keep the box for later?

```sh
$ vakna run agent-1 -- claude -p "fix the failing test"
$ vakna suspend agent-1
```

```prints
created agent-1 · started in 0.41s · cold boot
ran claude -p fix the failing test · exit 0 0.40s
suspended agent-1 · compute not billed until it resumes 0.14s
```
