# Plugin Install Scope

> Who gets a plugin: just you, your team, or you in one repo.

**Field:** Artificial Intelligence  
**Category:** Claude Code  
**Also known as:** plugin scope, --scope project, enabledPlugins

## Think of it like

It is like a toy. You can share it with the class, keep it in your bag, or leave it on one desk.

## Definition

A plugin install scope says where a plugin you install is turned on. User scope turns it on for you in every project. Project scope turns it on for everyone in a repo, through the shared settings file. Local scope turns it on just for you in one repo. When two scopes disagree, local beats project, and project beats user.

## Example

Emma installs a formatter for the project and commits the settings file. Each person on her team runs the install once in their own copy. Then it is on for all of them.

## Example code

```bash
claude plugin install formatter@your-org --scope project
```

Turn the plugin on for everyone who works in this repo.

## Why it matters

It decides who else gets the plugin. A project scope shares it with the team, while user and local scope keep it to you.

## Common mistake

Thinking that a committed project entry downloads the plugin for the whole team. It only turns it on. Each person still runs the install once in their copy of the repo.

## Three principles

- **User.** You, in every project.
- **Project.** Your team, in one repo.
- **Local.** You, in one repo.

## Related terms

- [Claude Code Plugin](https://learn.benibix.com/term/ai/claude-code-plugin)
- [Plugin Marketplace](https://learn.benibix.com/term/ai/plugin-marketplace)
- [Project Settings File](https://learn.benibix.com/term/ai/project-settings-file)
- [Local Settings File](https://learn.benibix.com/term/ai/local-settings-file)
- [User Settings File](https://learn.benibix.com/term/ai/user-settings-file)

![Using a plugin runs from a marketplace, to the install command, to a scope of user, project or local. Making one runs from validate, to eval, to sharing it.](https://learn.benibix.com/diagrams/cli-plugin-flow.svg)

---

Source: https://learn.benibix.com/term/ai/plugin-install-scope
Author: Behnia Zarei (a developer in Vienna, Austria, who builds and teaches data, AI and business intelligence at BENIBIX)
Publisher: BENIBIX Learn (https://learn.benibix.com/)
Last updated: 2026-11-19
Licence: CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/). Quote freely with attribution.
