Claude Code Mods

Mods are small TypeScript functions that change how Claude Code works. Claude Code emits an event whenever it does something, such as calling a tool, asking for permission or drawing part of the screen. A mod can run before, after, instead of, or around that event. Mods can rewrite prompts, block, rewrite or retry tool calls, approve or deny permission requests, and redact secrets from tool output before Claude reads it.

Mods can also change the interface by editing or replacing parts of it, such as tool results or questions from Claude, and by adding buttons and inputs. They can target the terminal, the desktop app, or both. When several mods hook the same event they run in load order. Users can write mods by hand or ask Claude Code to write, install and hot-reload one in the current session. Some built-in features, such as /diff, now ship as mods and can be disabled or replaced.

Mods are distributed inside plugins, so they are installed from the Claude directory or via /plugin in the CLI and use existing plugin controls. On Team and Enterprise plans, and on machines with managed settings, a built-in "sec-default" mod loads first and restricts risky behaviour by user-installed mods, such as overriding permission deny rules. Mods are not sandboxed and run with the same machine access as Claude Code, so they should only be installed from trusted sources.