Troubleshoot a mod changedplugins/mods/troubleshoot
Nearest release: v2.1.296, published 2 hours before upstream edited the page. Shown because the two are within 24 hours of each other. Nothing here says the release caused the edit.
Upstream edited this page at 9 Oct 2026 19:26 UTC, give or take a minute or two: the time comes from Anthropic’s own sitemap rather than from a commit. This site recorded the change at 9 Oct 2026 19:37 UTC.
Upstream edited
Recorded here
Lines+12added
Lines−0removed
From line
90
where the diff opens
First seen
1 Oct 2026
this site's first read of the page
Recorded edits20to this page, all time
### `code nested too deep to scan: more than 2000 scopes` ### Claude Code stops asking to enable hot reloading
The whole hunk
from line 90, old and new numbered
/
from line 90
9090
9191Set or change the value. The end of the line names its `pluginConfigs` entry in `settings.json`.
9292
93### `code nested too deep to scan: more than 2000 scopes`
94
95The line starts with the mod's name, then `hooks module did not load:`, the file, and `code nested too deep to scan: more than 2000 scopes`. A file in a hooks module can't nest scopes, such as functions, blocks, and loops, more than [2,000 deep](/docs/en/plugins/mods/reference#limits). [`claude plugin validate`](/docs/en/plugins/mods/create#check-what-claude-code-reads-from-your-mod) reports the same reason.
96
97Rewrite the code so its scopes nest less deeply.
98
9399### No mod loads in a directory you opened for the first time
94100
95101You haven't answered the trust prompt for the directory.
from line 107
101107You started Claude Code with `--safe-mode`.
102108
103109Start without the flag.
110
111### Claude Code stops asking to enable hot reloading
112
113Claude writes a mod in an interactive session, nothing loads, and Claude Code doesn't ask again [whether to enable hot reloading](/docs/en/plugins/mods/create#ask-claude-for-a-mod). If the question ends three times without an answer picked, hot reloading stays off. For example, the question ends that way when you set [`askUserQuestionTimeout`](/docs/en/settings-reference#askuserquestiontimeout) and the time passes before you answer. That setting applies here because Claude Code asks in the same [question dialog that `AskUserQuestion` uses](/docs/en/tools-reference#question-auto-continue-timeout). A question you dismiss yourself doesn't count toward the three.
114
115To run the mod, [copy its directory out of the mods folder](/docs/en/plugins/mods/create#use-the-mod-in-other-sessions), then in your shell start a new session with `--plugin-dir`, as in `claude --plugin-dir ~/mods/git-branch`.
104116
105117## A hook is skipped or a mod is unloaded
106118
No line in this hunk matches that.