diff --git a/CLAUDE.md b/CLAUDE.md
new file mode 100644
index 0000000000..a2b7962470
--- /dev/null
+++ b/CLAUDE.md
@@ -0,0 +1,5 @@
+Use pnpm for node and poetry for python to install and update dependencies.
+Run `pnpm run format`, `pnpm run lint` and `pnpm run typecheck` before commiting changes.
+To re-generate the API client run `make codegen` in the repository root.
+Run tests on affected codepaths using `pnpm run test`.
+Default credentials are stored in .env.local in the repository root or inside ~/.e2b/config.json.