discover-plugins.md +0 −651 deleted
File Deleted View Diff
1> ## Documentation Index
2> Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt
3> Use this file to discover all available pages before exploring further.
4
5# Откройте и установите готовые плагины через маркетплейсы
6
7> Найдите и установите плагины из маркетплейсов, чтобы расширить Claude Code новыми skills, agents и возможностями.
8
9Плагины расширяют Claude Code с помощью skills, agents, hooks и MCP servers. Маркетплейсы плагинов — это каталоги, которые помогают вам обнаруживать и устанавливать эти расширения без необходимости создавать их самостоятельно.
10
11Вы также можете включить плагины на claude.ai для себя или через вашу организацию. Claude Code синхронизирует их в ваши сеансы без установки через маркетплейс, как описано в разделе [Плагины, синхронизированные с claude.ai](/docs/ru/plugins-reference#synced-plugins).
12
13Ищете способ создать и распространять свой собственный маркетплейс? См. [Создание и распространение маркетплейса плагинов](/docs/ru/plugin-marketplaces).
14
15<h2 id="how-marketplaces-work">
16 Как работают маркетплейсы
17</h2>
18
19Маркетплейс — это каталог плагинов, которые кто-то другой создал и поделился. Использование маркетплейса — это двухэтапный процесс:
20
21<Steps>
22 <Step title="Добавьте маркетплейс">
23 Это регистрирует каталог в Claude Code, чтобы вы могли просмотреть доступные плагины. Никакие плагины еще не установлены.
24 </Step>
25
26 <Step title="Установите отдельные плагины">
27 Просмотрите каталог и установите нужные вам плагины.
28 </Step>
29</Steps>
30
31<h2 id="official-anthropic-marketplace">
32 Официальный маркетплейс Anthropic
33</h2>
34
35Claude Code автоматически добавляет официальный маркетплейс Anthropic (`claude-plugins-official`) при первом интерактивном запуске. Если Claude Code не может его добавить, например, потому что ваша сеть блокирует загрузку или [политика маркетплейса](/docs/ru/plugin-marketplaces#managed-marketplace-restrictions) заблокировала более раннюю попытку, добавьте его самостоятельно с помощью `/plugin marketplace add anthropics/claude-plugins-official`.
36
37Чтобы просмотреть доступные плагины, запустите `/plugin` и перейдите на вкладку **Discover**, или просмотрите каталог на [claude.com/plugins](https://claude.com/plugins).
38
39Чтобы установить плагин из официального маркетплейса, используйте `/plugin install <name>@claude-plugins-official`. Например, чтобы установить интеграцию GitHub:
40
41```shell theme={null}
42/plugin install github@claude-plugins-official
43```
44
45`/plugin` открывает интерактивную панель в терминале CLI. Если Claude сообщает, что `/plugin` недоступен в этой среде, установите плагин другим способом:
46
47* **Приложение Claude для рабочего стола**: используйте [браузер плагинов](/docs/ru/desktop#install-plugins).
48* **Расширение VS Code**: установите из [диалога **Manage plugins**](/docs/ru/vs-code#manage-plugins).
49* **Облачные сеансы**: включите плагин для вашей учётной записи claude.ai, чтобы Claude Code загружал его как [синхронизированный плагин](/docs/ru/plugins-reference#synced-plugins).
50
51Если установка не удалась, сопоставьте сообщение, которое сообщает Claude Code:
52
53* `Marketplace "claude-plugins-official" not found`: добавьте маркетплейс с помощью `/plugin marketplace add anthropics/claude-plugins-official`, затем повторите попытку установки.
54* Плагин [не найден в маркетплейсе](#install-plugins): проверьте имя плагина.
55
56<Note>
57 Официальный маркетплейс поддерживается компанией Anthropic, и включение осуществляется по усмотрению Anthropic. Встроенные формы отправки в приложении добавляют плагины в [маркетплейс сообщества](#community-marketplace), а не в официальный. Чтобы распространять плагины независимо, [создайте свой собственный маркетплейс](/docs/ru/plugin-marketplaces) и поделитесь им с пользователями.
58</Note>
59
60Официальный маркетплейс включает несколько категорий плагинов:
61
62<h3 id="code-intelligence">
63 Code intelligence
64</h3>
65
66Плагины code intelligence включают встроенный инструмент LSP в Claude Code, предоставляя Claude возможность переходить к определениям, находить ссылки и видеть ошибки типов сразу после редактирования. Эти плагины настраивают подключения [Language Server Protocol](https://microsoft.github.io/language-server-protocol/), той же технологии, которая обеспечивает code intelligence в VS Code. В [облачных сеансах](/docs/ru/claude-code-on-the-web) Claude Code не запускает языковые серверы плагинов, поэтому Claude не получает инструмент LSP там.
67
68Установите двоичный файл языкового сервера из таблицы ниже перед использованием этих плагинов; плагин не установит его за вас. Если у вас уже установлен языковой сервер, Claude может предложить вам установить соответствующий плагин при открытии проекта.
69
70| Язык | Plugin | Требуемый двоичный файл |
71| :--------- | :------------------ | :--------------------------- |
72| C/C++ | `clangd-lsp` | `clangd` |
73| C# | `csharp-lsp` | `csharp-ls` |
74| Go | `gopls-lsp` | `gopls` |
75| Java | `jdtls-lsp` | `jdtls` |
76| Kotlin | `kotlin-lsp` | `kotlin-language-server` |
77| Lua | `lua-lsp` | `lua-language-server` |
78| PHP | `php-lsp` | `intelephense` |
79| Python | `pyright-lsp` | `pyright-langserver` |
80| Rust | `rust-analyzer-lsp` | `rust-analyzer` |
81| Swift | `swift-lsp` | `sourcekit-lsp` |
82| TypeScript | `typescript-lsp` | `typescript-language-server` |
83
84Вы также можете [создать свой собственный LSP plugin](/docs/ru/plugins-reference#lsp-servers) для других языков.
85
86<Note>
87 Если вы видите `Executable not found in $PATH` на вкладке `/plugin` Errors после установки плагина, установите требуемый двоичный файл из таблицы [code intelligence](#code-intelligence) для этого плагина.
88</Note>
89
90<h4 id="what-claude-gains-from-code-intelligence-plugins">
91 Что Claude получает от плагинов code intelligence
92</h4>
93
94После установки плагина code intelligence и доступности его двоичного файла языкового сервера Claude получает две возможности:
95
96* **Автоматическая диагностика**: после каждого редактирования файла, которое делает Claude, языковой сервер сообщает об ошибках и предупреждениях, поэтому Claude видит ошибки типов, отсутствующие импорты и проблемы синтаксиса без необходимости запуска компилятора или линтера. Если Claude вводит ошибку, он замечает и исправляет её в том же ходу.
97* **Code navigation**: Claude может использовать языковой сервер для перехода к определениям, поиска ссылок, получения информации о типе при наведении, списка символов, поиска реализаций и отслеживания иерархий вызовов. Эти операции дают Claude более точную навигацию, чем поиск на основе grep, хотя доступность может варьироваться в зависимости от языка и окружения.
98
99Вам не нужно настраивать диагностику сверх установки плагина. Чтобы прочитать их самостоятельно, нажмите **Ctrl+O**, когда Claude Code показывает индикатор, такой как **Found 3 new diagnostic issues in 2 files**.
100
101Если у вас возникли проблемы, см. [Code intelligence troubleshooting](#code-intelligence-issues).
102
103<h3 id="external-integrations">
104 External integrations
105</h3>
106
107Эти плагины объединяют предварительно настроенные [MCP servers](/docs/ru/mcp), чтобы вы могли подключить Claude к внешним сервисам без ручной настройки:
108
109* **Source control**: `github`, `gitlab`
110* **Project management**: `atlassian` (Jira/Confluence), `asana`, `linear`, `notion`
111* **Design**: `figma`
112* **Infrastructure**: `vercel`, `firebase`, `supabase`
113* **Communication**: `slack`
114* **Monitoring**: `sentry`
115
116<h3 id="automatic-security-review">
117 Automatic security review
118</h3>
119
120Плагин `security-guidance` проверяет каждое изменение, которое делает Claude, на предмет распространённых уязвимостей и инструктирует Claude исправить найденные проблемы в том же сеансе. См. [Catch security issues as Claude writes code](/docs/ru/security-guidance) для получения информации о том, что он проверяет и как добавить правила, специфичные для проекта.
121
122<h3 id="development-workflows">
123 Development workflows
124</h3>
125
126Плагины, которые добавляют skills и agents для общих задач разработки:
127
128* **commit-commands**: рабочие процессы Git commit, включая commit, push и создание PR
129* **pr-review-toolkit**: специализированные agents для проверки pull requests
130* **agent-sdk-dev**: инструменты для разработки с Claude Agent SDK
131* **plugin-dev**: набор инструментов для создания собственных плагинов
132
133<h3 id="output-styles">
134 Output styles
135</h3>
136
137Настройте способ ответа Claude:
138
139* **explanatory-output-style**: образовательные сведения о выборе реализации
140* **learning-output-style**: интерактивный режим обучения для развития навыков
141
142<h2 id="community-marketplace">
143 Community marketplace
144</h2>
145
146Маркетплейс сообщества на [`anthropics/claude-plugins-community`](https://github.com/anthropics/claude-plugins-community) размещает плагины третьих сторон, которые прошли автоматическую проверку и проверку безопасности Anthropic. Каждый плагин привязан к определенному коммиту SHA в каталоге. В отличие от официального маркетплейса, вы добавляете его вручную:
147
148```shell theme={null}
149/plugin marketplace add anthropics/claude-plugins-community
150```
151
152Затем установите плагины из него, используя имя маркетплейса `claude-community`:
153
154```shell theme={null}
155/plugin install <plugin-name>@claude-community
156```
157
158Чтобы отправить свой плагин в маркетплейс сообщества, см. [Отправьте свой плагин в маркетплейс сообщества](/docs/ru/plugins#submit-your-plugin-to-the-community-marketplace) в руководстве по созданию плагинов.
159
160<h2 id="try-it-add-the-demo-marketplace">
161 Попробуйте: добавьте демо-маркетплейс
162</h2>
163
164Anthropic также поддерживает [демо-маркетплейс плагинов](https://github.com/anthropics/claude-code/tree/main/plugins) (`claude-code-plugins`) с примерами плагинов, которые показывают, что возможно с системой плагинов. В отличие от официального маркетплейса, вам нужно добавить этот вручную.
165
166<Steps>
167 <Step title="Добавьте маркетплейс">
168 Из Claude Code запустите команду `plugin marketplace add` для маркетплейса `anthropics/claude-code`:
169
170 ```shell theme={null}
171 /plugin marketplace add anthropics/claude-code
172 ```
173
174 Это загружает каталог маркетплейса и делает его плагины доступными для вас.
175 </Step>
176
177 <Step title="Просмотрите доступные плагины">
178 Запустите `/plugin`, чтобы открыть менеджер плагинов. Это открывает интерфейс с вкладками, по которым вы можете переходить, используя **Tab**, или **Shift+Tab** для перемещения назад:
179
180 * **Discover**: просмотрите доступные плагины из всех ваших маркетплейсов
181 * **Installed**: просмотрите и управляйте установленными плагинами
182 * **Marketplaces**: добавляйте, удаляйте или обновляйте добавленные маркетплейсы
183 * **Errors**: просмотрите любые ошибки загрузки плагинов
184 * **Stats**: см. [сколько стоит каждый из ваших skills в контексте и как часто он используется](/docs/ru/skills#find-unused-skills), в сеансах, где доступен `/skill-doctor`
185
186 Перейдите на вкладку **Discover**, чтобы увидеть плагины из маркетплейса, который вы только что добавили. Когда ваш администратор добавил маркетплейс в список разрешённых через управляемый параметр [`pluginSuggestionMarketplaces`](/docs/ru/settings-reference#pluginsuggestionmarketplaces), плагины, отмеченные как релевантные для вашего текущего рабочего каталога, закреплены в верхней части с меткой **suggested for this directory**.
187 </Step>
188
189 <Step title="Установите плагин">
190 Выберите плагин для просмотра его деталей. На панели деталей показано, что содержит плагин и сколько это стоит:
191
192 * Оценка **Context cost**, чтобы вы могли увидеть, сколько токенов плагин добавит к вашему [окну контекста](/docs/ru/features-overview#understand-context-costs) каждый ход
193 * Дата **Last updated** плагина
194 * Раздел **Will install**, в котором перечислены команды, агенты, skills, hooks и серверы MCP и LSP плагина, чтобы вы могли просмотреть ровно то, что он добавляет перед установкой
195
196 Не каждый плагин предоставляет данные, стоящие за этими полями. Для плагинов из локальных или пользовательских маркетплейсов вы можете не увидеть строки **Context cost** и **Last updated**, а раздел **Will install** может показать **Components will be discovered at installation** вместо этого.
197
198 Выберите область установки:
199
200 * **User scope**: установите для себя во всех проектах
201 * **Project scope**: установите для всех сотрудников в этом репозитории
202 * **Local scope**: установите для себя только в этом репозитории
203
204 Например, выберите **commit-commands** (плагин, который добавляет skills рабочего процесса git) и установите его в область пользователя.
205
206 Вы также можете начать установку из командной строки:
207
208 ```shell theme={null}
209 /plugin install commit-commands@claude-code-plugins
210 ```
211
212 См. [Settings files](/docs/ru/settings#where-settings-live), чтобы узнать больше об областях.
213 </Step>
214
215 <Step title="Используйте свой новый плагин">
216 Если сводка установки сообщает `Run /reload-plugins to activate.`, Claude Code затем запустит эту перезагрузку для вас. Если перезагрузка предупреждает, что ваше следующее сообщение будет повторно читать разговор, запустите `/reload-plugins --force` для активации плагина.
217
218 Skills плагина имеют пространство имен по имени плагина, поэтому **commit-commands** предоставляет skills вроде `/commit-commands:commit`.
219
220 Попробуйте, внеся изменение в файл и запустив:
221
222 ```shell theme={null}
223 /commit-commands:commit
224 ```
225
226 Это подготавливает ваши изменения, генерирует сообщение commit и создает commit.
227
228 Каждый плагин работает по-разному. Проверьте описание плагина на вкладке **Discover**, чтобы увидеть команды и skills, которые он предоставляет, или посетите его домашнюю страницу для получения рекомендаций по использованию.
229 </Step>
230</Steps>
231
232<h2 id="add-marketplaces">
233 Добавление маркетплейсов
234</h2>
235
236Используйте команду `/plugin marketplace add` для добавления маркетплейсов из разных источников.
237
238<Tip>
239 **Shortcuts**: вы можете использовать `/plugin market` вместо `/plugin marketplace` и `rm` вместо `remove`.
240</Tip>
241
242* **GitHub repositories**: формат `owner/repo` (например, `anthropics/claude-code`)
243* **Git URLs**: любой URL репозитория git, включая GitLab, Bitbucket и самостоятельно размещенные серверы
244* **Local paths**: каталоги или прямые пути к файлам `marketplace.json`
245* **Remote URLs**: прямые URL к размещенным файлам `marketplace.json`
246* **claude.ai**: маркетплейсы, размещенные на claude.ai для вашей учетной записи, такие как библиотека плагинов вашей организации, которые вы [добавляете по имени из вкладки **Marketplaces** или вашей оболочки](#add-from-claude-ai), а не по источнику
247
248<h3 id="add-from-github">
249 Добавление из GitHub
250</h3>
251
252Добавьте репозиторий GitHub, который содержит файл `.claude-plugin/marketplace.json`, используя формат `owner/repo` — где `owner` — это имя пользователя GitHub или организация, а `repo` — это имя репозитория.
253
254Например, `anthropics/claude-code` относится к репозиторию `claude-code`, принадлежащему `anthropics`:
255
256```shell theme={null}
257/plugin marketplace add anthropics/claude-code
258```
259
260<h3 id="add-from-other-git-hosts">
261 Добавление из других хостов Git
262</h3>
263
264Добавьте репозиторий git маркетплейса, предоставив полный URL. Для URL `https://`, включение суффикса `.git` зависит от хоста:
265
266* **`github.com` и `gitlab.com`**: Claude Code распознает URL репозитория с суффиксом `.git` или без него и клонирует его. Добавление URL `gitlab.com` без суффикса требует Claude Code v2.1.232 или более поздней версии. До v2.1.232 Claude Code рассматривал его как прямую ссылку на размещенный файл `marketplace.json`.
267* **Azure DevOps**: опустите суффикс. Claude Code клонирует любой URL, путь которого содержит `/_git/`. Если вы добавите `.git` к пути `/_git/`, клонирование не удастся.
268* **Все остальные хосты, включая самостоятельно управляемые серверы GitLab**: включите суффикс `.git`, чтобы Claude Code клонировал репозиторий, а не рассматривал URL как прямую ссылку на размещенный файл `marketplace.json`. Для хоста, чьи URL клонирования не содержат суффикса, например AWS CodeCommit, добавьте маркетплейс как запись git в [`extraKnownMarketplaces`](/docs/ru/settings-reference#extraknownmarketplaces). Claude Code клонирует запись git независимо от того, заканчивается ли её URL на `.git`.
269
270Claude Code также клонирует URL `gitlab.com` с вложенными подгруппами, например `https://gitlab.com/group/subgroup/project`.
271
272Включите префикс `https://`. Claude Code v2.1.196 и более поздние версии отклоняют хост, введенный без него, например `gitlab.com/company/plugins.git`, как неправильное сокращение GitHub `owner/repo`, и ошибка указывает вам добавить префикс. Более ранние версии неправильно интерпретируют это как путь репозитория GitHub и не работают при клонировании.
273
274Используя HTTPS:
275
276```shell theme={null}
277/plugin marketplace add https://gitlab.com/company/plugins.git
278```
279
280Используя SSH:
281
282```shell theme={null}
283/plugin marketplace add git@gitlab.com:company/plugins.git
284```
285
286Claude Code клонирует SSH адрес независимо от того, заканчивается ли он на `.git`.
287
288Чтобы добавить конкретную ветку или тег, добавьте `#`, за которым следует ref:
289
290```shell theme={null}
291/plugin marketplace add https://gitlab.com/company/plugins.git#v1.0.0
292```
293
294<h3 id="add-from-local-paths">
295 Добавление из локальных путей
296</h3>
297
298Добавьте локальный каталог, который содержит файл `.claude-plugin/marketplace.json`:
299
300```shell theme={null}
301/plugin marketplace add ./my-marketplace
302```
303
304Вы также можете добавить прямой путь к файлу `marketplace.json`:
305
306```shell theme={null}
307/plugin marketplace add ./path/to/marketplace.json
308```
309
310<h3 id="add-from-remote-urls">
311 Добавление из удаленных URL
312</h3>
313
314Добавьте удаленный файл `marketplace.json` через URL:
315
316```shell theme={null}
317/plugin marketplace add https://example.com/marketplace.json
318```
319
320<Note>
321 Маркетплейсы на основе URL имеют некоторые ограничения по сравнению с маркетплейсами на основе Git. Если установка плагинов из маркетплейса на основе URL не удается, см. [Troubleshooting](/docs/ru/plugin-marketplaces#plugins-with-relative-paths-fail-in-url-based-marketplaces).
322</Note>
323
324<h3 id="add-from-claude-ai">
325 Добавление из claude.ai
326</h3>
327
328В сеансах терминала, где [плагины синхронизируются с вашей учетной записью claude.ai](/docs/ru/plugins-reference#synced-plugins), claude.ai также может перечислять маркетплейсы для вас, такие как библиотека плагинов вашей организации и ваши собственные загрузки на claude.ai. `claude plugin marketplace list` выводит их в разделе `From claude.ai:`, и вкладка `/plugin` **Marketplaces** их отображает. Выберите один там, чтобы добавить его. Добавление маркетплейса из claude.ai требует Claude Code v2.1.273 или более поздней версии.
329
330Чтобы добавить маркетплейс из этого списка в вашей оболочке, запустите `claude plugin marketplace add` с флагом `--claudeai` и именем, показанным в списке:
331
332```bash theme={null}
333claude plugin marketplace add --claudeai claudeai-organization-library
334```
335
336Claude Code регистрирует маркетплейс под локальным именем, которое начинается с `claudeai-`, полученным из имени, под которым claude.ai его перечисляет: маркетплейс, указанный как "Organization library", регистрируется как `claudeai-organization-library`. Установите его плагины по этому имени, например с помощью `claude plugin install <plugin>@claudeai-organization-library`.
337
338Если вы выйдете из системы или войдете с другой учетной записью, маркетплейс остается настроенным, но не показывает плагины, и плагины, которые вы уже установили из него, продолжают загружаться.
339
340Раздел `From claude.ai:` также может перечислять маркетплейсы на основе git, общие через claude.ai. Вы добавляете их с помощью обычной команды `marketplace add`, используя источник, который выводит список.
341
342<h2 id="install-plugins">
343 Установка плагинов
344</h2>
345
346После добавления маркетплейсов вы можете установить плагин по имени. Для маркетплейса, который вы ещё не добавили, вы можете вместо этого [добавить его и установить в одной команде](#add-a-marketplace-and-install-in-one-command).
347
348Для установки по имени:
349
350```shell theme={null}
351/plugin install plugin-name@marketplace-name
352```
353
354Команда открывает детали плагина, где вы выбираете [область установки](/docs/ru/settings#where-settings-live). Вы видите те же варианты, когда запускаете `/plugin`, переходите на вкладку **Discover** и нажимаете **Enter** на плагине:
355
356* **User scope**: установите для себя во всех проектах
357* **Project scope**: установите для всех сотрудников в этом репозитории, что добавляет плагин в `.claude/settings.json`
358* **Local scope**: установите для себя в этом репозитории только, не делится с сотрудниками
359
360Чтобы установить без интерактивного шага, используйте команду оболочки [`claude plugin install`](/docs/ru/plugins-reference#plugin-install), которая устанавливает в область пользователя, если вы не передадите `--scope`. Для плагина с [источником `command`](/docs/ru/plugin-marketplaces#how-users-accept-the-command) передайте `--yes` для принятия команды, которую он отображает.
361
362Вы также можете увидеть плагины с областью **managed**. Они установлены администраторами через [управляемые параметры](/docs/ru/managed-settings) и не могут быть изменены.
363
364Claude Code ищет плагин в своей локальной копии каталога маркетплейса. То, как вы назовёте плагин, контролирует, обновит ли Claude Code эту копию в первую очередь:
365
366* **С именем маркетплейса**: когда вы устанавливаете `plugin-name@marketplace-name`, в сеансе или с помощью `claude plugin install`, Claude Code обновляет этот маркетплейс перед поиском. Claude Code запускает обновление даже если вы отключили [автоматическое обновление](#configure-auto-updates) для маркетплейса или установили `DISABLE_AUTOUPDATER`. До версии 2.1.232 Claude Code не обновлял маркетплейс перед поиском. Claude Code пропускает это обновление, когда:
367 * Маркетплейс не был [добавлен из GitHub, другого хоста Git или удалённого URL](#add-marketplaces) или [claude.ai](#add-from-claude-ai).
368 * [Начальный каталог](/docs/ru/plugin-marketplaces#pre-populate-plugins-for-containers) предоставляет маркетплейс.
369 * Claude Code обновил маркетплейс в течение последних 30 секунд.
370 * Вы установили [`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`](/docs/ru/env-vars).
371 * [Управляемые параметры](/docs/ru/plugin-marketplaces#managed-marketplace-restrictions) блокируют маркетплейс, в этом случае Claude Code также отказывает в установке.
372* **Только имя плагина**: когда вы запускаете `/plugin install plugin-name` в сеансе, Claude Code обновляет только маркетплейсы, которые он также [обновляет в фоне](#configure-auto-updates), и только после того, как поиск не удаётся. Когда вы запускаете `claude plugin install plugin-name`, Claude Code читает кэшированные каталоги без обновления. Чтобы установить плагин, который был опубликован после вашего последнего обновления, запустите `/plugin marketplace update <marketplace-name>` в сеансе или [`claude plugin marketplace update <marketplace-name>`](/docs/ru/plugin-marketplaces#plugin-marketplace-update) в вашей оболочке, затем повторите попытку установки.
373
374Если обновление перед именованной установкой не удаётся, например потому что вы в автономном режиме, Claude Code ищет плагин в кэшированном каталоге в любом случае. `claude plugin install` сообщает `marketplace not refreshed` в своём сообщении об успехе, и `/plugin install` показывает ошибку выше деталей плагина или в его сообщении об отсутствии.
375
376Когда вы устанавливаете из интерфейса `/plugin`, сводка установки сообщает вам, активен ли плагин в вашем текущем сеансе:
377
378* `Plugin is now active.`: Claude Code активировал плагин как часть установки.
379* `Run /reload-plugins to activate.`: плагин ещё не активен, потому что его активация [инвалидирует кэш подсказки](/docs/ru/prompt-caching#enabling-or-disabling-a-plugin) или потому что попытка активации не удалась. Claude Code затем запускает `/reload-plugins` для вас. Если эта перезагрузка предупреждает о кэше подсказки, запустите `/reload-plugins --force` для [активации плагина в любом случае](#apply-plugin-changes-without-restarting).
380* Если плагин не загружается, сводка сообщает об ошибке, и вкладка **Errors** в `/plugin` показывает детали.
381
382До версии 2.1.221 ни одна установка не вступала в силу в текущем сеансе, пока вы не запустили `/reload-plugins` или не перезагрузили.
383
384Команда оболочки `claude plugin install` не запускается в сеансе, поэтому Claude Code загружает плагины, которые он устанавливает, при следующем запуске Claude Code или когда вы запускаете `/reload-plugins` в уже открытом сеансе.
385
386<Warning>
387 Убедитесь, что вы доверяете плагину перед его установкой. Anthropic не контролирует, какие MCP servers, файлы или другое программное обеспечение включены в плагины, и не может проверить, что они работают как предполагается. Проверьте домашнюю страницу каждого плагина для получения дополнительной информации.
388</Warning>
389
390<h3 id="add-a-marketplace-and-install-in-one-command">
391 Добавление маркетплейса и установка в одной команде
392</h3>
393
394Чтобы установить плагин из маркетплейса, который вы ещё не добавили, укажите источник маркетплейса с помощью `--marketplace`. Требуется Claude Code версии 2.1.275 или позже.
395
396```shell theme={null}
397/plugin install quality-review-plugin --marketplace your-org/plugins
398```
399
400Источник принимает [те же формы, что и `/plugin marketplace add`](#add-marketplaces), такие как GitHub `owner/repo`, URL git или локальный путь, за исключением того, что он не может содержать пробелы. Укажите имя плагина без суффикса `@marketplace`.
401
402Claude Code показывает разрешённый источник и просит вас подтвердить перед добавлением маркетплейса. Отказ отменяет установку и ничего не добавляет. После добавления маркетплейса открываются детали плагина и вы выбираете [область установки](/docs/ru/settings#where-settings-live). Если источник совпадает с маркетплейсом, который вы уже добавили, Claude Code пропускает подтверждение и открывает детали плагина в этом маркетплейсе.
403
404<h2 id="manage-installed-plugins">
405 Управление установленными плагинами
406</h2>
407
408Запустите `/plugin` и перейдите на вкладку **Installed**, чтобы просмотреть, включить, отключить или удалить ваши плагины. Список сгруппирован по области и отсортирован так, чтобы вы сначала видели проблемы: плагины с ошибками загрузки или неразрешенными зависимостями появляются в верхней части, затем ваши избранные, с отключенными плагинами, скрытыми за свернутым заголовком внизу.
409
410Из списка вы можете:
411
412* нажать `f`, чтобы добавить в избранное или удалить из избранного выбранный плагин
413* ввести текст для фильтрации по имени плагина или описанию
414* нажать Enter, чтобы открыть подробный вид плагина и включить, отключить или удалить его
415
416Claude Code также отображает [плагины, синхронизированные с вашей учетной записью claude.ai](/docs/ru/plugins-reference#synced-plugins) на вкладке **Installed** с `synced` в качестве их источника. Вы можете включить или отключить один там, если ваша организация не отметила его как обязательный. Чтобы удалить один, отключите его на claude.ai. Синхронизированные плагины появляются в сеансах терминала в Claude Code v2.1.273 или более поздней версии.
417
418Когда вы удаляете плагин, который `.claude/settings.json` проекта включает, Claude Code спрашивает, какую область вы имеете в виду: отключить его только для вас, что записывает переопределение в ваш `.claude/settings.local.json` и оставляет плагин установленным для проекта, или удалить его для всех, что удаляет его из общего `.claude/settings.json`.
419
420Подробный вид показывает компоненты, которые предоставляет плагин: команды, skills, agents, hooks, MCP servers и LSP servers. Тот же инвентарь доступен из командной строки с помощью `claude plugin details`.
421
422Claude Code также отображает плагины маркетплейса, которые вы установили сами, но не использовали в течение как минимум двух недель, в течение как минимум 10 сеансов, под заголовком **Not used recently** на вкладке **Installed**. Подробный вид показывает строку **Last used** для каждого плагина. Используйте их, чтобы найти плагины, которые по-прежнему добавляют стоимость запуска и контекста, хотя вы больше их не используете, затем отключите или удалите их.
423
424Два вида плагинов никогда не отображаются как неиспользуемые:
425
426* плагины, которыми управляет ваша организация, или которые вы загружаете с помощью `--plugin-dir`
427* плагины, которые предоставляют тему, стиль вывода, монитор или workflow, поскольку они обеспечивают ценность без вызова для отслеживания
428
429Заголовок **Not used recently** и строка **Last used** обе скрыты, когда ваша организация ограничивает маркетплейсы с помощью [`strictKnownMarketplaces`](/docs/ru/settings-reference#strictknownmarketplaces).
430
431[Language server](/docs/ru/plugins#add-lsp-servers-to-your-plugin) плагина считается использованным, когда он предоставляет диагностику или отвечает на запрос навигации по коду, поэтому плагин LSP, чей сервер активен в ваших сеансах, не отображается как неиспользуемый. До v2.1.203 активность языкового сервера не могла быть учтена как использование, поэтому плагины, которые предоставляют LSP server, были полностью исключены из группы, так же как плагины темы и стиля вывода по-прежнему есть.
432
433Первый сеанс в версии, которая считает активность языкового сервера, также сбрасывает запись об использовании каждого плагина LSP, который еще не записал никакого использования, поэтому Claude Code не судит плагин, который вы установили ранее, как неиспользуемый на основе данных, записанных до того, как была отслежена активность его сервера.
434
435Когда вы устанавливаете плагин, который объявляет зависимости, вывод установки указывает, какие зависимости были автоматически установлены вместе с ним.
436
437Вы также можете управлять плагинами с помощью прямых команд:
438
439* Когда вы запускаете `/plugin disable`, `/plugin enable` или `/plugin uninstall`, Claude Code открывает панель плагинов для применения изменения и оставляет ее открытой. Нажмите **Esc**, чтобы закрыть панель перед вводом другой команды. [Применение изменений плагина без перезагрузки](#apply-plugin-changes-without-restarting) описывает, когда изменение вступает в силу в вашем сеансе.
440* Для написания скриптов используйте вместо этого команды оболочки `claude plugin`, которые не открывают панель.
441
442Отобразите установленные плагины без открытия меню:
443
444```shell theme={null}
445/plugin list
446```
447
448Передайте `--enabled` или `--disabled`, чтобы показать только плагины в этом состоянии.
449
450Отключите плагин без удаления:
451
452```shell theme={null}
453/plugin disable plugin-name@marketplace-name
454```
455
456Повторно включите отключенный плагин:
457
458```shell theme={null}
459/plugin enable plugin-name@marketplace-name
460```
461
462В этих идентификаторах `plugin-name` — это `name` плагина в [записи маркетплейса](/docs/ru/plugin-marketplaces#plugin-entries), которое может отличаться от `name` в собственном `plugin.json` плагина.
463
464Начиная с Claude Code v2.1.195, **Enable** и **Disable** в интерфейсе `/plugin` работают для плагинов, у которых два имени отличаются, и `/plugin enable` и `/plugin disable` принимают любое имя. Когда вы отключаете такой плагин в более ранней версии, Claude Code сообщает `already disabled` и оставляет его включенным.
465
466Полностью удалите плагин:
467
468```shell theme={null}
469/plugin uninstall plugin-name@marketplace-name
470```
471
472Опция `--scope` позволяет вам нацелить определенную область с помощью команд CLI:
473
474```shell theme={null}
475claude plugin install formatter@your-org --scope project
476claude plugin uninstall formatter@your-org --scope project
477```
478
479<h3 id="apply-plugin-changes-without-restarting">
480 Применение изменений плагина без перезагрузки
481</h3>
482
483Когда вы закрываете меню `/plugin`, Claude Code запускает `/reload-plugins` для вас, чтобы применить изменения, которые вы в нем сделали, такие как установка, включение, отключение и удаление плагинов. Если перезагрузка будет [делать кэш подсказок недействительным](/docs/ru/prompt-caching#enabling-or-disabling-a-plugin), она предупреждает и оставляет изменения в ожидании вместо этого; запустите `/reload-plugins --force`, чтобы применить их в любом случае. Если Claude все еще отвечает, когда вы закрываете меню, перезагрузка запускается после завершения ответа.
484
485Для изменений плагина, которые происходят вне меню, запустите `/reload-plugins` самостоятельно. Эти изменения включают:
486
487* Команду `claude plugin`, которую вы запустили в другом терминале
488* Редактирование плагина, который вы загрузили с помощью [`--plugin-dir`](/docs/ru/plugins#test-your-plugins-locally) во время его разработки
489* Плагин [auto-update](#configure-auto-updates), чье уведомление просит вас перезагрузить
490* [Синхронизацию с вашей учетной записью claude.ai](/docs/ru/plugins-reference#synced-plugins), которая добавила, обновила или удалила плагин и показала уведомление, просящее вас перезагрузить
491* Изменение в папке [`--plugin-dir`](/docs/ru/plugins#test-your-plugins-locally), которое Claude Code удерживал, потому что применение его сделало бы кэш подсказок недействительным
492
493До v2.1.268 плагины, которые вы включили, отключили или удалили в меню, и установки, которые не активировались во время установки, оставались в ожидании до тех пор, пока вы не запустили `/reload-plugins`.
494
495`/reload-plugins` также работает в сеансах без интерактивного терминала, таких как настольное приложение, Agent SDK и [неинтерактивный режим](/docs/ru/headless) с `-p`. Требуется Claude Code v2.1.260 или более поздняя версия. В этих сеансах применяются два ограничения:
496
497* Команда работает только когда вы вводите ее непосредственно в сеанс, например в подсказку `-p` или поле подсказки настольного приложения. Когда вы отправляете ее через удаленное соединение, например [Remote Control](/docs/ru/remote-control) или переданное сообщение чата, команда отклоняется без перезагрузки чего-либо.
498* Перезагрузка не подключает и не отключает MCP servers плагинов. Эти изменения вступают в силу в вашем следующем сеансе.
499
500Claude Code перезагружает все активные плагины и показывает количество плагинов, skills, agents, hooks, plugin MCP servers и plugin LSP servers, опуская количество plugin MCP servers в сеансе без интерактивного терминала. В количестве skills Claude Code включает каждый skill, который предоставляет плагин: как его записи `commands/`, так и его skills `SKILL.md`. До v2.1.246 Claude Code считал только записи `commands/`, поэтому он мог перезагрузить skills `SKILL.md` плагина и все еще сообщить `0 skills` в сводке.
501
502Перезагрузка имеет стоимость токенов при следующем запросе: вновь загруженные компоненты объявляют о себе в содержимом, добавленном к беседе, в то время как существующая история по-прежнему читается из кэша подсказок. Плагин, который предоставляет MCP servers, стоит дороже, когда его инструменты не отложены [поиском инструментов](/docs/ru/mcp#scale-with-mcp-tool-search): изменение делает кэш недействительным, и следующий запрос повторно читает всю беседу. Подробнее см. в разделе [включение или отключение плагина](/docs/ru/prompt-caching#enabling-or-disabling-a-plugin).
503
504<h2 id="manage-marketplaces">
505 Управление маркетплейсами
506</h2>
507
508Вы можете управлять маркетплейсами через интерактивный интерфейс `/plugin` или с помощью команд CLI.
509
510<h3 id="use-the-interactive-interface">
511 Использование интерактивного интерфейса
512</h3>
513
514Запустите `/plugin` и перейдите на вкладку **Marketplaces** для:
515
516* Просмотра всех добавленных маркетплейсов с их источниками и статусом
517* Добавления новых маркетплейсов
518* Обновления списков маркетплейсов для получения последних плагинов
519* Удаления маркетплейсов, которые вам больше не нужны
520
521<h3 id="use-cli-commands">
522 Использование команд CLI
523</h3>
524
525Вы также можете управлять маркетплейсами с помощью прямых команд.
526
527Список всех настроенных маркетплейсов:
528
529```shell theme={null}
530/plugin marketplace list
531```
532
533Обновите списки плагинов из маркетплейса:
534
535```shell theme={null}
536/plugin marketplace update marketplace-name
537```
538
539Удалите маркетплейс:
540
541```shell theme={null}
542/plugin marketplace remove marketplace-name
543```
544
545<Warning>
546 Удаление маркетплейса приведет к удалению всех плагинов, которые вы установили из него.
547</Warning>
548
549<h3 id="configure-auto-updates">
550 Настройка автоматических обновлений
551</h3>
552
553Claude Code может автоматически обновлять маркетплейсы и установленные плагины в фоновом режиме после запуска. Когда автоматическое обновление включено для маркетплейса, Claude Code обновляет данные маркетплейса и обновляет установленные плагины до их последних версий на диске.
554
555Claude Code проверяет наличие обновлений маркетплейса и плагинов после запуска вашей сессии со случайной задержкой до десяти минут, поэтому запущенная сессия продолжает использовать версии, загруженные при запуске. Если какие-либо плагины были обновлены, вы увидите уведомление с предложением запустить `/reload-plugins`, или новые версии загружаются при следующем запуске.
556
557Автоматическое обновление также исключает плагин, запись маркетплейса которого объявляет `headersHelper`: Claude Code [ни запускает команду, ни загружает архив](/docs/ru/plugin-marketplaces#installs-and-updates-that-refuse-the-command-instead-of-asking) по этому пути; этот раздел указывает, когда Claude Code отображает плагин на вкладке Errors в `/plugin`, чтобы вы могли обновить его из его собственного представления.
558
559Claude Code обновляет плагины, которые имеют [источник `command`](/docs/ru/plugin-marketplaces#command-sources) по отдельному графику от параметра автоматического обновления маркетплейса и от `DISABLE_AUTOUPDATER`. Вместо этого он [повторно запускает команду один раз за сессию](/docs/ru/plugin-marketplaces#when-claude-code-re-runs-the-command) и устанавливает выходные данные как новую версию плагина, когда его [хеш](/docs/ru/plugins-reference#version-management) изменился.
560
561Переключайте автоматическое обновление для отдельных маркетплейсов через интерфейс:
562
5631. Запустите `/plugin`, чтобы открыть менеджер плагинов
5642. Выберите **Marketplaces**
5653. Выберите маркетплейс из списка
5664. Выберите **Enable auto-update** или **Disable auto-update**
567
568`claude-plugins-official`, большинство других официальных маркетплейсов Anthropic и [маркетплейсы, добавленные из claude.ai](#add-from-claude-ai) имеют автоматическое обновление, включенное по умолчанию. Маркетплейсы третьих сторон и локальной разработки имеют автоматическое обновление, отключенное по умолчанию.
569
570Администраторы также могут установить `"autoUpdate": true` для каждой записи [`extraKnownMarketplaces`](/docs/ru/settings-reference#extraknownmarketplaces) в управляемых параметрах, чтобы включить автоматическое обновление для маркетплейса организации без необходимости переключения каждым пользователем.
571
572Чтобы отключить автоматические обновления для Claude Code и плагинов, полученных из маркетплейсов, установите переменную окружения `DISABLE_AUTOUPDATER`. Плагины с [источником `command`](/docs/ru/plugin-marketplaces#command-sources) следуют своему собственному повторному разрешению один раз за сессию. Подробнее см. в разделе [Auto updates](/docs/ru/setup#auto-updates).
573
574Чтобы сохранить автоматические обновления плагинов включенными при отключении автоматических обновлений Claude Code, установите `FORCE_AUTOUPDATE_PLUGINS=1` вместе с `DISABLE_AUTOUPDATER`:
575
576```bash theme={null}
577export DISABLE_AUTOUPDATER=1
578export FORCE_AUTOUPDATE_PLUGINS=1
579```
580
581<h2 id="configure-team-marketplaces">
582 Настройка маркетплейсов команды
583</h2>
584
585Администраторы команды могут настроить автоматическую установку маркетплейса для проектов, добавив конфигурацию маркетплейса в `.claude/settings.json`. Когда члены команды [доверяют папке репозитория](/docs/ru/permissions#what-runs-before-you-trust-a-folder), Claude Code добавляет эти маркетплейсы без дополнительного запроса.
586
587Начиная с Claude Code v2.1.195, добавление маркетплейса не устанавливает плагины, поступающие из внешнего источника, на любом пути, который загружает плагины. Плагин, который включен только в `.claude/settings.json` проекта и поступает из внешнего источника, такого как репозиторий GitHub или пакет npm, не загружается до тех пор, пока член команды его не установит. До этого момента Claude Code сообщает о плагине как не установленном и показывает команду `claude plugin install` для запуска.
588
589Добавьте `extraKnownMarketplaces` в `.claude/settings.json` вашего проекта:
590
591```json theme={null}
592{
593 "extraKnownMarketplaces": {
594 "my-team-tools": {
595 "source": {
596 "source": "github",
597 "repo": "your-org/claude-plugins"
598 }
599 }
600 }
601}
602```
603
604Для полных опций конфигурации, включая `extraKnownMarketplaces` и `enabledPlugins`, см. [Plugin settings](/docs/ru/settings-reference#plugin-settings).
605
606<h2 id="security">
607 Безопасность
608</h2>
609
610Плагины и маркетплейсы — это высоконадежные компоненты, которые могут выполнять произвольный код на вашей машине с вашими привилегиями пользователя. Устанавливайте плагины и добавляйте маркетплейсы только из источников, которым вы доверяете. Организации могут ограничить, какие маркетплейсы пользователям разрешено добавлять, используя [managed marketplace restrictions](/docs/ru/plugin-marketplaces#managed-marketplace-restrictions).
611
612<h2 id="troubleshooting">
613 Troubleshooting
614</h2>
615
616<h3 id="/plugin-command-not-recognized">
617 /plugin command not recognized
618</h3>
619
620Если вы видите "unknown command" или команда `/plugin` не появляется:
621
6221. **Check your version**: запустите `claude --version`, чтобы увидеть, что установлено.
6232. **Update Claude Code**:
624 * **Homebrew**: `brew upgrade claude-code`, или `brew upgrade claude-code@latest`, если вы установили этот cask
625 * **npm**: `npm install -g @anthropic-ai/claude-code@latest`
626 * **Native installer**: повторно запустите команду установки из [Setup](/docs/ru/setup)
6273. **Restart Claude Code**: после обновления перезагрузите терминал и снова запустите `claude`.
628
629<h3 id="common-issues">
630 Common issues
631</h3>
632
633Если навыки плагинов не появляются, очистите кэш с помощью `rm -rf ~/.claude/plugins/cache`, перезагрузите Claude Code и переустановите плагин.
634
635Для подробного устранения неполадок с решениями см. [Troubleshooting](/docs/ru/plugin-marketplaces#troubleshooting) в руководстве маркетплейса. Для инструментов отладки см. [Debugging and development tools](/docs/ru/plugins-reference#debugging-and-development-tools).
636
637<h3 id="code-intelligence-issues">
638 Code intelligence issues
639</h3>
640
641* **Language server not starting**: проверьте, что двоичный файл установлен и доступен в вашем `$PATH`. Проверьте вкладку `/plugin` Errors для получения подробной информации.
642* **High memory usage**: языковые серверы, такие как `rust-analyzer` и `pyright`, могут потреблять значительную память на больших проектах. Если вы испытываете проблемы с памятью, отключите плагин с помощью `/plugin disable <plugin-name>` и вместо этого полагайтесь на встроенные инструменты поиска Claude.
643* **False positive diagnostics in monorepos**: языковые серверы могут сообщать об ошибках неразрешенного импорта для внутренних пакетов, если рабочее пространство не настроено правильно. Это не влияет на способность Claude редактировать код.
644
645<h2 id="next-steps">
646 Следующие шаги
647</h2>
648
649* **Создавайте собственные плагины**: см. [Plugins](/docs/ru/plugins) для создания skills, agents и hooks
650* **Создайте marketplace**: см. [Create a plugin marketplace](/docs/ru/plugin-marketplaces) для распространения плагинов вашей команде или сообществу
651* **Техническая справка**: см. [Plugins reference](/docs/ru/plugins-reference) для полных спецификаций