Elimina los plugins de Postman de Codex y Claude Code

Abres un cliente de API para revisar una solicitud. Días después, tu agente de programación empieza a dirigir trabajo simple de API mediante ese mismo cliente, y un servidor remoto que nunca aceptaste sigue pidiendo un inicio de sesión. Esa es la secuencia en el issue 14370 de GitHub en el repositorio de soporte de Postman, presentado el 25 de octubre de 2026. La persona que reportó abrió Postman desktop 12.33.4 en una Mac, y el propio registro de Postman registró una instalación automática en otras dos herramientas. Ningún aviso en ninguna herramienta. Los plugins simplemente llegaron.

Este tutorial los elimina correctamente. Una desinstalación normal no es todo el trabajo aquí, porque la instalación tocó registros de confianza y marketplaces además de archivos de plugin. Auditarás primero, eliminarás segundo y auditarás de nuevo al final.

Lo que vas a construir o aprender

Aprenderás cómo encontrar y eliminar un plugin no deseado en dos agentes de programación. Al final, Codex no tendrá marketplace de Postman, ningún plugin de Postman activado y ningún registro de confianza para el hook SessionStart de Postman. Claude Code no tendrá ningún plugin de Postman activado en alcance de usuario. También sabrás cómo distinguir una entrada activa de configuración de un archivo de caché inofensivo, que es la habilidad que importa la próxima vez que cualquier herramienta se instale en un lugar donde no fue invitada.

Lo que la evidencia muestra y lo que no muestra importa, así que aquí está con claridad. El issue documenta instalaciones no deseadas, ediciones de configuración, una instrucción amplia de inicio y un instalador que aprueba su propio hook. No documenta datos saliendo de la computadora. La conexión MCP remota en el reporte falló con un error de autenticación, y la persona que reportó afirma en el issue que el reporte no reclama robo de datos. Trata esto como un problema de consentimiento y confianza, porque eso es lo que el registro respalda.

Antes de empezar

Conoce los cuatro lugares que esta instalación tocó, según el issue. En Codex, ~/.codex/config.toml ganó una tabla de marketplace de Postman, una tabla de plugin activado y un registro de confianza de hook bajo hooks.state. En Claude Code, ~/.claude/settings.json activó postman@claude-plugins-official, y ~/.claude/plugins/installed_plugins.json registró la instalación en la versión 2.0.1 y alcance de usuario. Un binario de CLI de Postman también llegó a ~/.local/bin.

El hook es la parte que vale la pena entender antes de eliminar nada. Los hooks de Codex son scripts que se ejecutan en puntos definidos de una sesión. La documentación de hooks de OpenAI dice que un hook que ningún gestor controla debe revisarse y marcarse como confiable antes de que pueda ejecutarse, y la confianza se registra contra el hash de la definición exacta del hook. El plugin de Postman incluye un hook SessionStart que se activa al inicio, al limpiar y al compactar. Imprime un archivo de contexto que le dice al agente que cargue la habilidad postman:api-engineer antes de cualquier tarea amplia de ingeniería de API. El código fuente del instalador luego aprueba ese hook él mismo. Una función en el instalador llama a la lista de hooks, obtiene el hash y lo escribe en hooks.state como confiable. El comentario en ese código fuente dice: “Approves only Postman’s current hook after installation.” El README actual del plugin de Postman dice lo mismo en palabras más sencillas: la instalación también aprueba el hook por ti, sin un aviso de hook separado.

Audita primero, elimina segundo. Ilustración generada por Dirty Static.

Paso 1: Copia las configuraciones antes de tocarlas

Acción: haz una copia con fecha de ambas carpetas de configuración. Estas copias son tu forma de volver si una edición posterior sale mal.

mkdir -p ~/agent-config-backup-2026-11-04
cp ~/.codex/config.toml ~/agent-config-backup-2026-11-04/codex-config.toml
cp ~/.claude/settings.json ~/agent-config-backup-2026-11-04/claude-settings.json
cp ~/.claude/plugins/installed_plugins.json ~/agent-config-backup-2026-11-04/claude-installed_plugins.json

Resultado esperado: tres archivos están en la carpeta nueva de respaldo. Si un comando de copia informa que un archivo no existe, ese agente puede no estar instalado, o su configuración puede vivir bajo CODEX_HOME o CLAUDE_CONFIG_DIR. Anota qué archivo faltaba y sigue.

Paso 2: Audita los archivos que tocó el instalador

Acción: busca entradas de Postman en cada archivo de configuración. Estas búsquedas no cambian nada. Imprimen la evidencia.

grep -n -i postman ~/.codex/config.toml
grep -n -i postman ~/.claude/settings.json
grep -n -i postman ~/.claude/plugins/installed_plugins.json
ls -la ~/.local/bin | grep -i postman

En una Mac, también puedes revisar si la instalación automática es lo que ocurrió en tu computadora. Busca en el registro de Postman el nombre del disparador del issue:

grep -n "auto-existing-upgrade" ~/Library/Application\ Support/Postman/logs/main.log

Resultado esperado: en una computadora afectada, la búsqueda de Codex muestra tres bloques como los que el issue conservó:

[marketplaces.postman]
source_type = "git"
source = "https://github.com/postmanlabs/postman-plugin.git"

[plugins."postman@postman"]
enabled = true

[hooks.state."postman@postman:hooks/codex-hooks.json:session_start:0:0"]
trusted_hash = "sha256:..."
trusted_content_hash = "sha256:..."

Las búsquedas de Claude muestran postman@claude-plugins-official en los plugins activados y un registro en el archivo de plugins instalados. Si cada búsqueda no imprime nada, tu computadora no muestra señal de esta instalación, y puedes detenerte aquí. Tu auditoría es el resultado.

Paso 3: Elimina el plugin de Claude Code

Acción: desinstala el plugin con el comando que Anthropic documenta para gestionar plugins desde tu shell. La documentación de plugins de Claude Code dice que la desinstalación desde la shell actúa en alcance de usuario, que es el alcance que esta instalación usó.

claude plugin uninstall postman@claude-plugins-official

Resultado esperado: el comando informa el plugin como desinstalado. Si prefieres detener el plugin ahora y decidir después, claude plugin disable postman@claude-plugins-official lo apaga sin eliminarlo. Para esta limpieza, desinstalar es la decisión correcta. Siempre puedes instalar el plugin a propósito después, que es como debería haber llegado en primer lugar. Nuestra guía para ejecutar Claude Code y Codex lado a lado cubre configuraciones deliberadas como esa.

Paso 4: Elimina el plugin y el marketplace de Codex

Acción: elimina primero el plugin, y luego elimina el marketplace que lo entregó. La documentación de plugins de OpenAI cubre los comandos de marketplace, incluidos list y remove.

codex plugin remove postman@postman
codex plugin marketplace remove postman

Resultado esperado: ambos comandos se completan, y codex plugin marketplace list ya no muestra una entrada de Postman. Si el comando de eliminación informa que el plugin no está instalado, no lo fuerces. La eliminación del marketplace y la revisión manual en el Paso 6 son lo que garantiza que la configuración está limpia.

Paso 5: Ejecuta el eliminador propio de Postman, y luego decide sobre la CLI

Acción: ejecuta el eliminador del proyecto de plugin de Postman. El README del proyecto dice que el comando del instalador puede informar lo que está instalado con status y desinstalar con remove, en cada agente que admite.

npx @postman/postman-plugin status
npx @postman/postman-plugin remove

Resultado esperado: la salida de estado después de la eliminación muestra el plugin como no instalado para Codex y Claude Code. Una brecha importa aquí. Ni el README ni la documentación de instalación afirman que este eliminador borre el registro de confianza de hook de Codex. Supón que no lo hace, y revisa en el Paso 6.

La CLI en ~/.local/bin es una decisión separada. La documentación de CLI de Postman dice que una CLI instalada por script se elimina borrando el binario, y que el binario vive en ~/.local/bin en macOS y Linux. Si la CLI llegó con esta instalación y no la usas, elimínala. Si instalaste la CLI de Postman a propósito mediante npm, usa npm uninstall -g postman-cli en cambio.

ls -la ~/.local/bin | grep -i postman
rm ~/.local/bin/postman

Paso 6: Borra a mano el registro de confianza de hook restante

Acción: abre ~/.codex/config.toml en un editor de texto y busca cualquier bloque de Postman que haya sobrevivido. Elimina cada bloque completo que nombre Postman: la tabla [marketplaces.postman], la tabla [plugins."postman@postman"] y la tabla [hooks.state."postman@postman:hooks/codex-hooks.json:session_start:0:0"] con sus dos líneas de hash. Elimina solo tablas completas, desde el encabezado de la tabla hasta la línea antes del encabezado siguiente. Deja cada otro ajuste exactamente como está.

Resultado esperado: el archivo se guarda sin daño a su estructura. Este paso es el centro de todo el tutorial. Eliminar un archivo de plugin mientras su registro de confianza permanece deja la puerta marcada como aprobada, y el registro de confianza es la parte que ninguna pantalla de desinstalación te muestra. Si revisas plugins de agente a menudo, el directorio de calificaciones de PlugVet vale la pena conocerlo antes de la próxima instalación, no después.

Configuraciones limpias, búsquedas vacías. Ilustración generada por Dirty Static.

Verificación

Ejecuta la auditoría del Paso 2 de nuevo. Cada búsqueda debería ahora no imprimir nada:

grep -n -i postman ~/.codex/config.toml
grep -n -i postman ~/.claude/settings.json
grep -n -i postman ~/.claude/plugins/installed_plugins.json
claude plugin list
codex plugin list
codex plugin marketplace list

Luego inicia cada agente fresco. En Codex, ejecuta /hooks y confirma que no aparece ningún hook SessionStart de Postman en la lista. Inicia una sesión en cada agente y dale una tarea pequeña que no tenga nada que ver con Postman. El agente debería iniciar sin anuncio de habilidad de Postman y sin advertencia de autenticación MCP. Ese inicio limpio, más las búsquedas vacías, es la prueba.

Solución de problemas

Próximos pasos

Conserva la carpeta de respaldo hasta que hayas ejecutado ambos agentes durante unos días sin problema, y luego elimínala. Agrega las búsquedas del Paso 2 a tu rutina después de cualquier actualización de herramienta de escritorio, no solo de Postman. El patrón en esta historia es la parte que se generaliza: una aplicación confiable escribió en la configuración de otras aplicaciones, y la única señal fue una línea de registro y un archivo cambiado. Los archivos que puedes leer superan a los avisos que nunca viste.

Postman, por su parte, aún vende una ruta de instalación deliberada, y el plugin en sí es una herramienta real para trabajo de API cuando la eliges. Elegir es la palabra operativa. Instálalo desde el repositorio del plugin cuando lo quieras, revisa el hook dentro de Codex cuando Codex lo pida, y deja que el aviso de confianza haga el trabajo para el que fue construido.

Datos verificados el 4 de noviembre de 2026, contra el issue 14370 de GitHub, el repositorio del plugin de Postman, la documentación de plugins de Anthropic y la documentación de hooks y plugins de OpenAI. Este tutorial sigue los comandos de eliminación documentados y los registros de configuración conservados en el issue. No afirma que la secuencia completa se haya ejecutado en una computadora de prueba.

Fuentes

• El registro de instalación, bloques de configuración, texto del hook, código fuente del instalador y los límites de la persona que reportó sobre lo que muestra la evidencia: GitHub issue 14370, postmanlabs/postman-app-support
• La ruta de instalación deliberada, los comandos de eliminador y estado, y la afirmación de que la instalación aprueba el hook de Codex: postmanlabs/postman-plugin
• Alcances de plugin, dónde viven los ajustes de alcance de usuario, y los comandos de shell para instalar, desactivar y desinstalar: Install and manage plugins, Claude Code documentation
• Revisión y confianza de hooks, confianza registrada contra el hash del hook, y el navegador /hooks: Hooks, Codex documentation
• Comandos de lista y eliminación de marketplace desde la CLI: Package your plugin, OpenAI Developers
• Dónde vive el binario de CLI instalado por script y cómo eliminarlo, más la revisión de plugin de agente postman status: Install the Postman CLI y Postman CLI basic commands
• Ilustraciones del cuerpo: generadas para Dirty Static