Плагин Postman в Codex и Claude Code: проверка и удаление

Чтобы удалить нежелательный плагин Postman из Codex или Claude Code, сначала сохраните копию конфигурации. Затем удалите плагин и отзовите сохранённое доверие к его хуку в Codex — обработчику события. Не авторизуйте подключение к MCP-серверу Postman, которое вы не выбирали.

Перед возвратом к обычной работе проверьте результат в новом сеансе.

В сообщении об ошибке Postman #14370 описан узнаваемый симптом:

MCP server startup failed server_name="postman"
... error: Auth required, when send initialize request

Автор сообщения также описал повторную загрузку навыков Postman при работе с API. Навык (skill) здесь означает набор инструкций для агента. Эти признаки — повод проверить интеграцию, но не доказательство отправки данных API.

Что изменилось после первых сообщений?

По состоянию на 2026-11-10 Postman объявил об откате изменений и изменил плагин для Codex. Поведение старого установщика нельзя считать точным описанием всех текущих установок.

Исходное сообщение касалось Postman 12.33.4 для macOS, плагина Codex 1.1.0 и плагина Claude Code 2.0.1. В более позднем сообщении о версии 12.35.1 описана ещё одна автоматическая установка. Однако на том компьютере не было записи о доверии к хуку Codex, а плагин Cursor был установлен раньше.

5 ноября участник репозитория preethammavin сообщил, что Postman откатывает изменение. У авторов более ранних комментариев такой отметки об участии на GitHub не было.

Также 5 ноября приняли изменения #149, которые убрали подтверждение доверия из установщика. Они удалили hooks/codex-hooks.json и задали в манифесте Codex "hooks": {}. Текущий манифест Codex сохраняет это пустое объявление хуков. Навыки Postman и MCP-сервер в нём остались.

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

Проверьте изменения до удаления

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

Проверяйте каталог конфигурации именно того сеанса, в котором возникла проблема. Окружение запуска в терминале и настольном приложении может отличаться. Следующая проверка для Bash учитывает CODEX_HOME и документированную переменную Claude Code CLAUDE_CONFIG_DIR.

Она выводит имена файлов с совпадениями, а не их содержимое:

codex_root="${CODEX_HOME:-$HOME/.codex}"
claude_root="${CLAUDE_CONFIG_DIR:-$HOME/.claude}"

for file in \
  "$codex_root/config.toml" \
  "$claude_root/settings.json" \
  "$claude_root/plugins/installed_plugins.json"
do
  if [ -f "$file" ]; then
    grep -ilF -- postman "$file"
  fi
done

Совпадение — повод изучить файл, а не доказательство автоматической установки. Отсутствие совпадений относится только к этим файлам, а не ко всей конфигурации.

Для случая на macOS проверьте ~/Library/Application Support/Postman/logs/main.log. В исходном сообщении приведён такой результат установки:

{"source":"auto-existing-upgrade","results":["claude-code:installed","codex:installed"],"installer":"script"}

Сопоставьте время этой записи с записями об установке плагинов. Совпадение по времени убедительнее, чем само слово «Postman» в файле настроек.

В Codex проверьте три отдельные записи из исходного сообщения:

Запись конфигурации	Что проверить
[marketplaces.postman]	Указан ли источник https://github.com/postmanlabs/postman-plugin.git.
[plugins."postman@postman"]	Включён ли плагин.
[hooks.state."postman@postman:hooks/codex-hooks.json:session_start:0:0"]	Содержит ли запись о доверии trusted_hash, trusted_content_hash или оба поля.

Отсутствие записи о доверии не исключает установленный плагин. Именно такое состояние описано в более позднем сообщении.

В Claude Code проверьте enabledPlugins в ~/.claude/settings.json. В сообщении указан идентификатор postman@claude-plugins-official. В ~/.claude/plugins/installed_plugins.json найдите соответствующую запись и проверьте область установки, версию, installedAt и lastUpdated.

Для Cursor адаптер установщика указывает два каталога:

~/.cursor/plugins/local/postman
~/.cursor/plugins/cache/cursor-public/postman

Начните проверку с них. Подтвердите, включён ли плагин, в настройках Cursor: наличие каталога само по себе этого не доказывает.

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

Удалите плагин и запись о доверии отдельно

Выберите один способ: штатные команды инструмента или средство удаления Postman. Не выполняйте все варианты подряд.

Удаление штатными командами

Для указанного в сообщении плагина Codex выполните в Bash:

codex plugin remove postman@postman

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

codex plugin marketplace remove postman

Эти операции соответствуют текущему адаптеру Postman для Codex. Если старая установка зарегистрирована иначе, используйте идентификаторы, которые действительно есть на вашем компьютере.

Для указанного в сообщении плагина Claude Code, установленного на уровне пользователя:

claude plugin uninstall postman@claude-plugins-official --scope user

Справочник команд плагинов Claude Code различает области установки user, project и local. Если подтверждена установка в области project или local, выберите соответствующую область и выполните команду из этого проекта. Удаление общих настроек проекта согласуйте с командой.

Не удаляйте весь маркетплейс claude-plugins-official ради одного плагина. Не очищайте installed_plugins.json целиком и не заменяйте весь файл настроек.

Если установленная версия CLI не принимает команду, сначала изучите её plugin --help. Не заменяйте неподдерживаемую команду удаления массовым удалением каталогов.

Альтернатива: средство удаления Postman

В текущей инструкции репозитория Postman приведена такая команда удаления:

npx @postman/postman-plugin@latest remove

Сначала изучите код пакета и решите, готовы ли вы его запустить. Проверьте, какие агенты затронет удаление. Текущий исходный код установщика требует Node.js 22 или новее. Сохраните подкоманду remove: запуск установщика без неё не удаляет интеграцию.

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

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

Удаление оставшейся записи о доверии в Codex

Если в пользовательской конфигурации Codex остался указанный ниже подраздел, удалите его целиком:

[hooks.state."postman@postman:hooks/codex-hooks.json:session_start:0:0"]

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

Удалите оба поля этого подраздела: trusted_hash и trusted_content_hash. Остановитесь перед следующим заголовком таблицы TOML. Остальные записи в hooks.state не меняйте.

При ручной правке удаляйте только записи, которые точно относятся к Postman. Сохраните model_provider, model_providers, base_url, настройки авторизации и хуки, не связанные с Postman. В Claude Code сохраните не связанные с Postman параметры env и настройки разрешений.

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

Проверка Cursor, отдельных MCP-подключений и Postman CLI

Для плагина из маркетплейса Cursor нужен отдельный шаг: удалите Postman через Cursor Settings > Plugins и перезапустите Cursor. После любого способа удаления проверьте список плагинов Cursor: не осталось ли установок Postman.

Если предупреждение MCP осталось, проверьте настройки сервера. Не входите в аккаунт только ради того, чтобы скрыть предупреждение. В Bash выполните команду для каждого затронутого инструмента:

codex mcp list
claude mcp list

Если сервер настроен отдельно от плагина, его запись тоже нужно удалить отдельно. Убедитесь, что ненужная отдельная запись называется postman. Затем используйте codex mcp remove postman или claude mcp remove postman. Перед удалением проверьте область действия записи. Эти команды описаны в справочнике Codex CLI и документации MCP для Claude Code.

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

Отдельно проверьте Postman CLI. В Bash команда type -a postman показывает найденные команды с таким именем. В исходном случае исполняемый файл находился в ~/.local/bin, но другие установки могут использовать иной путь.

Выберите способ удаления Postman CLI, соответствующий способу его установки. Для установки не через npm документация предписывает удалить исполняемый файл. Перед удалением сопутствующих файлов проверьте их назначение. Не удаляйте общий каталог lib только потому, что он упомянут в сообщении.

Проверьте результат в новом сеансе

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

Сначала получите списки плагинов затронутых инструментов:

codex plugin list --json
claude plugin list --json

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

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

Упоминания Postman в старом диалоге не подходят как единственная проверка. Содержимое диалога и установленные настройки — разные вещи. Поэтому важно различать новый сеанс Claude Code и сжатие текущего контекста.

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

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

Почему установщик мог записать доверие к хуку Codex?

Старый установщик сам вызывал интерфейс настройки Codex для записи доверия к хуку. Он не ограничивался регистрацией плагина с последующей интерактивной проверкой пользователем.

В коммите 6c8e452e0f4237f4bcc0901cb1ac442dec707e49 хук использовал событие SessionStart и фильтр matcher со значением startup|clear|compact. Текст инструкций предписывал выполнять нетривиальные задачи по разработке и сопровождению API через навык postman:api-engineer.

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

Функция approvePostmanHook в той версии установщика запускала codex app-server. Через hooks/list она получала текущий хеш хука, проверяла его и вызывала config/batchWrite. Вызов записывал trusted_hash в hooks.state.

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

Документированный механизм доверия Codex сравнивает хук с сохранённым хешем. Новые или изменённые хуки он пропускает до проверки и подтверждения доверия. Поэтому граница защиты зависит от доступа к записи о доверии. Совпадение хеша само по себе не доказывает, что хук одобрил человек.

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

Как предотвратить повторные изменения на компьютерах команды

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

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

Системный файл требований Codex для macOS и Linux — /etc/codex/requirements.toml. Добавьте этот параметр на верхнем уровне существующего файла:

allow_managed_hooks_only = true

Документация по управляемой конфигурации описывает пути для развёртывания политик. В справочнике настроек указан эффект этого параметра: Codex пропускает пользовательские, проектные и сеансовые хуки, а также хуки плагинов. Управляемые хуки остаются разрешены.

Для Claude Code на macOS добавьте следующий параметр в существующий /Library/Application Support/ClaudeCode/managed-settings.json:

{
  "allowManagedHooksOnly": true
}

Это параметр управляемой политики, а не замена правке пользовательских настроек. Такая политика хуков Claude Code блокирует пользовательские и проектные хуки, а также хуки плагинов с исключениями. В справочнике настроек перечислены исключения: управляемые хуки, хуки SDK и хуки плагинов, принудительно включённых через enabledPlugins в управляемых настройках.

Перед массовым развёртыванием проверьте политики на тех версиях клиентов, которые использует команда. Ограничение хуков само по себе не удаляет плагины и MCP-подключения; контролируйте их отдельно.

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