diff --git a/CLAUDE.md b/CLAUDE.md
index 01dd597..ff2a556 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -19,7 +19,8 @@ npm run generate
 npm run build:dev
 ```
 
-Only use Docker Compose for running tests.
+Only use Docker Compose for running tests, and only use `docker compose run test`
+to run tests; don't try to run tests for individual files.
 
 ## Architecture Overview