Answer: In an interactive session, after you send your first message, Claude Code waits a random delay of up to ten minutes, then refreshes every marketplace with auto-update on and updates the plugins installed from them on disk. Whether a marketplace auto-updates follows the first of these that is set: the `autoUpdate` setting on its `extraKnownMarketplaces` entry, then the `autoUpdate` setting on its `known_marketplaces.json` entry, then the default. Status: Confirmed Entry: tool/claude-code/settings/plugin-auto-update-timing Revision: 2 Digest: sha256:85806ec99fc33e57 (changes whenever the content changes) Timeline: Created: 2026-11-13T03:05:05Z Last changed: 2026-11-15T12:23:29Z (Default for claude.ai marketplaces: — → on for [marketplaces added from claude.ai]) Last verified: 2026-11-20T12:23:16Z Next check: 2026-11-21T12:23:16Z Check interval: Daily Expected change: No fixed schedule Data: Field | Value | Source | As of Auto-update delay | up to ten minutes | [1] | 2026-11-20 When auto-update runs | after you send your first message | [1] | 2026-11-20 First precedence setting | `autoUpdate` on its `extraKnownMarketplaces` entry | [1] | 2026-11-20 Second precedence setting | `autoUpdate` on its `known_marketplaces.json` entry | [1] | 2026-11-20 Default for official marketplaces | on for Anthropic's official marketplaces such as `claude-plugins-official` | [1] | 2026-11-20 Default for knowledge-work-plugins and first-party-plugins | off for `knowledge-work-plugins` and `first-party-plugins` | [1] | 2026-11-20 Default for claude.ai marketplaces | on for [marketplaces added from claude.ai] | [1] | 2026-11-20 Disabling variables | `DISABLE_UPDATES=1`, `DISABLE_AUTOUPDATER=1`, or `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1` | [1] | 2026-11-20 Sources: [1] Anthropic. "Plugin loading reference". https://code.claude.com/docs/en/plugins/loading.md Role: primary. Accessed: 2026-11-20T12:23:16Z Quote: "Claude Code waits a random delay of up to ten minutes" (Supports: Auto-update delay) Quote: "In an interactive session, after you send your first message" (Supports: When auto-update runs) Quote: "**`autoUpdate` on its `extraKnownMarketplaces` entry** in a settings file" (Supports: First precedence setting) Quote: "**`autoUpdate` on its `known_marketplaces.json` entry**" (Supports: Second precedence setting) Quote: "on for Anthropic's official marketplaces such as `claude-plugins-official`" (Supports: Default for official marketplaces) Quote: "off for `knowledge-work-plugins` and `first-party-plugins`" (Supports: Default for knowledge-work-plugins and first-party-plugins) Quote: "on for [marketplaces added from claude.ai]" (Supports: Default for claude.ai marketplaces) Quote: "If you set `DISABLE_UPDATES=1`, `DISABLE_AUTOUPDATER=1`, or `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1`, the whole pass is off" (Supports: Disabling variables) Published: 2026-11-20T02:53:19Z Snapshot SHA-256: 72d5d7129f8cc4ef2f6746f95c303d47dab5fb4809c3b2884b9dda49fa82b52c (captured 2026-11-20T12:23:15Z) Verification: Method: Automated extraction from [1] with deepseek-flash (JSON output, thinking disabled). Every value was checked by code to appear verbatim in a quoted passage of [1]. Cross-check: not-available at 2026-11-20T12:23:16Z. No independent second source is configured for this entry Last successful check: 2026-11-20T12:23:16Z Last attempt: 2026-11-20T12:23:16Z Notes and limitations: Extracted automatically from a single official source (section "When auto-update runs"). Related: https://latestn.com/tool/claude-code/settings/plugin-component-paths How do I specify component paths like commands or hooks in a Claude Code plugin manifest? https://latestn.com/tool/claude-code/settings/plugin-environment-variables How do environment variables resolve in Claude Code plugins? https://latestn.com/tool/claude-code/settings/plugin-install-scopes What are the install scopes for Claude Code plugins? https://latestn.com/tool/claude-code/settings/pause-archive-delete-project How do I pause, archive, or delete a Claude Code project? https://latestn.com/tool/claude-code/settings/persist-auth-settings-rebuilds How do I persist Claude Code authentication and settings across dev container rebuilds? https://latestn.com/tool/claude-code/settings/personal-settings-out-of-repo How do I keep my personal Claude Code settings out of a git repository? https://latestn.com/tool/ All entries in AI tools Change log: Time | Event | Change | Source 2026-11-15T12:23:29Z | changed | Default for claude.ai marketplaces: — → on for [marketplaces added from claude.ai] | [1] 2026-11-15T12:23:29Z | changed | Second precedence setting: — → `autoUpdate` on its `known_marketplaces.json` entry | [1] 2026-11-15T12:23:29Z | changed | First precedence setting: — → `autoUpdate` on its `extraKnownMarketplaces` entry | [1] 2026-11-15T12:23:29Z | changed | When auto-update runs: — → after you send your first message | [1] 2026-11-15T12:23:29Z | changed | Auto-update delay: — → up to ten minutes | [1] 2026-11-15T12:23:29Z | changed | Skipped plugins: a plugin whose marketplace entry declares a `headersHelper` → — | [1] 2026-11-15T12:23:29Z | changed | Default for official marketplaces: on for Anthropic's official marketplaces → on for Anthropic's official marketplaces such as `claude-plugins-official` | [1] 2026-11-15T12:23:29Z | changed | Second precedence rule: `autoUpdate` on its `known_marketplaces.json` entry → — | [1] 2026-11-15T12:23:29Z | changed | First precedence rule: `autoUpdate` on its `extraKnownMarketplaces` entry → — | [1] 2026-11-15T12:23:29Z | changed | Trigger for auto-update: after you send your first message → — | [1] 2026-11-15T12:23:29Z | changed | Timing of auto-update run: waits a random delay of up to ten minutes → — | [1] 2026-11-13T03:05:05Z | added | Entry created | — Changes for this entry as a feed: https://latestn.com/tool/claude-code/settings/plugin-auto-update-timing/latest Challenge this entry: Open challenges: None How: If a value here is wrong or out of date, send what is wrong and a link to evidence. Challenges are queued and checked against the evidence; they do not change the entry by themselves. If the entry changes as a result, the change log says so. Form: https://latestn.com/dispute/tool/claude-code/settings/plugin-auto-update-timing POST: https://latestn.com/dispute/tool/claude-code/settings/plugin-auto-update-timing with claim, evidence_url, and optionally field and contact (form-encoded or JSON) GET: https://latestn.com/dispute/tool/claude-code/settings/plugin-auto-update-timing?claim={what is wrong}&evidence_url={link} How to cite: LatestN. (2026). How does Claude Code decide when to auto-update marketplaces and plugins? Revision 2, last verified 2026-11-20T12:23:16Z. https://latestn.com/tool/claude-code/settings/plugin-auto-update-timing (accessed 2026-11-21T09:52:45Z). @misc{LatestN_tool_claude_code_settings_plugin_auto_update_timing_r2, title = {How does Claude Code decide when to auto-update marketplaces and plugins?}, author = {{LatestN}}, year = {2026}, howpublished = {\url{https://latestn.com/tool/claude-code/settings/plugin-auto-update-timing}}, note = {Revision 2; digest sha256:85806ec99fc33e57; last verified 2026-11-20T12:23:16Z; accessed 2026-11-21T09:52:45Z} } Reuse: License: CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/) Attribution: Copying and adapting are allowed, including commercially, if you credit LatestN and link to the entry you used. Each entry ends with a ready-made citation. URL: https://latestn.com/tool/claude-code/settings/plugin-auto-update-timing