How to build Claude Code mods: plugins that hook the engine, add commands and tools, and draw their own UI inside Claude Code, from status lines to animated panes.
By ruvnet. Written from building and shipping a real mod, with every pitfall we hit included.
Early access. Mods (function hooks) are an early-access Claude Code feature, and the API moves between releases. Your build writes its own type definitions next to every mod you load (see Setup), and those types are the authority. Grep them before you trust any guide, this one included.
Throughout this guide:
- π§ͺ Field-tested means we did it in a shipped mod and saw it work (or break) for real.