diff --git a/CLAUDE.md b/CLAUDE.md
index ab90eb2..c5a4c40 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -28,7 +28,9 @@ npm run build        # vite build
 npm run typecheck
 
 # whole stack
-docker-compose up -d --build
+# Use `docker compose` (v2). The old `docker-compose` v1 binary on this machine
+# crashes with KeyError: 'ContainerConfig' when recreating a container.
+docker compose up -d --build
 ```
 
 There is no lint step. `typecheck` is the gate; the `prebuild` hook fails the build on type errors.