Управление плагинами Claude Code для вашей организации

​

Pre-install and require plugins

​

Choose a delivery mechanism

• Server-managed settings: установите ключи плагина как JSON в Organization settings > Claude Code > Managed settings. Требует роль Owner в вашей организации Claude. Облачная сессия получает эти параметры перед установкой плагинов.
• MDM policies: на macOS доставьте plist, чьи ключи верхнего уровня являются ключами параметров. На Windows сохраните весь документ JSON как строку в значение реестра. Домен plist и ключ реестра находятся в Где каждый механизм хранит политику.
• Managed settings file: поместите managed-settings.json в системный путь платформы. Вы также можете добавить файлы в каталог drop-in managed-settings.d/ рядом с ним. Пути файлов для каждой платформы находятся в Где каждый механизм хранит политику, а правила слияния drop-in находятся в Разделить файловую политику между командами.

​

Which managed source applies on a machine

​

Require a marketplace and its plugins

{
  "extraKnownMarketplaces": {
    "your-marketplace": {
      "source": { "source": "github", "repo": "your-org/your-marketplace" },
      "autoUpdate": true
    }
  },
  "enabledPlugins": {
    "code-formatter@your-marketplace": true,
    "deploy-helper@your-marketplace": true
  }
}

• autoUpdate: true сохраняет marketplace и его плагины обновляющимися в фоновом режиме, а false отключает это. См. Установка политики обновления.
• source: github — один из нескольких типов источников. Источник git принимает url для GitLab или внутреннего хоста, а источник url принимает адрес размещенного marketplace.json. Каждая форма источника находится в справочнике marketplace.

• Marketplaces: управляемая запись marketplace заменяет запись с более низким приоритетом с тем же именем, и поля двух записей не объединяются.
• --plugin-dir copies: --plugin-dir загружает плагин из локального каталога для одной сессии. Для того, что происходит, когда имя этой копии совпадает с плагином, который ваш управляемый enabledPlugins называет, см. Конфликты имен.

​

Require plugins per repository

• Interactive sessions: Claude Code регистрирует marketplace только после того, как участник примет диалог доверия рабочей области для этой папки.
• Non-interactive -p runs: записи применяются только в папке, доверие которой пользователь уже принял интерактивно, или чей флаг hasTrustDialogAccepted вы установили в ~/.claude.json.

​

When each surface applies the plugin keys

​

Confirm the rollout

• На одной машине: запустите Claude Code и запустите /plugin. Marketplace и плагины перечислены.
• В CI: запустите claude -p с --output-format stream-json --verbose. Событие init перечисляет загруженные плагины под plugins.

​

Seed containers and CI

CLAUDE_CODE_PLUGIN_CACHE_DIR=/opt/claude-seed claude plugin marketplace add your-org/your-marketplace
CLAUDE_CODE_PLUGIN_CACHE_DIR=/opt/claude-seed claude plugin install code-formatter@your-marketplace

• Read-only: Claude Code никогда не пишет в seed и принудительно отключает autoUpdate для seed marketplaces.
• Seed entries take precedence: при каждом запуске marketplace, объявленный в seed, перезаписывает запись пользователя с тем же именем. Пользователи отказываются от плагина seed с claude plugin disable, а не удаляя marketplace.
• Update and remove fail: claude plugin marketplace update <name> и remove без --scope на seed marketplace не работают с сообщением, которое называет каталог seed.
• Policy still applies: allowlist и blocklist проверяют записанный источник seed marketplace тоже. Разрешите источник, из которого вы построили seed.

​

Restrict what users can install

• Before a download: списки применяются, когда пользователь добавляет marketplace и при каждой установке, обновлении, обновлении и автоматическом обновлении.
• At session start: списки применяются снова к плагинам, которые уже установлены, поэтому установленный плагин, чей источник marketplace больше не совпадает, не загружается. /plugin перечисляет его с Marketplace "<name>" is not in the allowed marketplace list или Marketplace "<name>" is blocked by enterprise policy.

• The claude.ai admin console: Claude Code применяет оба списка в сессиях, которые читают управляемые параметры сервера. claude.ai также проверяет их, когда кто-либо в вашей организации добавляет новый marketplace из репозитория git на claude.ai или из Customize в Claude Desktop app вне его вкладки Code. Это охватывает marketplace, который член добавляет для своей собственной учетной записи, и тот, который добавляется для всей организации под Organization settings > Plugins. claude.ai отказывает репозиторию, который allowlist не допускает или который blocklist называет. Он не переопределяет marketplace, который был добавлен в любом месте до того, как вы установили списки, и он не проверяет загруженные плагины.
• A managed settings file, OS-level policy, or other managed source: Claude Code применяет оба списка, где он читает этот источник. claude.ai не читает его.

​

Control matrix

• enabledPlugins: вы можете установить его в любой области, и управляемые параметры его блокируют.
• syncClaudeAiPlugins: каждый пользователь также может установить его в своих собственных пользовательских или локальных параметрах. См. его область в справочнике параметров.
• CLAUDE_CODE_DISABLE_OFFICIAL_MARKETPLACE_AUTOINSTALL: это переменная окружения, которую вы доставляете через управляемый блок env, показанный под Отключить обновления для всего флота.

​

Aliases for the marketplace keys

• Version: aliases требуют Claude Code v2.1.232 или позже, и старые клиенты их игнорируют. В файле, который читает смешанный флот, сохраняйте канонические имена.
• Both spellings set: когда файл устанавливает оба написания, применяется значение канонического ключа.

​

Allowlist with strictKnownMarketplaces

• github: { "source": "github", "repo": "your-org/approved-plugins" }, с опциональными ref и path.
• github owner wildcard: { "source": "github", "repo": "your-org/*" } совпадает с каждым репозиторием под этим владельцем. * должен стоять за всем именем репозитория. Claude Code игнорирует записи, такие как */plugins и your-org/tools-*, как недействительные, поэтому они ничему не совпадают. Требует Claude Code v2.1.223 или позже.
• git: { "source": "git", "url": "https://gitlab.example.com/tools/plugins.git" }, с опциональными ref и path.
• url: { "source": "url", "url": "https://plugins.example.com/marketplace.json" }, с опциональными headers.
• file and directory: { "source": "file", "path": "/opt/marketplace/marketplace.json" } или { "source": "directory", "path": "/opt/marketplace/plugins" }, с абсолютными путями.
• hostPattern: { "source": "hostPattern", "hostPattern": "^github\\.example\\.com$" }, совпадает с хостом источников github, git и url. Шаблон совпадает в любом месте имени хоста, поэтому закрепите его с ^ и $, как показано, чтобы совпадать со всем хостом. Источник github всегда считается github.com. Используйте запись hostPattern для GitHub Enterprise Server или хоста GitLab, где разработчики создают свои собственные marketplaces. Страница GHES имеет отработанный пример.
• pathPattern: { "source": "pathPattern", "pathPattern": "^/opt/approved/" }, совпадает с path источников file и directory. Шаблон совпадает в любом месте пути, поэтому начните его с ^, чтобы закрепить префикс каталога. ".*" разрешает каждый локальный путь.
• skills-dir: { "source": "skills-dir" } сохраняет плагины skills-directory загружающимися при установленном allowlist и не совпадает ни с каким marketplace.

​

How entries match

• Запись без ref не охватывает источник с ref: "main".
• Запись для your-org/your-marketplace не охватывает URL git, который клонирует тот же репозиторий.
• Косая черта в конце, суффикс .git или ssh:// вместо https:// — это другое значение. Когда marketplace может быть клонирован более чем одним URL-адресом, предпочитайте запись hostPattern.

​

Keep skills-directory plugins loading

​

Marketplaces hosted on claude.ai

​

Lock every source out

​

Blocklist with blockedMarketplaces

• URL-адреса Git канонизируются, поэтому формы git@ и https://, суффиксы .git и косые черты в конце одного репозитория github.com все совпадают с одной записью.
• Запись github также блокирует эквивалентный URL git, и наоборот.
• Для записи owner/*, сравнение владельца не чувствительно к регистру.
• Запись без ref или path блокирует каждый ref и path репозиториев, которые она совпадает.

{
  "blockedMarketplaces": [
    { "source": "github", "repo": "untrusted-org/*" }
  ]
}

​

Allow the official marketplace and your own

{
  "strictKnownMarketplaces": [
    { "source": "github", "repo": "anthropics/claude-plugins-official" },
    { "source": "github", "repo": "your-org/*" },
    { "source": "skills-dir" }
  ],
  "extraKnownMarketplaces": {
    "claude-plugins-official": {
      "source": { "source": "github", "repo": "anthropics/claude-plugins-official" }
    },
    "your-marketplace": {
      "source": { "source": "github", "repo": "your-org/your-marketplace" }
    }
  },
  "enabledPlugins": {
    "code-formatter@your-marketplace": true,
    "deploy-helper@your-marketplace": true
  },
  "disableSideloadFlags": true
}

• Allowlist не регистрирует ничего: запись extraKnownMarketplaces делает, и она сама должна пройти allowlist. Claude Code отказывает регистрировать управляемый marketplace, чей источник allowlist не совпадает.
• Официальный marketplace регистрирует себя только в интерактивной сессии терминала: даже там он регистрируется только, когда allowlist это разрешает. Запуск -p или терминал, подключенный к облачной сессии, никогда его не регистрирует.
• Заблокированная попытка запоминается: если машина когда-либо работала под политикой, которая блокировала официальный marketplace, Claude Code записывает заблокированную попытку и не повторяет попытку после изменения политики. Блокировка [] — это одна такая политика. Эта машина регистрирует его снова только через запись extraKnownMarketplaces, такую как в этой политике, запись enabledPlugins для одного из его плагинов или ручное /plugin marketplace add.

​

Set update policy

​

Turn auto-update on or off per marketplace

• Если управляемая запись устанавливает поле, Claude Code отклоняет переключение /plugin пользователя с ошибкой, которая начинается с Auto-update for '<name>' is set by.
• Если управляемая запись оставляет поле неустановленным, переключение пользователя сохраняется.

​

Turn updates off for the whole fleet

{
  "env": {
    "DISABLE_AUTOUPDATER": "1"
  }
}

​

Assign release channels to user groups

• Развертывайте отдельные управляемые параметры конечной точки, такие как файл управляемых параметров или профиль MDM, на устройства каждой группы. Чтобы проверить, применяется ли файл или профиль для каждой группы на устройстве, которое также имеет источник на уровне организации, см. Как Claude Code объединяет управляемые источники.
• Определите одну политику шлюза Claude apps для каждой группы. Шлюз применяет первую политику, чье правило совпадения подходит пользователю, поэтому упорядочите политики так, чтобы каждый пользователь достигал политики своей группы. Карта extraKnownMarketplaces этой политики не объединяется с картой любой другой политики, поэтому перечислите каждый marketplace, который группе нужен в ней, а не только ее marketplace канала.

{
  "extraKnownMarketplaces": {
    "stable-tools": {
      "source": { "source": "github", "repo": "your-org/stable-tools" }
    }
  }
}

​

Recommend plugins

​

Audit and review

​

OpenTelemetry events

​

Analytics API

​

Plan for what managed settings can’t enforce

• Per-user or per-group targeting: каждый ключ плагина применяется к каждому пользователю, который получает параметры. Управляемые параметры сервера доставляют одну конфигурацию для каждой организации. Для политики для каждой группы используйте отдельные управляемые параметры конечной точки или политики шлюза, как под Назначить каналы выпуска группам пользователей.
• Restricting entries inside an allowed marketplace: allowlist совпадает с источниками marketplace. Чтобы заблокировать один плагин из разрешенного marketplace, установите его на false в управляемом enabledPlugins.
• Hiding /plugin: нет ключа, который отключает команду. Ближайший эквивалент объединяет allowlist, называющий только ваш marketplace, управляемые записи enabledPlugins для плагинов, которые вы поставляете, и disableSideloadFlags.
• Gating --plugin-dir through the allowlist: allowlist не охватывает --plugin-dir. disableSideloadFlags делает.
• Enforcing the claude.ai plugin toggles through these keys: Organization settings > Plugins & skills не устанавливает ключи на этой странице. Что члены и ваша организация включают там достигает CLI как синхронизированные плагины, которые имеют свои собственные элементы управления.

​

Troubleshoot policy

• The managed file didn’t parse: когда managed-settings.json не является действительным JSON, Claude Code отказывается запускаться и печатает ошибку, называющую файл. Файл, который анализирует, но имеет одну недействительную запись, сохраняет остальную часть своей политики. См. Недействительные записи в управляемых параметрах.
• The managed source didn’t load: запустите /status и ищите Enterprise managed settings в строке Setting sources. Если его нет, источник не загрузился.
• A user reports blocked by enterprise policy: сообщение называет marketplace или его источник. Для allowlist он также перечисляет разрешенные источники. Записи, обращенные к пользователю, находятся на Troubleshoot plugins.
• A plugin the user disabled in ~/.claude/settings.json still loads: другой источник параметров повторно включил его, такой как управляемая запись enabledPlugins, которая принудительно включает его. /plugin и claude plugin list показывают Disabled in ~/.claude/settings.json but still loads с этим источником параметров.

​

Next steps

• Marketplace reference: значения source, которые extraKnownMarketplaces, strictKnownMarketplaces и blockedMarketplaces принимают
• Host and maintain a marketplace: запустите marketplace, на который указывает ваша политика
• Plugin security and trust: что плагин может делать на машине и как просмотреть один перед установкой
• Server-managed settings: доставляйте эти ключи из консоли администратора claude.ai
• Troubleshoot plugins: сообщения, которые пользователи видят, когда политика их блокирует