diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index 030b60f2..1fd93e01 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -96,6 +96,28 @@ $ npx prism mock path/to/your/openapi.yml
 $ ./scripts/test
 ```
 
+### Snapshots
+
+Some tests use [inline-snapshot](https://15r10nk.github.io/inline-snapshot/latest/). To update them after making changes, rerun the tests with the `--inline-snapshot=fix` and `-n0` options:
+
+```bash
+./scripts/test --inline-snapshot=fix -n0
+```
+
+> [!NOTE]
+> `inline-snapshot` is incompatible with [pytest-xdist](https://github.com/pytest-dev/pytest-xdist), so you need to disable parallel execution `(-n0)` when using the `--inline-snapshot` option.
+
+In addition, some tests capture snapshots of the HTTP requests they make.
+To refresh these snapshots, run the tests with the `ANTHROPIC_LIVE=1` environment variable enabled.
+
+```bash
+ANTHROPIC_LIVE=1 ./scripts/test --inline-snapshot=fix
+```
+
+> [!NOTE]
+> Sometimes it makes sense to update only the inline snapshots `(--inline-snapshot=fix)` without refreshing the HTTP snapshots `(ANTHROPIC_LIVE=1)`.
+> This is useful when the endpoint hasn’t changed, but your code handles the response differently and the assertions need updating.
+
 ## Linting and formatting
 
 This repository uses [ruff](https://github.com/astral-sh/ruff) and
diff --git a/tests/lib/tools/test_runners.py b/tests/lib/tools/test_runners.py
index 0d34362f..1d5605ce 100644
--- a/tests/lib/tools/test_runners.py
+++ b/tests/lib/tools/test_runners.py
@@ -25,7 +25,7 @@
 #
 # you can update them with
 #
-# `ANTHROPIC_LIVE=1 pytest --inline-snapshot=fix -p no:xdist -o addopts=""`
+# `ANTHROPIC_LIVE=1 ./scripts/test --inline-snapshot=fix -n0`
 
 snapshots = {
     "basic": {