它到底是什么

claude plugin list 是 claude plugin 子命令组的一员，在 shell 中运行，不需要进入交互会话。官方文档描述它按安装范围（scope）和来源分组列出已安装的插件，--json 输出中每个插件对象包含 id、name、version、enabled、scope、source 字段。

同一子命令组还有 install、uninstall、enable、disable、update、validate（见官方 Plugins reference 的 Related Commands）。

版本要求：官方 CLI 参考注明 --json 选项需要 Claude Code v2.1.268 或更高版本。

用法 / 语法

claude plugin list [options]

官方示例：

# 列出所有已安装插件
claude plugin list

# 显示 marketplace 中可用的插件
claude plugin list --available

# 以 JSON 输出
claude plugin list --json

输出格式

默认（人类可读）输出按 scope 与来源分组：

从 claude.ai 账号同步来的插件会出现在 Synced from claude.ai 标题下。官方文档说明，同步插件在终端会话中需要 Claude Code v2.1.273 或更高版本。

--json 输出：stdout 的最后一行是一个 JSON 对象，包含：

• command:"list"
• outcome:"ok" 或 "failed"
• message：对结果的人类可读描述
• plugins：插件对象数组，outcome 为 "ok" 时出现；每个插件对象包含 id、name、source、enabled、scope、version

官方明确要求只解析最后一行，因为 Claude Code 可能在它上面打印其他信息。

退出码：官方文档没有给出 claude plugin list 的退出码定义，这里不列表格。脚本中可以读取 JSON 的 outcome 字段判断成败。

Shell 集成 / 自动化

基于"最后一行是 JSON"的约定，取最后一行再交给 jq:

# 先看一遍真实结构(字段名以你本机输出为准)
claude plugin list --json | tail -n 1 | jq .

# 列出已启用插件的 ID
claude plugin list --json | tail -n 1 | jq -r '.plugins[] | select(.enabled) | .id'

# 命令失败时中止脚本
claude plugin list --json | tail -n 1 | jq -e '.outcome == "ok"' >/dev/null

enabled、id 等字段名来自官方文档的列举。正式写入 CI 之前，建议先用第一条命令在你的版本上确认。

与会话内同名命令的差异

CLI 是否也接受 --enabled / --disabled，官方 CLI 参考表没有列出，请以本机 claude plugin list --help 为准。

运行约束 / 限制

常见坑

• 解析 --json 时不要整体 parse stdout：官方文档明确说前面可能有其他输出，只有最后一行是结果对象。
• project scope 安装的插件可能无法用 uninstall / disable 移除（来自单个 issue 报告）：issue #73697 的报告者在 Claude Code 2.1.199 / Windows 11 上遇到，project scope 安装的插件被 claude plugin uninstall 判为"enabled at project scope"，而 claude plugin disable --scope local 又提示 "already disabled at local scope"。报告者推测 uninstall 读的是 ~/.claude/plugins/installed_plugins.json,disable 读的是 settings 文件。该 issue 目前为 open 状态，带有 reproduced 标签（维护者在正式版上复现），与已因 stale 关闭的 #62966 症状相同；上述对 installed_plugins.json 的推测仍是报告者自己的分析。
• --available 与默认模式互斥地切换视图：官方描述是"显示可用插件，而不是已安装插件"。看已安装状态时不要加它。

经典使用场景

• 盘点已安装插件：一次看清各 scope（user / project / local / managed）下有哪些插件、是否启用、版本是什么。
• 脚本化检查：用 --json 配合 jq 判断某个插件 ID 是否已安装或已启用，例如在团队 onboarding 脚本里决定是否需要 claude plugin install。
• 浏览可装插件：--available 在不打开 /plugin 界面的情况下，列出已添加的 marketplace 中的插件。

来源

• Plugins reference - Claude Code Docs
• Discover and install prebuilt plugins through marketplaces - Claude Code Docs
• Issue #73697 · anthropics/claude-code