Plugin de Postman para Claude Code vs Apidog CLI: ¿Cuál debería usar tu agente?

Plugin de Postman para Claude Code frente a Apidog CLI: configuración, qué puede hacer tu agente, qué miden las claims del token y precios, comparados a partir de las fuentes de cada proveedor.

Ashley Innocent

Ashley Innocent

16 November 2026

Plugin de Postman para Claude Code vs Apidog CLI: ¿Cuál debería usar tu agente?

Apidog para empresas

Despliegue local

SSO & RBAC

Conforme con SOC 2

Explorar Apidog Enterprise

El plugin de Postman para Claude Code y la CLI de Apidog resuelven el mismo problema: proporcionan a tu agente de programación herramientas reales de API para que deje de adivinar endpoints. Elige el plugin de Postman si tu equipo ya trabaja en workspaces de Postman y quiere Context Graph o Secret Scanner en el flujo. Elige la CLI de Apidog si quieres una única CLI lista para agentes que funcione con varios agentes, valide cada escritura antes de llegar al servidor y ofrezca un plan gratuito para equipos de hasta 4 personas.

¿Qué es el plugin de Postman para Claude Code?

El plugin de Postman para Claude Code es un conjunto de skills que hacen que Claude Code ejecute la CLI real de Postman en cada etapa del trabajo con APIs: discover, design, mock, test, document y gate. Se distribuye a través del marketplace oficial de plugins de Anthropic, y una skill api-engineer enruta cada solicitud a una skill especializada.

La guía práctica de Postman, publicada el 9 de noviembre de 2026, lo instala con dos comandos:

claude plugin marketplace add anthropics/claude-plugins-official
claude plugin install postman@claude-plugins-official

Una skill bootstrap instala la CLI de Postman la primera vez que Claude la necesita. Necesitas Claude Code, Node.js 18 o posterior y una cuenta de Postman; la guía indica que el plan gratuito funciona, y los comandos locales como linting, mocking y ejecuciones de colecciones no requieren iniciar sesión.

La lista de skills es amplia:

Skill Qué hace
bootstrap Encuentra la CLI, se autentica y vincula el repositorio a un workspace
api-discovery Busca en workspaces, encuentra APIs públicas mediante Orbit y consulta Context Graph
api-mocking Genera y ejecuta mocks a partir de una especificación o una colección
api-testing Ejecuta requests y colecciones con aserciones pm.test
api-documentation Genera documentación apta para agentes
ai-readiness Puntúa la usabilidad de una especificación para agentes
ci-integration Añade gates de lint, test y readiness a la CI

Un hook SessionStart se lo recuerda a Claude en cada arranque, claro y conciso: enviar el trabajo con APIs a través de api-engineer, para que el agente no olvide las herramientas a mitad de sesión.

Cómo el plugin de Postman enruta el trabajo de tu agente

El plugin prioriza la CLI local. El recorrido de Postman sobre una credencial filtrada (10 de noviembre de 2026) lo explica claramente: el plugin envía las requests a la CLI de Postman siempre que esta puede completarlas, y recurre al Postman MCP Server alojado en mcp.postman.com solo para tareas que la CLI no soporta. En las versiones probadas, eso significaba Secret Scanner, registros de auditoría y roles de colecciones.

Diagrama de cómo el plugin de Postman para Claude Code enruta el trabajo: Claude Code llama a la skill api-engineer del plugin, que envía las tareas primero a la CLI local de Postman y recurre al Postman MCP Server; ambos actúan sobre el workspace de Postman

Tres ejemplos de las publicaciones de Postman:

  1. Respuesta a incidentes sin abrir la aplicación. El agente localizó un bearer token filtrado, encontró 32 consumidores downstream con Context Graph, movió el token a un secreto de vault, volvió a ejecutar la colección y cerró los hallazgos solo después de que el humano confirmara la revocación. El autor emitió el nuevo token desde el lado del servicio.
  2. Simulaciones compartidas entre sesiones de agente. La publicación sobre simulaciones (12 de noviembre de 2026) ejecutó dos sesiones de Claude Code sobre un mismo workspace. El agente A publicó cuatro simulaciones, incluido un caso de pago rechazado con 402 y un timeout de pago de 8 segundos. El agente B las obtuvo con postman simulation list y postman simulation run <simulation-id> --port 4000, y el timeout reveló un bug real: el timeout de cliente de 3 segundos del checkout se activó primero, dejando el estado del cargo desconocido.
  3. Context Graph para preguntas de impacto. postman context-graph ask "..." --wait responde a la pregunta “¿qué podría romperse si cambiamos esta API?” a partir de un mapa construido con datos de Postman, GitHub y New Relic.

Postman expone la letra pequeña sin rodeos. Secret Scanner y los registros de auditoría requieren el plan Enterprise, y escanear workspaces internos también requiere el complemento Advanced Security Administration. Los mocks no se recargan en caliente. Algunos comandos de la CLI envían por defecto resultados de ejecución y analíticas a Postman; la guía señala --no-report-events para desactivarlo.

¿Qué es la CLI de Apidog para agentes de programación?

La CLI de Apidog es una herramienta de línea de comandos que permite a cualquier agente de programación diseñar, simular, probar y documentar APIs en un proyecto de Apidog. No está ligada a un solo agente: la instalas una vez, añades la skill de Apidog al agente que uses (Claude Code, Codex, Cursor y otros), y el agente maneja los mismos comandos de apidog.

La versión 2.2.12 cubre endpoints, esquemas, mocks, entornos, casos de prueba, escenarios, suites, importaciones, exportaciones, sitios de documentación y ramas. Dos decisiones la hacen muy apta para agentes:

Apidog lanzó esto después de construir primero un servidor MCP. El equipo explicó por qué en We Built 126 MCP Tools, y su comparación interna de MCP frente a CLI más skill midió alrededor de un 30% menos de llamadas a herramientas y 25% menos de tokens en tareas típicas.

Plugin de Postman vs CLI de Apidog: comparación directa

Así se comparan ambos en lo que tu agente toca, según las publicaciones de Postman y apidog --help a fecha del 16 de noviembre de 2026:

Plugin de Postman para Claude Code CLI de Apidog + skill
Instalación 2 comandos claude plugin; la CLI se instala automáticamente npm install -g apidog-cli@latest + instalación de la skill
Agentes Claude Code (marketplace de plugins) Cualquier agente que ejecute comandos de shell
Ruta de ejecución Primero la CLI de Postman, con el MCP Server alojado como respaldo Solo CLI
Seguridad de payloads Las skills guían al agente Gate de cli-schema validate antes de cada escritura JSON
Mocking postman mock generate/run, simulaciones compartidas Expectativas de apidog mock en el proyecto
Pruebas Colecciones con pm.test, collection run Casos de prueba, escenarios y suites mediante apidog run
Análisis de impacto Consultas a Context Graph No es una función integrada
Flujos de seguridad Secret Scanner, vault (Enterprise para el escáner y los registros de auditoría) No cubierto por la CLI
Barandilla de seguridad para el agente La guía aconseja al agente no ejecutar nunca workspace push Ramas de IA con fusión aprobada por humanos
Plan gratuito El plan gratuito es para un solo usuario El plan gratuito cubre hasta 4 usuarios

Postman va más profundo en mapeo de dependencias y respuesta a incidentes. Apidog va más lejos en soporte de agentes y protege cada escritura con validación.

¿Cuál consume menos tokens?

Nadie ha publicado una comparación directa, y cada cifra destacada mide algo distinto.

El benchmark de Context Graph de Postman (4 de noviembre de 2026) informa un 43% menos de tokens de entrada y un 42% menos de tiempo de trabajo. El modelo era GPT 6.1 Terra, no Claude Code, sobre 17 preguntas acerca de una organización de GitHub de 802 repositorios. Cada comparación se ejecutó una sola vez, se excluyeron los cargos por consultas al grafo y el tiempo de extremo a extremo, incluida la espera del grafo, mejoró un 26%. Mide Context Graph en búsqueda de código, no el plugin en el trabajo diario con APIs.

Las cifras de Apidog comparan su propio servidor MCP con la CLI más la skill en tareas como añadir un caso de prueba. Eso es una decisión de arquitectura dentro de un mismo producto, no Apidog contra Postman.

Ambos proveedores pasaron de “cargar todas las herramientas en el contexto” a una CLI que el agente invoca bajo demanda, y ese patrón es lo que ahorra tokens. Ejecuta ambos sobre tu propia API con un prompt fijo y compara los recuentos de tokens de sesión.

Precios: cuánto cuesta cada opción a tu equipo

Precios, verificados el 16 de noviembre de 2026:

Para dos a cuatro desarrolladores que comparten un proyecto de API en un plan gratuito, esa diferencia lo decide todo. Para una empresa con Postman Enterprise, el plugin añade acceso por agente a herramientas que ya pagas.

Deja que Claude Code maneje la CLI de Apidog

No construyas casos de prueba a mano mientras un agente espera inactivo en el panel de al lado. Instala la CLI una vez y dale un solo prompt.

Diagrama del bucle de agente de la CLI de Apidog: un prompt de agente carga la skill de Apidog, el agente valida su payload con apidog cli-schema validate, crea el caso con apidog test-case create, lo ejecuta con apidog run, y los agentHints de la salida sugieren el siguiente paso

La configuración requiere tres comandos:

npm install -g apidog-cli@latest
apidog auth login --with-token <YOUR_TOKEN>
npx -y skills add https://apidog.com   # pick Claude Code when prompted

apidog skill install también instala o actualiza la skill. O dile a tu agente que lea la guía de instalación y lo configure.

Luego dale a Claude Code un solo prompt, usando la misma API de Orders que la guía de Postman para que puedas probar ambas herramientas sobre la misma especificación:

Import ./openapi.yaml into Apidog project <projectId>. Then create a test case
for POST /orders that asserts a 201 status and an "id" field in the response,
run it against environment <envId>, and summarize any failures.

El agente lee la skill y luego ejecuta comandos como estos:

apidog import --project <projectId> --format openapi --file ./openapi.yaml
apidog cli-schema get test-case-create
apidog cli-schema validate test-case-create --file case.json
apidog test-case create --project <projectId> --file case.json
apidog run --test-case <caseId> --project <projectId> -e <envId> -r cli,json

Un payload incorrecto se detiene en cli-schema validate. Añade --upload-report y la ejecución aparecerá en la aplicación de Apidog para tu equipo. La misma llamada de apidog run con -r junit se integra en un pipeline; consulta Apidog CLI in CI/CD y la guía completa de configuración con Claude Code.

¿Cuál debería usar tu agente?

Elige el plugin de Postman para Claude Code si:

Elige la CLI de Apidog si:

Para runners de CI en concreto, consulta Apidog CLI vs Postman CLI y nuestro análisis de Postman Claude Skills.

FAQ

¿El plugin de Postman para Claude Code es gratuito? El plugin se instala desde el marketplace oficial de Anthropic, y la guía de Postman indica que el plan gratuito funciona para el flujo básico. Secret Scanner y los registros de auditoría requieren Enterprise, y las consultas a Context Graph que superen las 1.000 al mes en Free cuestan 0,01 $ cada una.

¿El plugin de Postman usa MCP o la CLI? Ambos. Enruta el trabajo a la CLI de Postman siempre que esta pueda completarlo y recurre al Postman MCP Server alojado para las tareas que la CLI no cubre, como Secret Scanner y los registros de auditoría.

¿Funciona la CLI de Apidog con Claude Code? Sí. Instala la CLI, añade la skill de Apidog con npx -y skills add https://apidog.com o apidog skill install, y Claude Code ejecutará los comandos de apidog a partir de tu prompt. La misma configuración funciona en Codex, Cursor y otros agentes.

¿Puedo mover colecciones de Postman a Apidog con la CLI? Sí. apidog import --project <projectId> --format postman --file <path> importa una colección de Postman exportada a un proyecto de Apidog.

¿El ahorro del 43% en tokens se refiere al plugin de Claude Code? No. La cifra del 43% de Postman proviene de un benchmark de Context Graph ejecutado con GPT 6.1 Terra sobre 17 preguntas de búsqueda de código, cada una ejecutada una sola vez. No mide el plugin de Claude Code en tareas cotidianas con APIs.

Practica el diseño de API en Apidog

Descubre una forma más fácil de construir y usar APIs