diff --git a/CLAUDE.md b/CLAUDE.md
index 9295c30..8e9c285 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -34,6 +34,15 @@ The API token is generated on first run and displayed in the console output.
 
 Default port: `8765`
 
+## Versioning
+
+Version is tracked in two files that must be kept in sync:
+
+- `pyproject.toml` - `[project].version`
+- `media_server/__init__.py` - `__version__`
+
+When releasing a new version, update both files with the same version string.
+
 ## Git Rules
 
 - Always ask for user approval before committing changes to git.