claude /reload-plugins: Apply Plugin Changes Instantly Without Restart

If you've been shutting down and restarting all of Claude Code every time you slightly tweak a plugin (an extension package that adds features to Claude Code), it's a waste of time. /reload-plugins reloads only the changes without a restart. For beginners, the key is that it creates a fast iteration flow of "fix -> check immediately -> fix again."

Definition (What It Is)

/reload-plugins is a command that reloads a plugin's changes without shutting down the current session (a single unit of work with Claude Code kept open).

Normally, when you change plugin code or settings, Claude Code keeps using what it read once at startup, so your changes aren't reflected. Usually you have to restart for them to apply, but restarting interrupts the conversation context you've built up so far or forces you to reload it, which is a hassle. This command skips that process and refreshes only the plugins.

How to Use It (By Difficulty)

Basic — Refreshing Plugins

After modifying a plugin, type this in the input box.

/reload-plugins

This single line is all it takes. Claude Code scans (skims and reads) the installed plugins again to reflect what you just changed. You can check the list of reloaded plugins in the result message.

Applied — Slotting It into the Develop-Check Loop

If you're in the middle of building a plugin, the flow goes like this.

(Edit and save the plugin code in your editor)
/reload-plugins
(Actually call the plugin feature to check it works)

If you type /reload-plugins right after saving the code and then immediately try the feature, you can instantly tell whether it works as intended. If not, just fix it and reload again.

Common Pitfalls

• If the change isn't showing after a refresh, the most likely cause is that you didn't save the file. Check the save (Ctrl+S) in your editor first.
• If you newly installed a plugin or changed the folder structure itself, a reload alone may not be enough. In that case, restart Claude Code once.
• Don't confuse it with the similarly named /reload-skills. Plugins are refreshed with /reload-plugins, skills with /reload-skills, separately.

Real-World Example

It shines most when you're developing a plugin yourself. You can add one feature and check it right away with /reload-plugins, and if you see a bug, fix it and reload again, refining it quickly. With the restart wait gone, your work rhythm doesn't break.

Taking It Further

It's also useful when you take someone else's plugin and slightly tweak it to your taste. After changing one line of a setting value, applying it right away with /reload-plugins lets you check the effect of the change without reinstalling or restarting. Reach for it in every moment you need to "tweak a little and check right away."

Summary

/reload-plugins is a command that applies plugin changes without a restart. The fix-and-check loop gets faster, making plugin development and customization much smoother. If the change isn't showing, check whether you saved first, and if it still doesn't work, consider a restart.

Reference: Claude Code v2.1.154 (2026.05)