插件、MCP 与智能体设置
插件与市场管控、Skill 覆盖、MCP 服务器审批与托管、子智能体与会话、worktree,以及桌面浏览器与模拟器工具的托管开关。
作用域缩写:任何文件 = 用户/项目/本地/托管任一处。取值与默认值以官方为准。
插件与 Skill
| 键 | 作用域 | 说明 |
|---|---|---|
enabledPlugins | 任何文件 | 按作用域开关单个插件(plugin-name@marketplace-name 到布尔值的对象);不设则每个插件遵循自己的 defaultEnabled |
extraKnownMarketplaces | 任何文件 | 为仓库或组织注册市场(市场名到含 source 对象和可选 autoUpdate 的对象) |
pluginConfigs | 用户或托管 | 保存你对插件配置对话框的回答(插件 ID 到含 options 的对象) |
strictKnownMarketplaces | 仅托管 | 用允许列表限定用户可添加和安装的市场来源;不设则可添加任何市场,空数组表示完全锁定 |
blockedMarketplaces | 仅托管 | 为你的组织屏蔽插件市场来源(形式同 strictKnownMarketplaces) |
pluginSuggestionMarketplaces | 仅托管 | 选择哪些市场可以在 /plugin 里弹出插件安装建议 |
pluginTrustMessage | 仅托管 | 往插件信任警告里加上你自己的文字 |
disableCommandPluginSources | 仅托管 | 阻止通过运行市场声明的命令来安装的插件(不设则遵循 allowManagedHooksOnly) |
strictPluginOnlyCustomization | 仅托管 | 阻止来自用户和项目来源的 skills、agents、hooks、MCP 服务器:true 锁定全部四类,或给出要锁定的种类数组("skills"、"agents"、"hooks"、"mcp");也可以用 strictPluginOnlyCustomization.skills/.agents/.hooks/.mcp 指单类(锁定到插件和托管来源) |
prependPlugins / appendPlugins | 用户或托管 | 在用户安装的所有 mod 之前 / 之后运行你组织的 mod(plugin-name@marketplace-name 数组) |
allowedChannelPlugins | 仅托管 | 替换默认的、可推送消息的 channel 插件允许列表 |
channelsEnabled | 仅托管 | 为你的组织允许 channels(Team、Enterprise 方案和 Console 账号上默认被阻止) |
syncClaudeAiPlugins / syncClaudeAiSkills | 用户、本地或托管 | 设为 false 停止加载你 claude.ai 账号上启用的插件 / Skill,也不再下载新的(用 claude.ai 账号登录的会话默认同步) |
skillOverrides | 任何文件 | 不编辑 SKILL.md 就隐藏或折叠某个 Skill:Skill 名到 "on"、"name-only"、"user-invocable-only"、"off" 的映射 |
disableBundledSkills | 任何文件 | 关闭随 Claude Code 附带的 Skill 和工作流 |
disableSkillShellExecution | 任何文件 | 阻止 Skill 和自定义命令运行内联 shell |
MCP
| 键 | 作用域 | 说明 |
|---|---|---|
enableAllProjectMcpServers | 任何文件 | 不经提示批准项目 .mcp.json 文件里的每个服务器(不设则逐个请你批准) |
enabledMcpjsonServers / disabledMcpjsonServers | 任何文件 | 批准 / 拒绝项目 .mcp.json 里的特定服务器(服务器名数组) |
allowedMcpServers | 任何文件 | 用允许列表限定用户可添加哪些 MCP 服务器(每项恰有一个键,如 serverName);不设则全部允许,空数组阻止用户添加的每个服务器 |
deniedMcpServers | 任何文件 | 按 URL、命令或名称屏蔽特定 MCP 服务器 |
allowManagedMcpServersOnly | 仅托管 | 让托管的 MCP 允许列表成为唯一生效的(默认各设置作用域的允许列表合并) |
managedMcpServers | 仅托管 | 向每个用户提供远程 MCP 服务器,与他们自己添加的并存(按服务器名分键的对象,每项是 http 或 sse 服务器的 .mcp.json 形状) |
disableClaudeAiConnectors | 任何文件 | 关闭 claude.ai 连接器,让 Claude Code 不去拉取它们(默认 false) |
allowAllClaudeAiMcps | 仅托管 | 在部署了 managed-mcp.json 时仍加载 Claude Code 自己拉取的 claude.ai 连接器(默认 false,即被抑制) |
allowClaudeInChromeWithManagedMcp | 仅托管 | 让内置的 Claude in Chrome 服务器与部署的 managed-mcp.json 并存运行(默认 false) |
智能体、会话与 worktree
| 键 | 作用域 | 说明 |
|---|---|---|
agent | 任何文件 | 让每个会话以某个命名智能体(内置或自定义)启动,带它的提示、工具和模型;不设则主线程以 Claude Code 默认智能体运行 |
teammateMode | 任何文件 | 选择智能体团队队友的显示方式:in-process(默认)、auto、tmux、iterm2 |
disableAgentView | 任何文件 | 关闭后台智能体和智能体视图 |
crossSessionInbound | 任何文件 | 选择 Claude Code 对来自你其他会话的消息是投递(accept)、只显示通知不投递(hold)、还是拒绝(refuse);不设则逐条决定 |
isolatePeerMachines | 任何文件 | Claude 给你另一台机器上的会话发消息之前先询问你 |
processWrapper | 用户或托管 | 在 macOS 和 Linux 上让 Claude Code 的后台进程经由企业启动器运行(argv 前缀形式的启动命令) |
worktree | 任何文件 | 配置 Claude Code 如何创建 git worktree:含 baseRef、symlinkDirectories、sparsePaths、bgIsolation |
worktree.baseRef | 任何文件 | 新 worktree 从远端默认分支(fresh,默认)还是你本地 HEAD(head)分出 |
worktree.bgIsolation | 任何文件 | 让后台会话不经 worktree 直接编辑工作副本(worktree 默认,或 none) |
worktree.sparsePaths | 任何文件 | 每个 worktree 只检出你需要的目录(相对仓库根的路径数组) |
worktree.symlinkDirectories | 任何文件 | 把大目录以符号链接放进每个 worktree 而不是复制(相对仓库根的路径数组) |
桌面应用的工具开关
| 键 | 作用域 | 说明 |
|---|---|---|
browserExternalPageTools | 仅托管 | 设为 "disabled" 让 Claude 的工具不作用于桌面应用 Browser 窗格里的外部页面 |
disableBrowserExternalNavigation | 仅托管 | 把桌面 Browser 窗格限制在 localhost(对人和 Claude 都是;只有 JSON 布尔值 true 生效) |
disableMobileSimulatorTools | 仅托管 | 阻止 Claude 的工具作用于桌面应用的 iOS 模拟器窗格(只有 JSON 布尔值 true 生效) |