diff --git a/CLAUDE.md b/CLAUDE.md
index f8e1618..b457721 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -1,5 +1,12 @@
 # Claude Code Notes
 
+## Running Tests
+
+Use `bun run test:cov` to run all tests with coverage. This runs both unit tests and e2e tests that require a database connection.
+
+- `bun run test:cov` - Run all tests with coverage (preferred)
+- `bun run test:unit:cov` - Run only unit tests with coverage (no database required)
+
 ## Database Scripts
 
 Use the wrapper scripts instead of running dbmate directly:
diff --git a/README.md b/README.md
index b7085bd..b460892 100644
--- a/README.md
+++ b/README.md
@@ -113,7 +113,10 @@ bun run dev
 | `bun run typecheck` | Run TypeScript type checking |
 | `bun run lint` | Run Biome and ESLint |
 | `bun run lint:fix` | Fix linting issues |
-| `bun run test` | Run tests |
+| `bun run test` | Run all tests (requires database) |
+| `bun run test:unit` | Run unit tests only (no database required) |
+| `bun run test:cov` | Run all tests with coverage report |
+| `bun run test:unit:cov` | Run unit tests with coverage (no database) |
 | `bun run db:codegen` | Generate database types |
 | `./scripts/db-dump` | Dump database schema (strips `\restrict` lines) |
 | `./scripts/db-migrate` | Run migrations (strips `\restrict` lines) |