通俗版 Claude Code 文档

结构照原 docs,内容改成真能照着做的人话版。

查看原始文档 目录顺序与官方保持一致

Tools and plugins

发现和安装现成插件

发现和安装现成插件 这一页讲的,就是 发现和安装现成插件 这件事在 Claude Code 里到底怎么用。

页面信息

对应原页

发现和安装现成插件

页面性质

第三方中文解释页

使用建议

先看人话解释,再对照原页命令和代码

这页不是官方原文,而是顺着官方文档结构做的中文解释版。命令、参数、配置名这些硬东西尽量保留,解释部分则尽量讲成人能照着做的话。

如果你碰到特别敏感的配置、权限或企业环境差异,最好顺手点上面的“查看原始文档”再核一遍。

这一页先讲明白

这一页讲去哪找现成插件、怎么装、怎么判断值不值得装。

重点不是装得多,而是挑对。

别人已经做好的插件,能省你重复造轮子。但轮子也有好有坏,先看它解决的场景是不是你的刚需。

安装前最好先看清插件带了哪些能力,别把自己不需要的权限也一起带进来。

先找最贴近你工作流的插件,比如审查代码、连外部系统、补测试。

装完先在小项目试,确认没副作用,再推广到主项目。

预留广告位

正文中段响应式广告 等你后面真接 AdSense,这里再放正式广告。

Documentation Index

这里不是让你背"Documentation Index"这个词,而是让你看它真干活时怎么使。

如果你打算把外接能力往里挂,这里提到的 hooks、MCP、skills、memory 都要分清各自负责哪一摊。

How marketplaces work

这一块主要是在说"How marketplaces work"真到手上该怎么用,哪里最容易踩坑。

Official Anthropic marketplace

这里主要是在交代"Official Anthropic marketplace"这一块会碰到哪些事。

这里还牵扯作用域,意思就是这条规则到底管当前项目、你个人,还是只管这一趟会话。

终端里敲

Official Anthropic marketplace

真到动手的时候了,下面这条直接敲一遍,看它回什么。

/plugin install github@claude-plugins-official

Code intelligence

这里不是让你背"Code intelligence"这个词,而是让你看它真干活时怎么使。

这里还牵扯作用域,意思就是这条规则到底管当前项目、你个人,还是只管这一趟会话。

External integrations

这里不是让你背"External integrations"这个词,而是让你看它真干活时怎么使。

这里还牵扯作用域,意思就是这条规则到底管当前项目、你个人,还是只管这一趟会话。

Development workflows

这一块主要是在说"Development workflows"真到手上该怎么用,哪里最容易踩坑。

看这段时要特别盯工具和权限边界,别为了省事一把全开。

Output styles

这一块主要是在说"Output styles"真到手上该怎么用,哪里最容易踩坑。

如果你打算把外接能力往里挂,这里提到的 hooks、MCP、skills、memory 都要分清各自负责哪一摊。

Try it: add the demo marketplace

这里不是让你背"Try it: add the demo marketplace"这个词,而是让你看它真干活时怎么使。

终端里敲

Try it: add the demo marketplace 1

真到动手的时候了,下面这条直接敲一遍,看它回什么。

/plugin marketplace add anthropics/claude-code
终端里敲

Try it: add the demo marketplace 2

真到动手的时候了,下面这条直接敲一遍,看它回什么。

/plugin install commit-commands@anthropics-claude-code
直接对 Claude 说

Try it: add the demo marketplace 3

这里不用敲命令,直接把下面这句话发给 Claude 就行,让它按"Try it: add the demo marketplace"这一段的意思去办。

/commit-commands:commit

Add marketplaces

这一段是在说怎么用 the /plugin marketplace add command 去做 add marketplaces from different sources.。看这种内容,光知道名字没用,还是得落到手上。

Add from GitHub

这一段主要是在把"Add from GitHub"讲实,不是只摆个标题给你看。

这里还牵扯作用域,意思就是这条规则到底管当前项目、你个人,还是只管这一趟会话。

终端里敲

Add from GitHub

先别急着往下翻,下面这条命令跑完,心里才有底。

/plugin marketplace add anthropics/claude-code

Add from other Git hosts

这一段主要是在把"Add from other Git hosts"讲实,不是只摆个标题给你看。

直接对 Claude 说

Add from other Git hosts 1

最省事的做法,就是把下面这句原样说给 Claude。

/plugin marketplace add https://gitlab.com/company/plugins.git
直接对 Claude 说

Add from other Git hosts 2

最省事的做法,就是把下面这句原样说给 Claude。

/plugin marketplace add git@gitlab.com:company/plugins.git
直接对 Claude 说

Add from other Git hosts 3

最省事的做法,就是把下面这句原样说给 Claude。

/plugin marketplace add https://gitlab.com/company/plugins.git#v1.0.0

Add from local paths

这一段主要是在把"Add from local paths"讲实,不是只摆个标题给你看。

直接对 Claude 说

Add from local paths 1

最省事的做法,就是把下面这句原样说给 Claude。

/plugin marketplace add ./my-marketplace
改配置

Add from local paths 2

这会儿轮到改配置了,字段名和关键字别自己乱换。

/plugin marketplace add ./path/to/marketplace.json

Add from remote URLs

看到这里,就把"Add from remote URLs"当成一件真要上手的活来看。

改配置

Add from remote URLs

这一段说完,最后还得写到配置里才算真的生效。

/plugin marketplace add https://example.com/marketplace.json

Install plugins

这段就是手把手操作,照顺序来最稳。

这里还牵扯作用域,意思就是这条规则到底管当前项目、你个人,还是只管这一趟会话。

直接对 Claude 说

Install plugins

到这里其实就剩一句话,把下面这句发出去就行。

/plugin install plugin-name@marketplace-name

Manage installed plugins

看到这类标题,就把它当成日常管摊子的规矩。

这里还牵扯作用域,意思就是这条规则到底管当前项目、你个人,还是只管这一趟会话。

直接对 Claude 说

Manage installed plugins 1

这一步不用你自己动手配什么,把下面这句话交出去就行。

/plugin disable plugin-name@marketplace-name
直接对 Claude 说

Manage installed plugins 2

这一步不用你自己动手配什么,把下面这句话交出去就行。

/plugin enable plugin-name@marketplace-name
直接对 Claude 说

Manage installed plugins 3

这一步不用你自己动手配什么,把下面这句话交出去就行。

/plugin uninstall plugin-name@marketplace-name
终端里敲

Manage installed plugins 4

这一段不是只让你理解意思,下面这条命令就是现在要跑的。

claude plugin install formatter@your-org --scope project
claude plugin uninstall formatter@your-org --scope project

Apply plugin changes without restarting

这一段更像在讲判断条件,什么时候该上,什么时候先别急。把触发条件看清,比背标题更重要。

这里还牵扯作用域,意思就是这条规则到底管当前项目、你个人,还是只管这一趟会话。

直接对 Claude 说

Apply plugin changes without restarting

到这里其实就剩一句话,把下面这句发出去就行。

/reload-plugins

Manage marketplaces

看到这类标题,就把它当成日常管摊子的规矩。

Use the interactive interface

这一段是在把 /plugin and go to the Marketplaces tab to: 真跑起来。别只看命令长什么样,还得看跑完该出现什么。

Use CLI commands

看到这里,就把"Use CLI commands"当成一件真要上手的活来看。

直接对 Claude 说

Use CLI commands 1

这一步不用你自己动手配什么,把下面这句话交出去就行。

/plugin marketplace list
直接对 Claude 说

Use CLI commands 2

这一步不用你自己动手配什么,把下面这句话交出去就行。

/plugin marketplace update marketplace-name
直接对 Claude 说

Use CLI commands 3

这一步不用你自己动手配什么,把下面这句话交出去就行。

/plugin marketplace remove marketplace-name

Configure auto-updates

这里讲怎么把某个开关拧对。重点不是概念,而是你该在哪儿改、改完怎么确认生效。

如果你看到环境变量或 settings.json,意思通常都是:这不是会话里临时喊一声就行,而是要把开关真正写进环境或配置。

关键片段

Configure auto-updates

下面这块是这一段最值钱的原文样板,先对着看一眼。

export DISABLE_AUTOUPDATER=1
export FORCE_AUTOUPDATE_PLUGINS=1

Configure team marketplaces

这一段主要是在拧开关,地方和顺序都别搞错。

这里还牵扯作用域,意思就是这条规则到底管当前项目、你个人,还是只管这一趟会话。

改配置

Configure team marketplaces

想把这条规矩固定住,就把下面这块老老实实写进去。

{
  "extraKnownMarketplaces": {
    "my-team-tools": {
      "source": {
        "source": "github",
        "repo": "your-org/claude-plugins"
      }
    }
  }
}

Security

这一段主要是在把"Security"讲实,不是只摆个标题给你看。

这里还牵扯作用域,意思就是这条规则到底管当前项目、你个人,还是只管这一趟会话。

Troubleshooting

这里讲的是怎么找毛病,先查明白哪一步出错,再决定怎么修。

/plugin command not recognized

这一段更像在讲判断条件,什么时候该上,什么时候先别急。把触发条件看清,比背标题更重要。

Common issues

这里讲的是怎么找毛病,先查明白哪一步出错,再决定怎么修。

看这段时要特别盯工具和权限边界,别为了省事一把全开。

Code intelligence issues

遇到这种内容,别急着大拆大改,先按它给的路子把问题缩小。

这里还牵扯作用域,意思就是这条规则到底管当前项目、你个人,还是只管这一趟会话。

Next steps

这里不是让你背"Next steps"这个词,而是让你看它真干活时怎么使。

如果你打算把外接能力往里挂,这里提到的 hooks、MCP、skills、memory 都要分清各自负责哪一摊。

照着做一遍

第一次装现成插件,先别一下装一串。

先接一个市场,再装一个最贴近当前活路的插件,装完立刻试。

终端里敲

第 1 步:先加插件来源

先把市场接进来,不然你后面连去哪挑都没有门。

claude plugin marketplace add demo https://example.com/marketplace.json
终端里敲

第 2 步:先搜一遍可装插件

先看看摊子上有什么,再决定装谁。

claude plugin search
终端里敲

第 3 步:装一个最贴近当前工作的插件

别图热闹,先装现在最刚需的那一个。

claude plugin install plugin-name
直接对 Claude 说

第 4 步:装完马上验

确认功能真出现了,再决定要不要继续装别的。

/plugin
/reload-plugins

一眼看懂这一页

这页的作用,就是把原本偏专业的话题,拆成能直接照着走的明白话。

发现和安装现成插件
   |
   v
发现和安装现成插件 这一页讲的,就是 发现和安装现成插件 这件事在 Claude Code 里到底怎么用。
   |
   v
照着步骤去做

文末提醒

这站会按官方 docs 的导航和内容变化继续重生成,原站加页、删页、改页时,这里会跟着更新。

人话解释会尽量顺着原页往下讲,但命令、参数名、配置名这些硬东西还是保留原样,免得你抄过去跑不起来。