diff --git a/CLAUDE.md b/CLAUDE.md
index a6d2665..90b3bbb 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -26,7 +26,7 @@ Both packages are published together as `molecule-ai-sdk` on PyPI (`setuptools`,
 # Install in dev mode
 pip install -e .
 
-# Run the full suite
+# Run the full suite (requires test extras: pip install -e ".[test]")
 pytest
 
 # Run only molecule_agent tests (remote-agent client)