db8fb0d5a4b06457b14be498bead95c2fa3dc01c
The setup no longer asks for an ssh key. Root logs in on the console and adds keys for claude and root to /var/lib/agent. Root may log in with ssh, and its home is a tmpfs that is wiped at every boot. The test VM uses mkosi ssh instead of a forwarded port, so the agent.ssh-key credential is gone. Also mount /var with noatime, move STYLE.md into AGENTS.md and rewrite comments to start with the name of what they describe. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
agent-mkosi
A VM that runs Claude Code in the background. It is a minimal Fedora image built with mkosi. You control Claude from claude.ai/code or the Claude app (Remote Control), or log in with ssh.
- Resets at reboot: the homes of Claude and root,
/tmpand all containers are wiped at every boot. Only the setup answers, the ssh keys and Claude's login survive (/var/lib/agent). - Read-only OS: the root filesystem is read-only, so Claude can't change
the OS. All state lives on
/var. - Tools in containers: Claude runs as the user
claude, without root, and runs its toolchains in containers with podman. The host has only git, ssh and basic command-line tools. - Self-updating: the
osrebuilds weekly and updates with systemd-sysupdate.
Install
Download the disk image,
resize it to the disk size you want and boot it with UEFI. At first boot, the
console asks for a root password and a hostname. Then log in as root, add an
ssh key for the user claude and run Claude once to sign in. The VM then shows
up in claude.ai/code and the Claude app under its hostname.
Development
mkosi genkey # local test only, CI uses the SECUREBOOT_KEY secret
mkosi build
mkosi.output/ then holds the disk image (agent_<version>.raw) and the UKI
and root partitions that make up an update.
To build and boot a test VM (needs qemu-kvm-core edk2-ovmf openssh-clients socat):
mkosi -f vm # opens its console: log in as root, password root
mkosi ssh # in another terminal: ssh in as root
Languages
Shell
100%