diff --git a/CLAUDE.md b/CLAUDE.md
index 1d4b3e8a..8ea1b59f 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -9,13 +9,15 @@ Directus documentation site built with Nuxt 3 and `@nuxt/content`. Markdown file
 ## Commands
 
 ```bash
-pnpm install        # Install dependencies (requires Node.js 22, pnpm 9.15.4)
+pnpm install        # Install dependencies (requires Node.js >=22.18, pnpm 10.29.2)
 pnpm dev            # Dev server at http://localhost:3000/docs
 pnpm build          # Production build
 pnpm generate       # Static site generation (used for Vercel deploy)
 pnpm preview        # Preview production build locally
 ```
 
+`pnpm dev` fails with `Invalid URL` unless `DIRECTUS_URL` is set, because the Nuxt server passes it to `createDirectus()` during render. Copy any missing environment variables from `.env.example` to `.env` before the first run. For content-only work, `DIRECTUS_URL` is the sole required value; the remaining variables emit warnings and disable search, analytics, and the assistant.
+
 There is no test runner configured. Linting is via `@nuxt/eslint` (run through Nuxt's built-in integration).
 
 ## Architecture