diff --git a/.claude/launch.json b/.claude/launch.json
new file mode 100644
index 00000000000..b41fd39952d
--- /dev/null
+++ b/.claude/launch.json
@@ -0,0 +1,33 @@
+{
+  "version": "0.0.1",
+  "configurations": [
+    {
+      "name": "@hashintel/petrinaut (storybook)",
+      "runtimeExecutable": "yarn",
+      "runtimeArgs": ["workspace", "@hashintel/petrinaut", "dev"],
+      "port": 6006,
+      "autoPort": true
+    },
+    {
+      "name": "@apps/petrinaut-website",
+      "runtimeExecutable": "yarn",
+      "runtimeArgs": ["workspace", "@apps/petrinaut-website", "dev"],
+      "port": 5173,
+      "autoPort": true
+    },
+    {
+      "name": "@apps/petrinaut-docs",
+      "runtimeExecutable": "yarn",
+      "runtimeArgs": [
+        "exec",
+        "turbo",
+        "run",
+        "dev",
+        "--filter",
+        "@apps/petrinaut-docs"
+      ],
+      "port": 4321,
+      "autoPort": true
+    }
+  ]
+}
diff --git a/apps/petrinaut-docs/package.json b/apps/petrinaut-docs/package.json
index 52ae7ec1f23..05d336031fb 100644
--- a/apps/petrinaut-docs/package.json
+++ b/apps/petrinaut-docs/package.json
@@ -7,7 +7,7 @@
   "type": "module",
   "scripts": {
     "build": "astro build",
-    "dev": "astro dev",
+    "dev": "astro dev --port ${PORT:-4321}",
     "lint:tsc": "astro check --minimumSeverity error",
     "preview": "astro preview",
     "sync:bundle": "node scripts/sync-bundle.mjs"
diff --git a/apps/petrinaut-docs/turbo.json b/apps/petrinaut-docs/turbo.json
index cd13dfbb0f8..e2962ab2b4f 100644
--- a/apps/petrinaut-docs/turbo.json
+++ b/apps/petrinaut-docs/turbo.json
@@ -24,7 +24,9 @@
     "dev": {
       "cache": false,
       "persistent": true,
-      "dependsOn": ["sync:bundle"]
+      "dependsOn": ["sync:bundle"],
+      // The Claude Code preview passes the port to serve on.
+      "env": ["PORT"]
     }
   }
 }
diff --git a/apps/petrinaut-website/vite.config.ts b/apps/petrinaut-website/vite.config.ts
index ff28dedd11d..c57e521e885 100644
--- a/apps/petrinaut-website/vite.config.ts
+++ b/apps/petrinaut-website/vite.config.ts
@@ -84,6 +84,8 @@ export default defineConfig(({ mode }) => {
       port: process.env.PORT ? Number(process.env.PORT) : 4173,
     },
     server: {
+      /** the Claude Code preview may provide a PORT to run on */
+      port: process.env.PORT ? Number(process.env.PORT) : 5173,
       proxy: {
         "/api/petrinaut-opt": {
           target: process.env.PETRINAUT_OPT_ORIGIN ?? "http://127.0.0.1:4004",
diff --git a/libs/@hashintel/petrinaut/scripts/dev.sh b/libs/@hashintel/petrinaut/scripts/dev.sh
index a83cf14a51a..ed7a5c52c43 100644
--- a/libs/@hashintel/petrinaut/scripts/dev.sh
+++ b/libs/@hashintel/petrinaut/scripts/dev.sh
@@ -9,4 +9,4 @@ set -euo pipefail
 cd "$(dirname "$0")/.."
 . ../../@local/petrinaut-optimizer-client/scripts/optimizer-service.sh
 optimizer_service_parse "$@"
-run_dev_server yarn storybook dev ${OPTIMIZER_FORWARDED[@]+"${OPTIMIZER_FORWARDED[@]}"}
+run_dev_server yarn storybook dev -p "${PORT:-6006}" ${OPTIMIZER_FORWARDED[@]+"${OPTIMIZER_FORWARDED[@]}"}