Claude Rescue

Bootable USB repair image

Fix the computer that won't boot.

Claude Rescue is a Debian live system with Claude Code as the technician. Boot the broken Windows or Linux machine from the stick, get online, sign in, and describe the problem.

rescue@claude-rescue:~/rescue$ claude
● Read survey.md: 1 NVMe disk, Windows 11 + Ubuntu 24.04,
  UEFI, Secure Boot on. The ESP has no ubuntu/ folder
  and NVRAM has no ubuntu boot entry.
● Before I change anything I'll back up the ESP and
  the NVRAM boot entries to the stick.
  $ rescue-backup esp nvram
● I'd like to reinstall GRUB to the ESP from the
  Ubuntu system. It doesn't touch your data. Go ahead?
> yes

You are handing an AI full control of this computer

When the stick boots, Claude Code runs as administrator (root) and does not ask permission for each command. It can read, change and delete anything on every disk in the machine.

What that means

  • It sees everything. Documents, photos, browser data, the Windows registry: every file on every connected disk.
  • It acts on its own. Most commands run straight away. Only data-destroying ones (formatting, repartitioning, raw disk writes) are held until Claude has explained them and you say yes.
  • It can be wrong. An AI can misread a problem. A wrong repair can make things worse or lose data.
  • What it reads leaves the machine. Files and command output Claude looks at are sent to Anthropic to process the conversation.

Before you boot it

  • Back up anything important first, if you still can.
  • Only use it on computers you own or have permission to work on.
  • Unplug disks and drives you don't want touched.
  • Stay at the keyboard. Read what Claude proposes, and say no when you're not sure.

The safety guard is a seat belt, not a sandbox. You are responsible for what happens to the machine.

How it works

  1. Write the stick

    Use make-usb.sh, Rufus (DD mode), balenaEtcher, or drop the ISO on a Ventoy stick. 4 GB or larger.

  2. Sign in once

    Paste a claude setup-token token or an API key into claude-settings.txt on the stick, or sign in on screen with a QR code.

  3. Boot and describe

    Claude surveys the machine read-only, summarises what it found and asks what's wrong. Reports and backups are saved to the stick.

What's on the stick

Boots almost anywhere

Debian 13 (trixie), UEFI with Secure Boot and legacy BIOS. Renders on any display driver, with text-mode and nomodeset fallbacks.

A full repair toolkit

GRUB, shim, efibootmgr, LVM/RAID/LUKS, BitLocker, NTFS/btrfs/xfs/ext4 tools, testdisk, photorec, ddrescue, smartctl, chntpw, hivex, memtest86+ and more.

Rescue skills for Claude

Triage, Linux and Windows boot repair (BCD, offline registry and logs), dual-boot and UEFI, disk health and data recovery.

Safety rails

Disks are never auto-mounted. A guard hook blocks data-destroying commands until Claude has explained them and you said yes. Every command is logged.

A paper trail

Each session writes survey.md, report.md, commands.log and pre-change backups of partition tables, ESPs, BCD and NVRAM.

Kept current

Rebuilt on a schedule, so each image carries the newest Claude Code and Debian security updates.

Download

Latest build

Looking up the newest build…

Download ISO

Tick the box above to download.

claude-settings.txt
sudo ./make-usb.sh claude-rescue-*.iso /dev/sdX

Older builds are in the package registry. To build it yourself: clone the repository and run ./build.sh (Docker or Podman, about 20–40 minutes).

Before you start