它到底是什么

/reload-plugins 是 Claude Code CLI 中的会话内 slash 命令,作用是在不重启当前会话的前提下,将已安装插件的最新变更加载进运行时内存。

插件由 6 类组件构成(skills、agents、hooks、MCP servers、LSP servers、monitors)。/reload-plugins 的热刷新路径覆盖其中前 5 类:skills、agents、hooks、MCP servers、LSP servers(官方表述为重载后展示 plugins、skills、agents、hooks、plugin MCP servers、plugin LSP servers 的计数):无需退出对话、无需丢失上下文,就能让编辑或新安装的插件立即生效。monitors(第 6 类)不在刷新范围内,官方文档明确说明 monitors 需要重启 session 才能切换。

平台限制: 截至目前(2026-06-14),此命令仅在 CLI 中可用。Claude Code Desktop App 尚未暴露该命令(见 GitHub issue #52967),Desktop App 用户的唯一替代方案是完整退出(Cmd+Q)后重新打开。

怎么触发 / 怎么使用

在 Claude Code 会话内,直接在消息开头输入:

/reload-plugins

该命令无需任何参数。执行后,Claude Code 会在进程内重扫插件目录,并将变更刷入运行时状态。

典型触发时机

1. 本地开发插件时:修改了 SKILL.md、hooks/、mcp/ 等目录后,在同一 session 中验证变更。
2. 从 marketplace 更新插件后:本地缓存(~/.claude/plugins/cache/<marketplace>/<plugin>/<version>/)已更新,需让当前 session 感知新版本。
3. 切换 MCP server 配置后:修改了插件内的 MCP 配置,希望立即生效而不丢失对话上下文。

运行约束 / 限制

跟同类原语对比

经典使用场景

• 插件开发调试循环:修改技能文件 → 会话内运行 /reload-plugins → 用 Skill tool 测试更新 → 无需反复重开会话。
• Marketplace 插件版本升级:插件作者发布新版、本地 installed_plugins.json 自动指向新路径后,用此命令让运行中的 session 切换到新版,不中断工作流。
• Hooks 配置热切换:在同一 session 中调整 SessionStart 或 PreToolUse 等 hook 脚本后立即生效。

常见坑

1. 新插件 skill 无法用 / 触发:运行 /reload-plugins 后,model 内部可以通过 Skill tool 调用新 skill,但键入 /plugin-name:skill-name 仍返回 "Unknown skill"。根因是 slash-command 解析器索引只在 session 启动时构建,/reload-plugins 不会重建它。解决方法:完整重启 Claude Code。(来源:issue #37862,已关闭标记为 duplicate)

2. Desktop App 用户操作无效:如果你使用的是 Claude Code Desktop App,/reload-plugins 不会被识别。必须 Cmd+Q 完整退出再重开,这会丢失所有打开的对话运行时状态。(来源:issue #52967)

3. Monitors 变更不生效:插件中的 monitors 组件即使执行了 /reload-plugins 也不会被刷新,必须重启整个 session。

来源

• Commands — Claude Code Docs
• Plugins reference — Claude Code Docs
• /reload-plugins doesn't rebuild slash-command index · Issue #37862 · anthropics/claude-code
• [desktop] Add /reload-plugins command for in-process plugin refresh (parity with CLI) · Issue #52967 · anthropics/claude-code