Команда codex plugin marketplace в Codex CLI: каталоги плагинов и настройка

Команда codex plugin marketplace в Codex CLI служит для управления источниками, из которых Codex может получать сведения о доступных плагинах. С её помощью можно посмотреть подключённые каталоги, добавить новый marketplace, удалить ненужный источник и обновить его локальные данные — если перечисленные операции доступны в установленной версии Codex CLI.

Marketplace — это не сам плагин, а каталог, который сообщает Codex, какие расширения существуют и где их можно получить. Поэтому доверие к источнику важно не меньше, чем выбор самого расширения.

Команда особенно полезна в рабочих окружениях, где плагины устанавливаются не из одного встроенного списка, а из нескольких репозиториев или каталогов. При этом синтаксис и набор поддерживаемых действий могут меняться между версиями Codex CLI. Перед использованием конкретной операции стоит выполнить codex plugin marketplace --help и сверить локальную документацию с установленным клиентом.

Обзор команды codex plugin marketplace

Команда codex plugin marketplace является частью подсистемы плагинов Codex CLI. Её задача — работать со списком источников, в которых описаны доступные расширения. Такой источник может содержать названия плагинов, их описания, версии, сведения об авторе, инструкции по установке и адреса репозиториев.

Каталог плагинов похож на книжный каталог в библиотеке: он помогает найти нужную книгу, но сам по себе не заменяет проверку автора, издателя и содержания.

Важно разделять несколько сущностей:

• Marketplace — подключённый источник или каталог плагинов.
• Плагин — конкретное расширение, которое добавляет Codex новые возможности или рабочие сценарии.
• Локальное состояние marketplace — сохранённые сведения об источнике на компьютере пользователя.
• Обновление marketplace — получение более свежего описания каталога и его содержимого.

Операция	Назначение	Что обычно изменяется	Что не следует предполагать автоматически
list	Показать подключённые источники	Только отображение текущего состояния	Установка плагинов
add	Добавить источник	Конфигурация списка marketplace	Автоматическая установка всех плагинов
remove	Удалить источник	Запись о marketplace из локальной конфигурации	Удаление уже установленного плагина
update	Обновить сведения об источнике	Локальные данные каталога	Обновление самого Codex CLI

Точный способ хранения источников, допустимый формат адреса и поведение обновления зависят от реализации и версии CLI. Поэтому не стоит переносить параметры из стороннего примера без проверки: команда, работавшая в экспериментальной версии, может отсутствовать или иметь другой синтаксис в более новой.

Синтаксис команды

Базовая форма команды состоит из общей части и действия над marketplace. Обязательные аргументы зависят от выбранной подкоманды: просмотр списка обычно не требует имени источника, а добавление, удаление и обновление должны понимать, с каким marketplace работать.

Форма	Назначение	Обязательные элементы
codex plugin marketplace list	Показать источники	Нет
codex plugin marketplace add <source>	Добавить источник	<source>
codex plugin marketplace remove <name>	Удалить источник	<name>
codex plugin marketplace update <name>	Обновить источник	<name>

Общая часть codex

Первый элемент запускает исполняемый файл Codex CLI. Если команда не найдена, проблема находится не в marketplace, а в установке CLI или в переменной окружения PATH.

Элемент	Роль	Пример проверки
codex	Запуск Codex CLI	codex --help
Путь к исполняемому файлу	Альтернативный способ запуска	Зависит от операционной системы

Группа plugin

Элемент plugin указывает, что дальнейшая команда относится к системе плагинов. Он не выбирает конкретное расширение и не устанавливает его сам по себе.

Элемент	Что означает	Типичная ошибка
plugin	Переход к операциям с плагинами	Ожидание, что каталог уже будет показан
marketplace	Переход к операциям с источниками каталогов	Путаница между источником и установленным плагином

Подкоманда marketplace

Элемент marketplace выбирает именно управление источниками плагинов. После него необходимо указать действие, например list, add, remove или update, если оно поддерживается текущей сборкой.

codex plugin marketplace --help

Проверьте список действий, доступных именно в установленной версии Codex CLI.

Аргумент list

list запрашивает перечень подключённых marketplace. Это безопасная операция просмотра: она нужна для инвентаризации источников перед добавлением нового каталога или очисткой старого.

Свойство	Описание
Тип	Подкоманда без отдельного значения
Аргумент источника	Не требуется
Практическая польза	Проверка текущей конфигурации

Аргумент add

add добавляет marketplace в локальный список источников. После него требуется указать значение <source> — адрес или другой формат источника, который принимает конкретная версия Codex CLI.

Не следует автоматически считать допустимым любой URL. CLI может поддерживать только определённые типы источников, например репозиторий или иной формат, описанный в справке. Если документация вашей версии не уточняет формат, сначала используйте справку и документацию проекта, а не случайный пример из интернета.

Аргумент	Назначение	Что проверить
add	Операция добавления	Есть ли она в --help
<source>	Источник marketplace	Поддерживаемый формат и доступность

Аргумент <source>

<source> — это позиционный аргумент, который обозначает добавляемый источник. В документации и примерах угловые скобки показывают место для значения; сами скобки вводить не нужно.

codex plugin marketplace add <source>

Замените <source> на источник в формате, который поддерживает ваша версия Codex CLI.

Если адрес содержит специальные символы, пробелы или параметры оболочки, его лучше заключить в кавычки. При этом кавычки относятся к командной оболочке, а не к синтаксису Codex.

Аргумент remove

remove удаляет подключённый marketplace из локального списка. Для операции нужен аргумент <name> — имя источника, отображаемое в списке или указанное в документации.

Удаление источника обычно означает прекращение использования этого каталога для поиска и обновления сведений. Оно не должно автоматически трактоваться как удаление всех ранее установленных расширений: состояние marketplace и состояние плагинов — разные уровни системы.

Действие	Возможный результат	Что проверить после выполнения
Удалить marketplace	Источник исчезает из списка	Снова выполнить list
Удалить установленный плагин	Меняется набор расширений	Использовать отдельную команду управления плагинами, если она есть

Аргумент <name>

<name> — имя конкретного marketplace. Его нельзя надёжно заменить URL, локальным названием папки или произвольной подписью, если текущая версия CLI ожидает зарегистрированное имя.

codex plugin marketplace list
codex plugin marketplace remove <name>

Сначала получите фактическое имя из списка, затем подставьте его вместо <name>.

Аргумент update

update предназначен для обновления сведений о ранее подключённом marketplace. Поддержка этой операции должна быть проверена по справке установленной версии, поскольку набор функций плагинной системы может меняться.

Операция	Обновляет	Не обновляет автоматически
marketplace update	Данные каталога или сведения об источнике	Сам Codex CLI
Обновление плагина	Версию конкретного расширения, если это поддерживается	Все каталоги сразу без соответствующей команды

Аргумент <name> для обновления

После update указывается имя marketplace, сведения о котором нужно обновить. Такой подход позволяет не обращаться ко всем источникам сразу и лучше контролировать сетевые операции.

codex plugin marketplace update <name>

Перед выполнением убедитесь, что имя существует:

codex plugin marketplace list

Справка --help

Флаг --help — наиболее надёжный способ проверить реальный синтаксис локальной установки. Он особенно важен для экспериментальных возможностей: опубликованная статья или видеоруководство могли быть созданы для другой версии Codex CLI.

Команда	Для чего нужна
codex --help	Показать общую справку CLI
codex plugin --help	Проверить раздел плагинов
codex plugin marketplace --help	Проверить действия marketplace и их аргументы

Практические примеры

Ниже приведены сценарии, показывающие безопасную последовательность работы. В примерах намеренно не используются неподтверждённые дополнительные флаги: если конкретная версия CLI поддерживает параметры вроде подробного вывода или принудительного режима, их нужно брать только из локальной справки.

Пример 1. Проверка доступных действий

Начните с просмотра справки. Это особенно важно сразу после установки или обновления Codex CLI.

codex plugin marketplace --help

Проверьте, присутствуют ли в выводе list, add, remove и update.

Пример 2. Просмотр подключённых каталогов

Команда list помогает понять, какие источники уже используются и нет ли среди них дубликатов или неизвестных записей.

codex plugin marketplace list

Сверьте названия marketplace с теми источниками, которым вы действительно доверяете.

Что обнаружено	Рекомендуемое действие
Известный корпоративный каталог	Оставить и периодически обновлять
Незнакомый источник	Проверить происхождение и документацию
Дублирующий источник	Сравнить содержимое перед удалением

Пример 3. Добавление проверенного источника

Добавляйте marketplace только после того, как убедились, что адрес взят из официальной документации проекта или из доверенного внутреннего реестра.

codex plugin marketplace add <trusted-source>

После выполнения проверьте результат:

codex plugin marketplace list

Значение <trusted-source> здесь является обозначением места для реального источника, а не универсальным готовым URL.

Пример 4. Проверка добавления

Повторный просмотр списка нужен, чтобы убедиться, что операция действительно изменила конфигурацию и источник отображается ожидаемым образом.

codex plugin marketplace add <trusted-source>
codex plugin marketplace list

Если источник не появился, изучите сообщение об ошибке и справку текущей версии.

Пример 5. Удаление устаревшего каталога

Когда проект переехал в другой репозиторий или внутренний каталог больше не используется, старый marketplace лучше удалить. Так уменьшается количество источников, к которым CLI обращается при поиске и обновлении данных.

codex plugin marketplace remove <old-marketplace-name>

После удаления снова выполните:

codex plugin marketplace list

Пример 6. Обновление сведений об источнике

Если текущая версия поддерживает update, применяйте его к конкретному marketplace. Это позволяет получить более свежий список плагинов или обновлённые метаданные.

codex plugin marketplace update <marketplace-name>

Если CLI сообщает, что подкоманда неизвестна, не заменяйте её случайным флагом: сначала проверьте codex plugin marketplace --help и документацию своей версии.

Пример 7. Обновление перед поиском расширения

Перед выбором нового плагина полезно освежить данные доверенного каталога, если такая возможность доступна.

codex plugin marketplace update <marketplace-name>
codex plugin marketplace list

Команда list после обновления позволяет проверить, что источник по-прежнему подключён.

Пример 8. Работа после смены сети или VPN

Источники могут быть доступны только из корпоративной сети, через VPN или с определёнными настройками прокси. Если обновление не удаётся, сначала проверьте сетевой доступ, а не меняйте конфигурацию наугад.

codex plugin marketplace update <marketplace-name>

Если операция завершилась ошибкой, проверьте:

доступность источника в браузере или через разрешённые корпоративные средства;
подключение к VPN;
правила прокси и сертификаты;
актуальность адреса marketplace.

Пример 9. Поиск неизвестного источника

Если после установки CLI в списке появился непонятный marketplace, не устанавливайте из него расширения до проверки происхождения.

codex plugin marketplace list

Для подозрительного имени выясните:

кто добавил источник;
какому проекту он принадлежит;
есть ли официальная документация;
как публикуются и проверяются плагины.

Пример 10. Безопасная последовательность перед установкой плагина

Установка расширения должна начинаться не с запуска неизвестного кода, а с проверки цепочки доверия: источник, автор, репозиторий, документация и требуемые разрешения.

codex plugin marketplace list
codex plugin marketplace update <marketplace-name>
codex plugin marketplace --help

Только после проверки источника переходите к команде установки, если она документирована вашей версией Codex CLI.

Как marketplace связан с установкой плагинов

Marketplace обычно выполняет роль слоя обнаружения. Он помогает Codex узнать, какие расширения доступны, но подключение каталога не означает, что все его плагины автоматически установлены и запущены.

Наличие плагина в каталоге — это предложение к установке, а не гарантия его безопасности и не доказательство его качества.

В зависимости от версии Codex CLI процесс может выглядеть так: пользователь подключает источник, обновляет его сведения, выбирает нужное расширение, изучает документацию и только затем выполняет отдельную операцию установки. Названия команд установки здесь нельзя универсально подставлять без проверки, поскольку они относятся уже к другой части плагинной системы.

Этап	Вопрос пользователя	Результат
Подключение marketplace	Откуда брать сведения?	Источник добавлен в локальную конфигурацию
Обновление каталога	Какие данные актуальны?	Получены свежие метаданные, если поддерживается обновление
Выбор плагина	Что именно нужно установить?	Определено расширение и его назначение
Проверка доверия	Можно ли запускать этот код?	Оценены автор, репозиторий и разрешения
Установка	Как подключить расширение?	Использована документированная команда текущей версии

Почему важно доверять источнику

Плагин — это не обычный текстовый файл. В зависимости от архитектуры он может выполнять код, обращаться к файлам проекта, использовать сетевые соединения, читать переменные окружения или взаимодействовать с внешними инструментами. Поэтому marketplace становится частью цепочки поставки программного обеспечения.

Даже если каталог выглядит аккуратно, проверьте репутацию владельца, историю изменений, правила публикации и понятность документации. Особое внимание нужно уделить расширениям, которые обещают «автоматизировать всё» и требуют широких разрешений без внятного объяснения причин.

Признак	Что может говорить в пользу источника	Что должно насторожить
Происхождение	Официальный репозиторий или известная организация	Анонимный URL без истории
Документация	Есть назначение, ограничения и инструкция	Только рекламное описание
Изменения	Понятная история коммитов и выпусков	Внезапная замена содержимого
Разрешения	Минимально необходимые права	Широкий доступ без объяснения
Поддержка	Контакты авторов и сообщения об исправлениях	Источник заброшен или не имеет владельца

Проверка репозитория

Если marketplace ссылается на репозиторий, изучите его не только по названию. Посмотрите дату последних изменений, список сопровождающих, открытые проблемы и соответствие адреса официальным ссылкам проекта.

codex plugin marketplace list

Проверяйте сведения об источнике по официальной документации проекта, а не только по имени, отображаемому CLI.

Проверка разрешений

Перед установкой прочитайте, какие действия выполняет плагин. Доступ к рабочему каталогу может быть оправдан инструментом анализа кода, но сетевой доступ, чтение секретов и запуск сторонних команд должны иметь отдельное объяснение.

Разрешение	Когда может быть оправдано	Риск
Чтение файлов проекта	Анализ исходного кода или документации	Утечка конфиденциальных файлов
Запись в рабочий каталог	Генерация файлов или исправлений	Повреждение или подмена данных
Сетевой доступ	Работа с API и удалёнными сервисами	Передача кода или токенов
Запуск команд	Сборка, тестирование, форматирование	Выполнение вредоносных инструкций

Проверка обновлений

Обновление marketplace удобно, но оно означает получение новых данных из внешнего источника. В критичных окружениях обновляйте каталоги осознанно, фиксируйте изменения и не устанавливайте каждое новое расширение автоматически.

codex plugin marketplace update <marketplace-name>

После обновления сравните доступные плагины с внутренними правилами безопасности и списком разрешённых инструментов.

Типичные ошибки и способы их исправления

Большинство проблем связано не с самими плагинами, а с неверным уровнем команды, неправильным именем источника или различиями между версиями CLI. Диагностику лучше начинать с простых проверок и двигаться к более специфичным.

Хорошая диагностика начинается с вопроса «какую команду поддерживает моя версия?», а не с копирования пятого найденного в поиске примера.

Симптом	Вероятная причина	Первый шаг
Команда не найдена	Codex CLI отсутствует в PATH	Проверить установку и codex --help
Неизвестная подкоманда	Функция отсутствует в текущей версии	Выполнить codex plugin marketplace --help
Источник не найден	Неверное имя или marketplace не добавлен	Посмотреть list
Не удаётся обновить	Проблема сети, доступа или адреса	Проверить источник и подключение
Удаление не срабатывает	Используется не то имя	Скопировать имя из списка

Ошибка из-за неверного имени

Пользователь может попытаться удалить или обновить источник по его URL, хотя CLI ожидает зарегистрированное имя. В таком случае сначала получите список и используйте точное отображаемое значение.

codex plugin marketplace list
codex plugin marketplace update <точное-имя-из-списка>

Ошибка из-за неподдерживаемой операции

Если update отсутствует в локальной справке, не следует считать, что существует скрытый эквивалент с другим названием. Сверьтесь с актуальной документацией Codex CLI и используйте только подтверждённые команды.

codex plugin marketplace --help
codex plugin --help

Ошибка из-за недоступного источника

Источник может быть закрытым, временно недоступным или требовать аутентификацию. Сообщение об ошибке нужно сопоставить с настройками сети и правилами доступа, не отключая защитные механизмы системы без необходимости.

codex plugin marketplace update <marketplace-name>

Проверьте доступ к источнику и повторите операцию только после устранения причины.

Практический порядок работы

Для большинства пользователей достаточно аккуратной последовательности из нескольких шагов. Она снижает риск подключить неизвестный источник и помогает быстро понять, где возникла проблема.

1. Проверьте версию и справку Codex CLI.
2. Посмотрите текущий список marketplace.
3. Добавляйте только источник с понятным происхождением.
4. Обновите его сведения, если команда доступна.
5. Изучите описание и разрешения выбранного плагина.
6. Устанавливайте расширение отдельной документированной командой.
7. Периодически удаляйте устаревшие и неизвестные источники.

Ситуация	Минимальный набор действий
Первое знакомство с CLI	codex plugin marketplace --help, затем list
Добавление нового каталога	Проверить источник, выполнить add, повторить list
Каталог устарел	Проверить поддержку update и обновить по имени
Источник больше не нужен	Удалить по точному имени и подтвердить через list
Подозрительный источник	Не устанавливать плагины, проверить происхождение или удалить

Итоги

codex plugin marketplace предназначена для управления источниками плагинов Codex CLI. Основные операции — просмотр подключённых каталогов с помощью list, добавление источника через add, удаление через remove и обновление сведений посредством update, если эти действия присутствуют в актуальной версии вашей установки.

Главное практическое правило — не путать каталог с самим расширением. Marketplace помогает обнаружить плагин, но не делает его автоматически безопасным. Перед установкой проверяйте адрес источника, владельца репозитория, историю изменений, документацию и необходимые разрешения.

Если синтаксис вызывает сомнения, используйте codex plugin marketplace --help. Это самый надёжный способ не выдумывать параметры, не применять устаревшие примеры и работать именно с тем набором возможностей, который поддерживает ваш Codex CLI.