Installing and Managing Plugins

Installing a plugin adds its Skills, Agents, Hooks, and MCP servers directly into Claude Code. This guide covers the full lifecycle from installation to marketplace addition, updates, and removal.

플러그인 설치

Here is an example installing the commit-commands plugin from the official Anthropic marketplace. Other plugins follow the same process.

터미널에서 설치

# Open details panel and select scope to install inside a session
/plugin install commit-commands@claude-plugins-official

Running this command opens the plugin details view. You can review the bundled components and estimated context cost before selecting an installation scope.

Installation Status Messages:

Message	Meaning
Plugin is now active.	Immediately activated in the current session
Run /reload-plugins to activate.	Panel closes and automatically reloads
The plugin couldn't be loaded	Error occurred — check the /plugin Errors tab

VS Code에서 설치

1. Type /plugins in the prompt input → open the Manage plugins panel
2. Under the Plugins tab, search for the plugin and click Install
3. Select an installation scope to complete

Changes take effect in open sessions immediately without a restart.

셸에서 직접 설치 (비인터랙티브)

For non-interactive terminal scripting without an active Claude Code session:

# Default is user scope
claude plugin install commit-commands@claude-plugins-official

# Install into project scope
claude plugin install formatter@your-org --scope project

Pre-register Marketplace

If you have never run an interactive session on this machine, the official marketplace may not be registered. Run this before scripting:

claude plugin marketplace add anthropics/claude-plugins-official

설치 범위 선택

Scope	Location	Target
User scope (default)	~/.claude/settings.json	All projects on this machine
Project scope	.claude/settings.json	All collaborators in this repo (git-committable)
Local scope	.claude/settings.local.json	Current user in this repo only

Committing settings.json enables the plugin for collaborators, but each collaborator must still install the plugin on their machine.

마켓플레이스 추가

To install plugins outside the official catalog (team-internal or community plugins), add the marketplace first:

# GitHub repository
/plugin marketplace add your-org/plugins

# Pin to branch or tag
/plugin marketplace add your-org/plugins#v1.2.0

# Git URL (GitLab, etc.)
/plugin marketplace add https://gitlab.example.com/group/marketplace.git

# Local directory
/plugin marketplace add ./my-marketplace

# Add marketplace and install plugin simultaneously (v2.1.275+)
/plugin install deploy-helper --marketplace your-org/plugins

Once added, find plugins under the /plugin Discover tab.

플러그인 관리

목록 확인

# Inside a session
/plugin

# From shell
claude plugin list

활성화·비활성화·삭제

# From shell
claude plugin enable formatter@your-org
claude plugin disable formatter@your-org
claude plugin uninstall formatter@your-org --scope project

Inside a session, navigate to /plugin → Installed tab, press Space to toggle enable/disable, and Enter for the detailed menu to uninstall.

설치된 플러그인의 컨텍스트 비용 확인

claude plugin details commit-commands@claude-plugins-official

The Always-on line indicates the token footprint added to every session.

업데이트

Plugins from the Anthropic official marketplace update automatically at session launch. Run /reload-plugins to apply updates to your active session.

To update an individual plugin immediately:

# Inside a session
/plugin  → Installed tab → Update now

# From shell
claude plugin update commit-commands@claude-plugins-official

To turn off auto-updates for a marketplace, go to /plugin → Marketplaces tab, select the marketplace, and choose Disable auto-update.

의존성(Dependencies) 관리

When a plugin depends on other plugins, dependencies are installed automatically.

Error	Cause	Solution
dependency-unsatisfied	Dependency not installed or disabled	Run the claude plugin install command in the error message
range-conflict	Conflicting versions required by multiple plugins	Update or uninstall one of the conflicting plugins
dependency-version-unsatisfied	Installed version out of required range	Re-resolve with claude plugin install <dependency>@<marketplace>

Automatically installed dependencies remain on disk after the parent plugin is removed. To clean them up:

# List and prune orphaned dependencies
claude plugin prune

# Uninstall and prune dependencies at the same time
claude plugin uninstall deploy-kit --prune

다음 단계

• Creating Your First Plugin →
• Operating Marketplaces →
• Plugin System Overview →