Što je mod
Mod je plugin koji mijenja kako Claude Code izgleda i radi. Napisan je u JavaScriptu ili TypeScriptu, a Claude Code ga poziva kad se nešto dogodi: kad Claude zove alat, kad pošalješ prompt ili kad se crta dio sučelja. Mod taj događaj može samo pratiti, može ga promijeniti ili ga preuzeti u potpunosti.
Razlika od onoga što već znaš: skill daje Claudeu upute, MCP ga spaja s vanjskim alatima, a hook iz postavki pokreće tvoju skriptu. Mod radi unutar samog Claude Codea, pa je jedini od njih koji može crtati u sučelju: panel pored razgovora, traku iznad prompta, gumbe i polja.
Neke značajke Claude Codea već su modovi. Naredba /diff, koja pokazuje tvoje promjene u panelu pored razgovora, ugrađeni je mod.
Prije nego kreneš
Treba ti Claude Code v2.1.287 ili noviji. Starija verzija modove ne učitava. Verziju provjeriš ovako:
claude --version
Modovi rade u terminalu i u Code tabu Claude Desktop aplikacije. U VS Code chat panelu mod radi, ali ono što crta se ne prikazuje, a isto vrijedi i za claude -p. Ako radiš u VS Codeu, pokreni claude u njegovom ugrađenom terminalu.
Četiri primjera
Next Steps (mod zajednice): kad Claude završi zadatak, predloži do tri sljedeća prompta. Odabereš jedan i on se upiše u polje, a ti i dalje odlučuješ što šalješ. Instaliraš ga ovako:
claude plugin install next-steps@claude-community
Token Weather (Anthropicov primjer): iznad prompta crta prognozu koliko ti je kontekst pun, od Clear ispod 25% do Compact soon iznad 90%, s malim grafom zadnjih poteza. Brojke su stvarne, ne procjena.
Blast Radius (Anthropicov primjer): zaustavi rizičnu naredbu kao što su rm -rf, git reset --hard, git clean, git push --force ili migracija baze, i pokaže što bi promijenila. Tek onda biraš Proceed ili Cancel. Štiti samo od naredbi koje provjerava, sve ostalo prolazi normalno.
Replay Theater (Anthropicov primjer): dodaje naredbu /replay kojom prolaziš kroz izmjene datoteka iz Claudeovog zadnjeg odgovora, jednu po jednu. Samo gleda, nijednu izmjenu ne blokira ni ne mijenja.
Kako isprobati Anthropicove primjere
Primjeri su u javnom repozitoriju claude-code-playground. Kloniraj ga i pokreni Claude Code s modom koji želiš, samo za tu sesiju:
git clone https://github.com/anthropics/claude-code-playground claude --plugin-dir claude-code-playground/claude-code/mods/token-weather
Umjesto token-weather možeš staviti blast-radius ili replay-theater. Da provjeriš je li se mod učitao, upiši /plugin: ispod tabova piše koliko je modova aktivno i kako se zovu.
Napravi svoj mod u dva prompta
Kreni od zahtjeva koji stalno ponavljaš. U Claude Code zalijepi:
Pregledaj moje nedavne sesije kojima imaš pristup. Nađi zahtjeve koje ponavljam. Predloži pet korisnih modova i preporuči najmanji za početak.
Ako Claude ne vidi tvoju povijest, zalijepi mu par primjera posla koji stalno ponavljaš. Kad dobiješ prijedloge, u istom razgovoru napiši:
Napravi najmanji mod koji si preporučio. Neka bude jednostavan i objasni što mijenja.
Claude za to koristi ugrađeni skill plugin-authoring i sprema mod u mapu ~/.claude/dev-mods/ pod ID-jem tvoje sesije. Budući da je ~/.claude zaštićena mapa, u običnom načinu rada pitat će te za dopuštenje za svaku datoteku. Zatim:
- Kad Claude spremi prvu datoteku, pita te za hot reload. Odaberi Enable for this session: mod se učita na kraju odgovora i ponovno se učita svaki put kad ga Claude promijeni.
- Upiši /plugin i otvori tab Installed. Tamo je tvoj mod i tamo ga možeš isključiti.
- Ne radi ono što si htio? Reci Claudeu što da promijeni. Promjena se učita čim završi odgovor.
Kako zadržati mod
Mod koji Claude napiše radi samo u sesiji u kojoj je nastao, a Claude Code tu mapu s vremenom sam obriše. Da ga zadržiš, kopiraj njegovu mapu na svoje mjesto i pokreći Claude Code s njom:
mkdir -p ~/mods cp -r ~/.claude/dev-mods/<id-sesije>/moj-mod ~/mods/moj-mod claude --plugin-dir ~/mods/moj-mod
Najlakše je zamoliti Claudea da to napravi umjesto tebe i objasni ti kako ćeš ga učitati sljedeći put.
Sigurnost: prije nego instaliraš tuđi mod
Mod je kod koji radi s tvojim dopuštenjima i nije u sandboxu. Može čitati i pisati tvoje datoteke, pokretati programe, slati mrežne zahtjeve i čitati API ključeve iz tvojih postavki. Vidi svaki prompt i svaki poziv alata, a može i odobriti poziv alata umjesto tebe, čak i onaj za koji bi te inače pitalo ili koji bi tvoj hook blokirao.
- Instaliraj samo modove od autora i marketplacea kojima vjeruješ.
- Prije instalacije pogledaj što mod radi. Naredba ispod ga ne pokreće, nego samo ispiše koje događaje hvata (hooks) i što traži od Claude Codea (calls).
claude plugin validate ./ime-moda
Ako nešto pođe po zlu: jedan mod isključiš u /plugin, sve instalirane modove za jednu sesiju ugasiš pokretanjem s claude --safe-mode, a trajno ih gasiš postavkom "disableAllHooks": true u ~/.claude/settings.json. Pazi, ta postavka gasi i tvoje obične hookove i prilagođenu status liniju.
Izvori
- Službena dokumentacija: code.claude.com/docs/en/plugins/mods/overview
- Kako napraviti mod: code.claude.com/docs/en/plugins/mods/create
- Primjeri: github.com/anthropics/claude-code-playground (mapa claude-code/mods)
- Pregled modova: claude.dev/mods