[BUG] `extraKnownMarketplaces` in `managed-settings.json` is ignored
Preflight Checklist
- [x] I have searched existing issues and this hasn't been reported yet
- [x] This is a single bug report (please file separate reports for different bugs)
- [x] I am using the latest version of Claude Code
What's Wrong?
According to the docs, the extraKnownMarketplaces key should be available to be set in any settings file:
<img width="496" height="125" alt="Image" src="https://github.com/user-attachments/assets/d126b1d1-a6ac-4017-864d-90cc5975ffe5" />
So when I added a marketplace to /etc/claude-code/managed-settings.json:
{
"extraKnownMarketplaces": {
"company-tools": {
"source": {
"source": "git",
"url": "<redacted>"
}
}
}
}
I expected this to be added (or for the user to be prompted for this to be added) when they opened up claude. Instead no marketplaces are added, and users are not prompted to add marketplaces added in the managed settings. These marketplaces do not show up when looking at the TUI in /plugins.
What Should Happen?
Claude should either automatically set up marketplaces configured in extraKnownMarketplaces, or should prompt users to set up marketplaces configured there.
Error Messages/Logs
Steps to Reproduce
(Assuming a clean, new, claude code setup.)
- Create a file in
/etc/claude-code/managed-settings.jsonwith the same content as above. - Replace
<redacted>with a git url to a valid claude code marketplace. - Run
claude - Run
/pluginand navigate toMarketplaces
You'll be looking at a blank list (with maybe the exception of the default anthropic one, if applicable).
Claude Model
None
Is this a regression?
I don't know
Last Working Version
_No response_
Claude Code Version
2.0.76
Platform
AWS Bedrock
Operating System
Ubuntu/Debian Linux
Terminal/Shell
Other
Additional Information
_No response_
9 Comments
Found 3 possible duplicate issues:
This issue will be automatically closed as a duplicate in 3 days.
🤖 Generated with Claude Code
Can confirm this is an issue for us as well.
Doesn't work for us either
@ndhansen and @yuyuma , could you share
@whyuan-cc Sure!
Adding that URL works if I run
claude plugin marketplace add ..., and it mirrors what the docs claim I should be doing.Also seeing this issue in our org
Is there a plan to fix this?
Also hitting this in our org. We maintain a custom marketplace with internal tooling plugins; requiring each developer to run
/plugin marketplace addmanually blocks team rollout.Our setup: we commit
extraKnownMarketplacesto.claude/settings.jsonto declare the marketplace at the project level and setenabledPluginsto activate plugins for the whole team. BecauseextraKnownMarketplacesis silently ignored, the plugin never installs andenabledPluginsdoes nothing.The fix is either:
enabledPluginswhose marketplace appears inextraKnownMarketplaces, orWithout this, project-level plugin distribution is broken for any company trying to standardize tooling across a team.
Confirming this also affects Claude Code on the web (remote-execution container), so it's not CLI/desktop-specific — same
area:corecode path, and the same OS as the original repro (Linux). This looks like the web analog of #70318 (Windows Desktop), which was closed as a duplicate.Environment
remote-settings.json:v1.33.7What happens
Org-managed plugins are declared in server-managed remote settings and land correctly in
~/.claude/remote-settings.json:…but the marketplace registration / plugin init step never runs, so the plugins never load:
~/.claude/plugins/marketplaces/is empty (nothing cloned)~/.claude/plugins/installed_plugins.json→{ "version": 2, "plugins": {} }~/.claude/plugins/config.json→{ "version": 2, "plugins": {} }enabledPluginssurface as skills/commands in the sessionSo it's the same underlying defect as this issue (
extraKnownMarketplacesfrom managed/remote settings ignored), but reproduced viaenabledPlugins+ GitHub-sourced marketplaces on the web surface.Why the web case is worse than CLI/desktop
There is no workaround on web. The desktop fix in #70318 was to run
/plugin marketplace addonce in the CLI — but a web session is non-interactive: there's no/pluginTUI to inspect the blank marketplace list, and no CLI on the same machine to register the marketplace manually. The result is that org-managed plugins are silently completely unavailable, with no error surfaced to the user.Expected
On session start, Claude Code on the web should process
extraKnownMarketplacesfrom remote settings — clone/register the marketplaces and install the plugins listed inenabledPlugins— the same init the CLI is supposed to perform, and surface an error if registration fails rather than silently no-op.Related: #70318 (Windows Desktop, closed as duplicate).