diff --git a/CLAUDE.md b/CLAUDE.md
new file mode 100644
index 00000000000..68b2ca4e7b9
--- /dev/null
+++ b/CLAUDE.md
@@ -0,0 +1,21 @@
+# xarray development setup
+
+## Setup
+
+```bash
+uv sync
+```
+
+## Run tests
+
+```bash
+uv run pytest xarray -n auto  # All tests in parallel
+uv run pytest xarray/tests/test_dataarray.py  # Specific file
+```
+
+## Linting & type checking
+
+```bash
+pre-commit run --all-files  # Includes ruff and other checks
+uv run dmypy run  # Type checking with mypy
+```