Claude Code guide in three levels, Beginner to Advanced: hands-on lessons with checked exercises, every volatile fact cited to its source. Independent community guide.
Install and manage plugins
Intermediate · Lesson 8 of 8 · about 25 minutes · Needs: Turn a repeated workflow into a skill, Enforce a rule with a hook, Delegate to a custom subagent, Connect a tool with MCP · Verified against Claude Code v2.1.308 (stable) on 2026-10-25
Goal
By the end of this lesson you can judge a plugin before you install it, trial code intelligence locally on your own code, and share only the plugin your team chose.
You need
- Your repository from lesson 4, with its
.claude/settings.json, a working test command and no uncommitted changes. Choose a small code change you can verify. Run plugin and Git commands in a terminal in this repository; run the final check from your practice copy. - A terminal session on your machine and a language with a code intelligence plugin. The JavaScript and TypeScript commands below also work for the practice repository; for another supported language, use its plugin and server from that page.
- Usage: light, plus downloading a plugin and its language server if you do not have them.
The idea
A plugin packages skills, agents, hooks, MCP servers or language servers. A marketplace is its catalog. claude-plugins-official is Anthropic's official marketplace, but most of what it lists comes from partners and other authors, and a marketplace's name tells you who publishes the catalog, not what each plugin does (Plugin security and trust). Review the components before installing.
The install scope decides who gets the enabled setting:
| Scope | Who gets it | Settings file |
|---|---|---|
| User | You, across projects | ~/.claude/settings.json |
| Project | Your collaborators | .claude/settings.json, committed |
| Local | You, in this repository | .claude/settings.local.json |
A shared setting does not download the plugin to a teammate's machine. They install it too. A local trial lets you evaluate the result before proposing a team dependency.
Code intelligence adds diagnostics and symbol navigation through a language server. Installing the plugin alone does not install that server. Confirm a real lookup, rather than treating an installed label as proof it works.
Worked example
Install the language server first: a code intelligence plugin says which command starts it, but doesn't include it (Install a code intelligence plugin). For JavaScript or TypeScript, the plugin is
typescript-lsp(Anthropic), and its README names the binary. On 2026-10-21, that server's own installation instructions use the following command (typescript-language-server, Community). In a terminal in your repository:npm install -g typescript-language-server typescript@6 command -v typescript-language-serverFor another supported language, use the matching plugin and binary from that page's table.
Start
claudein your repository and stay in auto mode. Open the plugin:/plugin install typescript-lsp@claude-plugins-officialIf Claude Code says
Marketplace "claude-plugins-official" not found, the official marketplace isn't registered on this machine yet, for example because you've only used Claude Code in VS Code. Add it with/plugin marketplace add anthropics/claude-plugins-official, then open the plugin again (Marketplace not found). Nothing installs until you review the details and choose a scope (Install a plugin). Read Will install, and Context cost, its token estimates for every turn and for when its skills and agents load. Then choose Install for you, in this repo only (local scope). A confirmation says whether the plugin is active now or needs/reload-plugins.Confirm the server starts: it starts the first time Claude edits a file the plugin handles. Ask Claude to introduce a type error or a syntax error in one of your source files and then fix it, and look for a
Found N new diagnostic issuesline after the edit (Install a code intelligence plugin). If none appears, open/pluginand check Errors, then verify the server binary is on the launching shell'sPATH.Decide the small change you'll make, and choose a function it could affect. Replace the placeholders and ask:
Use the LSP tool to find the definition and references of <symbol> in <file>. I plan to <change>. Explain which callers that change could affect. Do not edit files yet.Inspect the
LSPtool result and open a returned location. A text search alone does not demonstrate language-server navigation (LSP tool behavior). Make the small intended change, run your tests, review the diff and commit it.
Your turn
Share only the plugin the team chose, so nobody pulls in the trial you're still judging. Use claude-code-setup (Anthropic) to find a gap in this repository's setup.
Merge this block into
.claude/settings.json, preserving the earlier settings, and replace theTODOwith the plugin's full name,<plugin>@<marketplace>(Project plugin settings):"enabledPlugins": { "TODO: claude-code-setup at the official marketplace": true }Review and commit
.claude/settings.json. Keep your personal language-plugin trial out of the shared settings until the team chooses it.Install the project plugin as a teammate would after pulling that commit:
claude plugin install claude-code-setup@claude-plugins-official --scope projectReview
git status: if installation reformatted.claude/settings.json, review and commit that change too.Exit the existing session with
/exit, startclaudein this repository, and requestRecommend Claude Code automations for this project.The plugin's read-only skill recommends automations; it does not implement them. Look for its Skill tool call. If it did not load, invoke/claude-code-setup:claude-automation-recommenderdirectly. Choose one recommendation that fills a real gap, rather than duplicating an existing skill or hook, and note why. Implementing it is optional.Save a machine-readable install list from this repository's root (JSON list output):
mkdir -p .practice claude plugin list --json > .practice/i-8-plugins.jsonThe
--jsonflag matters: the human-readable list is not JSON.
Check
You are done when all of these are true:
- The committed settings turn the plugin on for the project:
git show HEAD:.claude/settings.json | jq .enabledPluginsshows"claude-code-setup@claude-plugins-official": true. - It's installed at project scope and enabled:
jq '.[] | select(.id == "claude-code-setup@claude-plugins-official") | {scope, enabled, projectEnabled}' .practice/i-8-plugins.jsonshows"project",trueandtrue. - Your code intelligence trial is installed at local scope and stays out of the committed settings:
jq '.[] | select(.scope == "local") | .id' .practice/i-8-plugins.jsonshows your-lspplugin. - Self-check (not tested): you verified an LSP definition or reference, and chose a recommendation that fills a real gap.
Run npm run check -- i-8 --dir <your repo> from your practice copy, or npm run check -- i-8 in the copy itself.
If the first item fails, check the name after @: it's the marketplace's name, claude-plugins-official, not its repository. If the second fails, install the project plugin in this repository and save the list again with --json. If the trial item fails, install your language's plugin with local scope, keep it out of enabledPlugins in .claude/settings.json, and save the list again.
Watch out
- A plugin's hooks and servers can run with your user's rights. Read Will install, and keep the MCP configuration you reviewed in lesson 7. With auto-update on for its marketplace, a plugin's files can change after you reviewed them (Plugin security and trust).
- An installed language plugin can still lack a working server. Confirm the binary and an actual lookup before relying on its diagnostics.
Third-party: it can run code on your machine or give Claude new tools. Review it before installing; this guide does not audit it.
Listings checked against the listing bar on 2026-10-21.
Go further
- Anthropic's marketplaces: where to browse the official catalog.
- Code intelligence plugins: language choices, server setup and troubleshooting.
- Create a Claude Code plugin: package your own skills, hooks and subagents.
Sources: Plugins overview · Install and manage plugins · Anthropic's marketplaces · Plugin loading reference · Plugin commands reference · Code intelligence plugins · Troubleshoot plugins · LSP tool behavior · Plugin security and trust · TypeScript plugin README · Language server installation · claude-code-setup README
← Connect a tool with MCP · Intermediate index · Intermediate capstone → · Topic: Plugins · Stuck on this lesson?