Run Claude Code inside a box

This page is generated from a mock CLI, and its numbers are placeholders.

Verified against vakna 0.0.0-mock on 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?

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?

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