~/guides/MODS.md

Guides / Claude Code

Claude Code mods: build your own buttons and panels in one sentence, 3 steps + how to keep them

Mods came to Claude Code on 1 Oct. Say which buttons you want and it writes and loads the mod. The prompt, the approve and check steps, and how to keep it.

Wanting one more button in Claude Code used to mean waiting for an official feature. Not anymore: on 1 October 2026 Anthropic launched mods, small pieces of TypeScript that add buttons and panels to Claude Code or change how it behaves. You don't have to write one yourself either. Just say what you want and Claude Code writes it and loads it. This is the full version of the MODS reel: the sentence to say, what to pick when it asks, how to check it's installed, and the step most people miss: keeping it for next time.

01The result first: buttons inside Claude Code

Reel frame: Claude Code on a 3D laptop, a mod pane above the prompt with an Add one button and a count
Anthropic's own demo from the docs: a mod draws a pane with a button in Claude Code; each press adds one.

When you're done you have:

  1. A panel inside Claude Code with buttons you chose.
  2. Each button sends a prompt you type every day into the conversation in one press.
  3. A mod folder you can switch off in /plugin, or copy out and use again next time.

02Step 1: ask Claude Code to build it

Reel frame: the Claude Code prompt box with the request typed in: make me a mod, open a panel, add three buttons
Illustration: tell Claude Code which buttons you want.

Open Claude Code (the terminal, or the desktop app: choose Code and open your project) and say what you want. Claude Code has a built-in skill called plugin-authoring that tells it where a mod goes and how it loads.

Prompt 1 (swap in the prompts you type every day)
Make me a mod: open a panel with three buttons: [what changed today], [what's still unfinished], [check the latest draft for typos]. Each button sends that instruction into the conversation.

03Step 2: choose Enable for this session

Reel frame: the Claude Code docs with the line Enable for this session highlighted and circled
Step 2 in the official docs: turn on hot reloading.

When Claude saves the first file, Claude Code asks whether to enable hot reloading for the session. Choose Enable for this session: the mod loads when the turn ends and reloads after every turn that changes it.

04Step 3: check it under Installed in /plugin

Reel frame: step 3 of the docs, Check that the mod loaded, circled, with the Installed line highlighted
Step 3 in the official docs: look for it on the Installed tab.
  1. Type /plugin in Claude Code.
  2. Press Tab until the Installed tab is selected; your mod is listed there.
  3. That's also where you switch it off.

Then press your buttons. If it isn't what you wanted, tell Claude what to change; it reloads at the end of that turn. If a line starting with the mod's name says the change didn't load, paste that line to Claude, since it can't see it otherwise.

05The step most people miss: keep it for next time

Reel frame: the lights dim and a 3D folder labelled my-mod pops out of the laptop, Claw'd catching it with arms up
It only works in this session, unless you copy its folder out.

A mod Claude writes only loads in the session that made it. It lives in a folder named after the session ID under ~/.claude/dev-mods/, and that folder is cleaned up after a while (cleanupPeriodDays).

  1. Copy the mod's folder somewhere of your own, such as ~/mods/my-buttons.
  2. Next time, start Claude Code with: claude --plugin-dir ~/mods/my-buttons
  3. To share it with your team, add it to a plugin marketplace so they can install it.
Reel frame: Claw'd on a console as three big buttons light up one by one and the wall screen's count rises
Your everyday prompts are now one press.

06Good to know

  1. Mods aren't sandboxed: they can do what Claude Code can do on your machine, so only install ones you wrote or trust.
  2. On Team or Enterprise plans, admins can block or limit mods through their settings.
  3. A mod Claude writes doesn't load in a claude -p run, in dontAsk mode, in an untrusted folder, or with --safe-mode / --bare.
  4. You need a Claude Code version with mods (October 2026 or later).
  5. You found this guide by typing MODS on the site from the link in bio; nothing is sent by DM.

Sources

Related guides