Claude Mods: manual de utilizare (ce sunt, instalare, creare)

Răspuns scurt: ce sunt Claude Mods?

Claude Mods sunt plugin-uri pentru Claude Code făcute din handlere de evenimente. Când Claude Code face ceva (apelează un tool, primește un prompt, desenează spinner-ul), apelează funcțiile din mod. Un mod poate observa evenimentul, îl poate rescrie, îl poate înlocui, poate adăuga pane-uri/butoane sau comenzi /proprii. Unele funcții built-in (de exemplu /diff) sunt deja mods.

Mods rulează cu aceleași permisiuni ca tine pe mașină. Nu sunt sandbox-uite. Instalează doar din surse de încredere.

Cerințe: versiune și unde rulează

• Terminal: Claude Code v2.1.287 sau mai nou (claude --version). Mods sunt activate by default.
• Desktop: tab-ul Code, de la ~2.1.286; verifică cu /status.
• UI desenat (pane, band): terminal și Desktop. În VS Code extension, claude -p sau cloud, hooks pot rula, dar desenul UI e limitat sau absent.
• WSL în Desktop: plugin-urile (deci mods) nu sunt disponibile în sesiunile WSL.

Ce poate face un Claude Mod

• Desenează UI: pane lângă transcript, band deasupra promptului, butoane, input-uri
• Rescrie UI-ul existent: rând de tool call, spinner, dialoguri
• Intervine pe tool calls și turn-uri: blochează, rescrie, redirecționează
• Adaugă comenzi /care rulează codul tău imediat, fără un turn Claude
• Partajează stare între hooks (contoare, usage, istoric în $.state)

Cum instalezi Claude Mods

Un mod se instalează ca plugin dintr-un marketplace. Pattern-ul: nume-plugin@nume-marketplace.

• În sesiune: /plugin install token-chart@your-org (exemplu din docs)
• Din shell: claude plugin install token-chart@your-org
• Dacă sesiunea era deja deschisă la instalare din shell: /reload-plugins
• Verifică: /plugin arată o linie tip „1 mod active · nume-mod”
• Înainte de instalare: claude plugin validate ./calea-modului pentru lista de hooks: și calls:

Cum creezi un Claude Mod (manual rapid)

• Pornește claude și descrie ce vrei („un band care arată câte tool calls sunt în turn”).
• Opțional: /plugin-authoring ca să încarci skill-ul built-in de scriere mods.
• Permite hot reload când cere. Mod-ul creat de Claude trăiește în sesiune și poate fi șters după cleanupPeriodDays.
• Ca să-l păstrezi: copiază folderul undeva (de exemplu ~/mods/...), apoi încarcă-l ca plugin sau marketplace local.
• Fără Node/bundler: Claude Code încarcă .js/.ts direct. Structură tipică: plugin.json, hooks/hooks.json, hooks/register.js.

În register.js exporți register(on) și înregistrezi evenimente cu on('tool.call', ...) sau on('ui.render', ...). Hook-ul poate apela next(e), next(eModificat) sau răspunde singur.

Siguranță: ce merită verificat

• Poate citi/scrie fișiere, rula programe, face request-uri de rețea
• Poate citi env vars, settings și chei API din ele
• Vede prompturile și tool calls din sesiune; poate aproba tool calls fără dialog
• Poate consuma usage pe planul/API key-ul tău
• Sandbox-ul Bash nu izolează procesele pornite de mod

Cum le oprești

• Un singur mod: disable/uninstall în /plugin → Installed
• Toate mods instalate, o sesiune: claude --safe-mode
• Toate mods instalate, permanent: "disableAllHooks": true în ~/.claude/settings.json (oprește și settings hooks / status line custom)
• CLAUDE_CODE_ENABLE_FUNCTION_HOOKS din early access: șterge-l; de la 2.1.287 e ignorat

Claude Mods vs hooks, skills și MCP

• Mod: funcții în procesul Claude Code; poate desena UI și rescrie evenimente
• Settings hook: script/HTTP/prompt din settings; bun la allow/deny/log, fără UI
• Skill: SKILL.md cu instrucțiuni pe care Claude le citește
• MCP: server extern cu tool-uri pentru sisteme din afară

Alege un mod când vrei pane, band, comandă custom sau rescriere de evenimente. Dacă ai deja un script de politică, un settings hook e adesea suficient.

Exemple practice de Claude Mods

• token-weather (sample Anthropic): forecast pe context window deasupra promptului
• blast-radius: ține comenzi riscante (rm -rf, force push) și cere confirmare
• replay-theater: /replay pentru editările din ultimul turn
• Contoare de tool calls lângă spinner (exemplul din docs)
• Politici de echipă: un admin poate limita ce mods se încarcă în organizație

Concluzie

Claude Mods sunt calea oficială de a personaliza Claude Code din interior: UI, tool calls, comenzi. Actualizează la 2.1.287+, instalează doar din surse verificate, validează înainte, și păstrează mods create de Claude dacă merită. La Athryx Tech lucrăm zilnic cu Claude Code în proiecte reale; dacă vrei un workflow de echipă (mods, skills, MCP) pentru product development, spune-ne ce vrei să automatizezi.