[{"data":1,"prerenderedAt":311},["ShallowReactive",2],{"content-\u002Fguides\u002Finstall-claude-plugins":3,"children-\u002Fguides\u002Finstall-claude-plugins":310},{"id":4,"title":5,"author":6,"body":7,"budget_tier":6,"build_tags":6,"created":293,"description":294,"document_type":295,"extension":296,"game":6,"install":6,"investment_tier":6,"league":6,"meta":297,"navigation":298,"patch":6,"path":299,"plugin":6,"profit_per_hour":6,"ratings":6,"seo":300,"skills_count":6,"status":6,"stem":301,"strategy_tier":6,"tags":302,"updated":293,"version":6,"weight":308,"__hash__":309},"content\u002Fguides\u002Finstall-claude-plugins.md","Install Claude Code plugins in two commands",null,{"type":8,"value":9,"toc":283},"minimark",[10,14,18,23,34,45,48,52,55,63,70,73,79,85,89,97,103,110,113,117,125,174,181,185,191,197,201,218,224,230,244,254,258],[11,12,5],"h1",{"id":13},"install-claude-code-plugins-in-two-commands",[15,16,17],"p",{},"A Claude Code plugin is a folder of skills, agents, hooks, and slash\ncommands that Claude installs per project and loads only when needed.\nThis marketplace ships 28 of them. The install is two commands — one for\nthe marketplace, one per plugin.",[19,20,22],"h2",{"id":21},"prerequisites","Prerequisites",[15,24,25,26,33],{},"You need ",[27,28,32],"a",{"href":29,"rel":30},"https:\u002F\u002Fclaude.com\u002Fclaude-code",[31],"nofollow","Claude Code"," installed. Plugin support\nlanded in v2.0+; check yours with:",[35,36,42],"pre",{"className":37,"code":39,"language":40,"meta":41},[38],"language-sh","claude --version\n","sh","",[43,44,39],"code",{"__ignoreMap":41},[15,46,47],{},"If you're below 2.0, upgrade before continuing. The plugin commands don't exist\non older versions.",[19,49,51],{"id":50},"step-1-add-the-marketplace","Step 1 — add the marketplace",[15,53,54],{},"In any Claude Code session, run:",[35,56,61],{"className":57,"code":59,"language":60},[58],"language-text","\u002Fplugin marketplace add aiocean\u002Fclaude-plugins\n","text",[43,62,59],{"__ignoreMap":41},[15,64,65,66,69],{},"This tells Claude to fetch the plugin index from this repo's\n",[43,67,68],{},".claude-plugin\u002Fmarketplace.json",". The fetch is one-time per marketplace —\nsubsequent installs hit the cached index.",[15,71,72],{},"You can verify with:",[35,74,77],{"className":75,"code":76,"language":60},[58],"\u002Fplugin marketplace list\n",[43,78,76],{"__ignoreMap":41},[15,80,81,84],{},[43,82,83],{},"aiocean-plugins"," should appear in the output.",[19,86,88],{"id":87},"step-2-install-a-plugin","Step 2 — install a plugin",[15,90,91,92,96],{},"Pick a plugin from the ",[27,93,95],{"href":94},"\u002Fplugins","catalog"," and install it by name:",[35,98,101],{"className":99,"code":100,"language":60},[58],"\u002Fplugin install aio-epub-translate@aiocean-plugins\n",[43,102,100],{"__ignoreMap":41},[15,104,105,106,109],{},"The ",[43,107,108],{},"@aiocean-plugins"," suffix disambiguates which marketplace the plugin comes\nfrom — useful when you have multiple marketplaces installed and there's a name\ncollision. With only this marketplace installed, the suffix is optional but\nexplicit is safer.",[15,111,112],{},"After install, Claude downloads the plugin's files into your local plugin\ncache, indexes any skills inside, registers hooks, and exposes commands. None\nof this requires a restart.",[19,114,116],{"id":115},"what-happens-next","What happens next",[15,118,119,120,124],{},"The plugin is ",[121,122,123],"em",{},"installed"," but most of its contents don't activate until needed:",[126,127,128,140,154,164],"ul",{},[129,130,131,135,136,139],"li",{},[132,133,134],"strong",{},"Skills auto-trigger"," when your message contains a description match.\nExample: installing ",[43,137,138],{},"aio-debug"," adds zero context cost while idle, but\nthe next time you say \"this test is failing\", the skill loads its\ndebugging workflow into the session.",[129,141,142,145,146,149,150,153],{},[132,143,144],{},"Hooks fire"," on tool calls (",[43,147,148],{},"PreToolUse",", ",[43,151,152],{},"PostToolUse",", etc.) the plugin\ndeclared. These run silently in the background.",[129,155,156,159,160,163],{},[132,157,158],{},"Commands"," show up as ",[43,161,162],{},"\u002F\u003Ccommand-name>"," autocompletes.",[129,165,166,169,170,173],{},[132,167,168],{},"Agents"," become available to spawn via the ",[43,171,172],{},"Agent"," tool when Claude\ndecides one fits the task.",[15,175,176,177,180],{},"The plugin manifest at ",[43,178,179],{},"plugins\u002F{name}\u002F.claude-plugin\u002Fplugin.json"," declares\nwhich surfaces each plugin uses, so installing a \"knowledge-only\" plugin (just\nskills) costs nothing until a relevant message comes in.",[19,182,184],{"id":183},"updating-and-uninstalling","Updating and uninstalling",[35,186,189],{"className":187,"code":188,"language":60},[58],"\u002Fplugin update aio-epub-translate@aiocean-plugins\n\u002Fplugin uninstall aio-epub-translate@aiocean-plugins\n",[43,190,188],{"__ignoreMap":41},[15,192,193,196],{},[43,194,195],{},"update"," re-fetches against the marketplace's latest manifest. Each\nplugin follows semantic versioning — patch for fixes, minor for new\ncapabilities, major for breaking behavior. Major bumps are the ones that\ncan change skill behavior under you.",[19,198,200],{"id":199},"common-pitfalls","Common pitfalls",[15,202,203,206,207,209,210,213,214,217],{},[132,204,205],{},"\"Plugin not found\""," — double-check the plugin name matches what's in the\n",[27,208,95],{"href":94},". Names are case-sensitive and dash-separated. ",[43,211,212],{},"aio_epub"," ≠\n",[43,215,216],{},"aio-epub-translate",".",[15,219,220,223],{},[132,221,222],{},"Stale marketplace index"," — if a plugin was added recently and you don't see\nit, refresh the marketplace:",[35,225,228],{"className":226,"code":227,"language":60},[58],"\u002Fplugin marketplace update aiocean-plugins\n",[43,229,227],{"__ignoreMap":41},[15,231,232,235,236,239,240,243],{},[132,233,234],{},"Skills don't trigger"," — skills load on fuzzy-match against your message, not\non plugin install. If the skill exists but doesn't fire, the description in\nits ",[43,237,238],{},"SKILL.md"," frontmatter doesn't match your phrasing. Try keywords from the\n",[27,241,242],{"href":94},"plugin page"," — those are the trigger words.",[15,245,246,249,250,253],{},[132,247,248],{},"Permission prompts on first run"," — plugins can ship hooks that run shell\ncommands or modify files. Claude prompts before each action the first time;\napprove once and the permission persists for the session. To set permanent\npermissions, edit ",[43,251,252],{},".claude\u002Fsettings.json"," in your project.",[19,255,257],{"id":256},"next-steps","Next steps",[126,259,260,267,275],{},[129,261,262,263,266],{},"Browse the ",[27,264,265],{"href":94},"plugin catalog"," and install one that fits today's work.",[129,268,269,270,274],{},"Read about ",[27,271,273],{"href":272},"\u002Fguides\u002Fwriting-claude-md-files","writing CLAUDE.md"," — the\nper-project file that tunes Claude's behavior independent of plugins.",[129,276,277,278,282],{},"Understand the ",[27,279,281],{"href":280},"\u002Fguides\u002Fskills-agents-hooks","skill \u002F agent \u002F hook split"," so\nyou know which surface a future plugin should target.",{"title":41,"searchDepth":284,"depth":284,"links":285},2,[286,287,288,289,290,291,292],{"id":21,"depth":284,"text":22},{"id":50,"depth":284,"text":51},{"id":87,"depth":284,"text":88},{"id":115,"depth":284,"text":116},{"id":183,"depth":284,"text":184},{"id":199,"depth":284,"text":200},{"id":256,"depth":284,"text":257},"2026-05-25","Add the aiocean marketplace to Claude Code and install plugins on demand. Two commands, what happens after install, and the most common first-time pitfalls.","guide","md",{},true,"\u002Fguides\u002Finstall-claude-plugins",{"title":5,"description":294},"guides\u002Finstall-claude-plugins",[303,304,305,306,307],"installation","onboarding","claude-code","plugins","getting-started",0,"whse4xycNzgvY6fMoHxyaFajiz7zBxSsUp-6x-hTQgg",[],1779702153310]