diff --git a/.gitignore b/.gitignore
index bfb3e1b9..a53a652d 100644
--- a/.gitignore
+++ b/.gitignore
@@ -1,5 +1,9 @@
 # .gitignore of project Aignostics Python SDK
 
+# Claude Code agent worktrees — created locally per session, never committed.
+# Note: .claude/settings.json is intentionally tracked; only worktrees are ignored.
+.claude/worktrees/
+
 # Environment
 .env
 .env.*
diff --git a/pyrightconfig.json b/pyrightconfig.json
index 612b268a..b6a233da 100644
--- a/pyrightconfig.json
+++ b/pyrightconfig.json
@@ -3,6 +3,7 @@
     "exclude": [
         "**/.nox/**",
         "**/.venv/**",
+        "**/.claude/worktrees/**",
         "**/dist-packages/**",
         "**/dist_vercel/.vercel/**",
         "**/dist_native/**",