← Back to Documentation

Getting Started

Install and use your first AI agent plugin in 5 minutes

⏱️ 5 min read • 📚 Beginner

Prerequisites

  • ✓
    Claude Code CLI

    Install via npm install -g @anthropic/claude-code

  • ✓
    Anthropic API Key

    Get yours at console.anthropic.com

  • ✓
    Git (optional)

    For cloning and customizing plugins locally

Step-by-Step Installation

1

Browse Available Plugins

Visit our Plugin Catalog to find the right plugin for your needs. Each plugin is organized by role.

Popular choices: custom-plugin-python, custom-plugin-react, custom-plugin-devops

2

Install the Plugin

Open Claude Code and run the install command:

Terminal 
/plugin install pluginagentmarketplace/custom-plugin-python

Replace python with your chosen role.

3

Restart Claude Code

Plugins are loaded at startup. Close and reopen Claude Code to activate the new plugin.

Important: Always restart after installing new plugins. Use Cmd+Q (macOS) or close the terminal completely.

4

Start Using Your Agent

The new agents are now available. Invoke them with the Task tool:

Usage Example 
# Ask Claude to use the Python expert agent
"Use the python-expert agent to review my code"

# Or use the Task tool directly
Task(subagent_type="python-expert",
     prompt="Review src/main.py for best practices")

Verify Installation

Run these commands to verify your plugin is installed correctly:

List installed plugins 
/plugin list
Check available agents 
/agents

You should see your new plugin and its agents listed.

What's Next?

✏️

Customize Your Plugin

Learn how to modify agents, add skills, and tailor the plugin to your needs.

🧠

Explore AI Mechanisms

Discover how to use collective intelligence features like brainstorming and voting.

📦

Browse More Plugins

Explore all 69 available plugins organized by role and category.

🤝

Contribute

Share your improvements and help grow the plugin ecosystem.

Troubleshooting

Plugin not found after installation ▼
  1. Make sure you restarted Claude Code completely
  2. Check the plugin path with /plugin list
  3. Clear plugin cache: rm -rf ~/.claude/plugins/cache/*
  4. Reinstall the plugin
Agent not responding or not recognized ▼
  1. Verify the agent name matches exactly (case-sensitive)
  2. Check if the plugin.json has correct paths
  3. Ensure agent.md files have proper YAML frontmatter
  4. Look for errors in Claude Code output
Installation permission errors ▼

If you encounter permission issues:

  1. Check ~/.claude/plugins/ directory permissions
  2. Run Claude Code as the same user that owns the directory
  3. Try manual clone: git clone into a local folder

Still having issues? Open an issue on GitHub