Claude Code 插件安装选项详解¶

根据对 Claude Code 插件系统的分析，安装插件时有几个主要选项，它们的含义和区别如下：

1. 安装范围（--scope 参数）¶

这是最重要的安装选项，决定插件的作用范围：

选项	含义	存储位置	适用场景
user（默认）	用户级安装	`C:\Users\用户名\.claude\plugins\`	所有项目都能使用，适合常用工具
project	项目级安装	项目目录下的 `.claude/plugins/`	仅当前项目可用，适合项目专用插件
local	本地安装	临时目录或会话存储	临时测试插件，会话结束后可能不保留

示例命令：

# 用户级安装（默认）
claude plugin install hookify

# 项目级安装
claude plugin install --scope project hookify

# 本地安装
claude plugin install --scope local hookify

2. 插件来源选择¶

插件可以从不同的市场（marketplace）安装：

来源	说明	示例
官方市场	Anthropic 维护的插件集合	`claude-plugins-official`
第三方市场	社区或开发者维护的插件	`ui-ux-pro-max-skill`

安装时指定市场：

# 从官方市场安装（默认）
claude plugin install hookify@claude-plugins-official

# 从特定市场安装
claude plugin install ui-ux-pro-max@ui-ux-pro-max-skill

3. 安装时的其他选项¶

插件标识格式¶

简写：claude plugin install hookify（自动从可用市场查找）
完整格式：插件名@市场名（指定具体来源）

查看已配置的市场¶

claude plugin marketplace list

4. 实际区别与建议¶

范围选择的影响¶

方面	user 范围	project 范围	local 范围
持久性	永久保存	项目内保存	临时存储
共享性	所有项目共享	仅当前项目	仅当前会话
版本管理	独立版本	可纳入 git	不保存
适用场景	通用工具（如 git、代码审查）	项目专用（如特定测试框架）	插件测试、一次性使用

5. 查看当前安装状态¶

# 查看已安装插件（显示作用范围）
claude plugin list

# 查看插件详情
claude plugin info <插件名>

6. 实际示例对比¶

假设安装 hookify 插件：

user 范围：¶

安装到：C:\Users\星记\.claude\plugins\
影响范围：所有 Go 项目都能使用 hookify
更新影响：插件更新影响所有项目

project 范围：¶

安装到：D:\GolandProjects\BIGC-XCPC\.claude\plugins\
影响范围：仅 BIGC-XCPC 项目可用
团队协作：插件配置可提交到 git，团队成员共享

local 范围：¶

安装到：临时目录
影响范围：仅当前 Claude Code 会话可用
持久性：退出后可能丢失

7. 常见问题¶

Q：安装时提示找不到插件？¶

A：可能需要指定完整格式：插件名@市场名

Q：如何切换插件范围？¶

A：需要先卸载，再用新范围重新安装

Q：project 范围的插件如何同步？¶

A：.claude/plugins/ 目录可提交到 git，团队成员 git pull 后自动获取

8. 总结¶

选择安装范围主要根据插件用途决定： - 常用工具：选择 user 范围，所有项目都能使用 - 项目专用：选择 project 范围，配置可纳入版本控制 - 测试评估：选择 local 范围，避免影响正式环境

市场选择决定了插件来源： - 官方市场：更稳定可靠，由 Anthropic 维护 - 第三方市场：可能有特色插件，来自社区开发者

文档生成时间：2026-01-29 基于 Claude Code 2.1.23 插件系统分析