O plugin Postman para Claude Code e a Apidog CLI resolvem o mesmo problema: dão ao seu agente de programação ferramentas reais de API para que ele pare de adivinhar endpoints. Escolha o plugin Postman se sua equipe já trabalha em workspaces do Postman e quer o Context Graph ou o Secret Scanner no fluxo. Escolha a Apidog CLI se você quer uma CLI pronta para agentes que funciona com vários agentes, valida toda escrita antes de chegar ao servidor e oferece um plano gratuito para equipes de até 4 pessoas.
O que é o plugin Postman para Claude Code?
O plugin Postman para Claude Code é um conjunto de skills que fazem o Claude Code executar a CLI real do Postman em cada etapa do trabalho com APIs: descobrir, projetar, criar mocks, testar, documentar e validar. Ele é distribuído pelo marketplace oficial de plugins da Anthropic, e uma skill api-engineer direciona cada solicitação para uma skill especializada.
Conforme o guia prático do Postman, publicado em 9 de novembro de 2026, a instalação é feita com dois comandos:
claude plugin marketplace add anthropics/claude-plugins-official
claude plugin install postman@claude-plugins-official
Uma skill bootstrap instala a CLI do Postman na primeira vez que o Claude precisar dela. Você precisa do Claude Code, do Node.js 18 ou superior e de uma conta Postman; o guia diz que o plano gratuito funciona, e comandos locais como linting, mocks e execução de collections não exigem login.
A lista de skills é ampla:
| Skill | O que faz |
|---|---|
bootstrap |
Localiza a CLI, autentica, vincula o repositório a um workspace |
api-discovery |
Pesquisa workspaces, encontra APIs públicas via Orbit, consulta o Context Graph |
api-mocking |
Gera e executa mocks a partir de uma especificação ou collection |
api-testing |
Executa requisições e collections com asserções pm.test |
api-documentation |
Gera documentação amigável para agentes |
ai-readiness |
Avalia uma especificação quanto à usabilidade por agentes |
ci-integration |
Adiciona gates de lint, teste e readiness ao CI |
Um hook SessionStart lembra o Claude a cada inicialização, de forma clara e compacta, de enviar o trabalho com APIs via api-engineer, para que o agente não esqueça das ferramentas no meio da sessão.
Como o plugin Postman direciona o trabalho do seu agente
O plugin prefere a CLI local. O passo a passo sobre credencial vazada do Postman (10 de novembro de 2026) explica: o plugin envia requisições à CLI do Postman sempre que a CLI consegue completá-las, e recorre ao Postman MCP Server hospedado em mcp.postman.com apenas para tarefas que a CLI não suporta. Nas versões testadas, isso significava o Secret Scanner, os logs de auditoria e os papéis de collections.

Três exemplos dos posts do Postman:
- Resposta a incidentes sem abrir o app. O agente localizou um bearer token vazado, encontrou 32 consumidores downstream com o Context Graph, moveu o token para um vault secret, reexecutou a collection e encerrou as conclusões somente após o humano confirmar a revogação. O autor emitiu o novo token no lado do serviço.
- Simulações compartilhadas entre sessões de agentes. O post sobre simulações (12 de novembro de 2026) executou duas sessões do Claude Code em um mesmo workspace. O Agente A publicou quatro simulações, incluindo um caso de pagamento recusado (402) e um timeout de pagamento de 8 segundos. O Agente B as recuperou com
postman simulation listepostman simulation run <simulation-id> --port 4000, e o timeout revelou um bug real: o timeout de cliente de 3 segundos do checkout disparou primeiro, deixando o status da cobrança desconhecido. - Context Graph para perguntas de impacto.
postman context-graph ask "..." --waitresponde a "o que pode quebrar se mudarmos esta API?" a partir de um mapa construído com dados do Postman, GitHub e New Relic.
O Postman deixa as letras miúdas claras. Secret Scanner e logs de auditoria exigem o plano Enterprise, e escanear workspaces internos também exige o add-on Advanced Security Administration. Mocks não têm hot reload. Alguns comandos da CLI enviam resultados de execução e analytics para o Postman por padrão; o guia indica --no-report-events para desativar isso.
O que é a Apidog CLI para agentes de programação?
A Apidog CLI é uma ferramenta de linha de comando que permite a qualquer agente de programação projetar, criar mocks, testar e documentar APIs em um projeto Apidog. Ela não está presa a um único agente: você instala uma vez, adiciona a skill da Apidog ao agente que usar (Claude Code, Codex, Cursor e outros), e o agente executa os mesmos comandos apidog.
A versão 2.2.12 cobre endpoints, schemas, mocks, ambientes, casos de teste, cenários, suítes, importações, exportações, sites de documentação e branches. Duas escolhas a tornam amigável para agentes:
- Validar antes de escrever. Todo comando que recebe JSON instrui o agente a executar
apidog cli-schema get <key>para obter o formato do payload eapidog cli-schema validate <key> --file <path>antes de escrever. Payloads inválidos falham localmente, em vez de virarem um erro de servidor e uma nova tentativa. - Branches de IA.
apidog branch create --type ai --from <sourceBranchName>dá ao agente seu próprio branch. O texto de ajuda diz que as alterações em branches de IA não são gravadas automaticamente; o agente pergunta a você antes de fazer o merge.
A Apidog lançou isso depois de construir primeiro um servidor MCP. A equipe explicou o porquê em We Built 126 MCP Tools, e sua comparação interna de MCP versus CLI mais skill mediu cerca de 30% menos chamadas de ferramenta e 25% menos tokens em tarefas típicas.
Plugin Postman vs Apidog CLI: comparação lado a lado
Veja como as duas se comparam nos pontos que seu agente toca, com base nos posts do Postman e no apidog --help de 16 de novembro de 2026:
| Plugin Postman para Claude Code | Apidog CLI + skill | |
|---|---|---|
| Instalação | 2 comandos claude plugin; CLI instalada automaticamente |
npm install -g apidog-cli@latest + instalação da skill |
| Agentes | Claude Code (marketplace de plugins) | Qualquer agente que execute comandos shell |
| Caminho de execução | CLI do Postman primeiro, MCP Server hospedado como fallback | Somente CLI |
| Segurança de payloads | As skills orientam o agente | Gate cli-schema validate antes de toda escrita em JSON |
| Mocking | postman mock generate/run, simulações compartilhadas |
Expectativas do apidog mock no projeto |
| Testes | Collections com pm.test, collection run |
Casos de teste, cenários e suítes via apidog run |
| Análise de impacto | Consultas ao Context Graph | Recurso não nativo |
| Fluxos de segurança | Secret Scanner, vault (Enterprise para scanner e logs de auditoria) | Não coberto pela CLI |
| Trilho de segurança do agente | O guia aconselha o agente a nunca executar workspace push |
Branches de IA com merge aprovado por humano |
| Plano gratuito | O plano gratuito é para um único usuário | O plano gratuito cobre até 4 usuários |
O Postman vai mais fundo em mapeamento de dependências e resposta a incidentes. A Apidog vai mais longe em suporte a agentes e valida toda escrita.
Qual usa menos tokens?
Ninguém publicou um confronto direto, e cada número de destaque mede algo diferente.
O benchmark do Context Graph do Postman (4 de novembro de 2026) relata 43% menos tokens de entrada e 42% menos tempo de trabalho. O modelo era o GPT 6.1 Terra, não o Claude Code, sobre 17 perguntas de uma organização GitHub com 802 repositórios. Cada comparação foi executada uma única vez, os custos de consultas ao grafo foram excluídos, e o tempo ponta a ponta, incluindo a espera do grafo, melhorou 26%. Isso mede o Context Graph em busca de código, não o plugin no trabalho cotidiano com APIs.
Os números da Apidog comparam seu próprio servidor MCP com a CLI mais skill em tarefas como adicionar um caso de teste. Isso é uma escolha de arquitetura dentro de um produto, não a Apidog contra o Postman.
Ambos os fornecedores migraram de "carregar todas as ferramentas no contexto" para uma CLI que o agente chama sob demanda, e é esse padrão que economiza tokens. Execute ambos na sua própria API com um prompt fixo e compare a contagem de tokens da sessão.
Preços: quanto cada um custa para sua equipe
Preços, verificados em 16 de novembro de 2026:
- Postman. Segundo a página de preços do Postman, Free e Solo são planos para um único usuário. O Solo custa US$ 9 por mês cobrados anualmente, o Team custa US$ 19 por usuário por mês cobrados anualmente (US$ 23 mensais), e o Enterprise exige contato com vendas. As consultas ao Context Graph incluem 1.000 por mês no Free e 5.000 nos planos pagos, depois US$ 0,01 por consulta. O fluxo do Secret Scanner do plugin exige Enterprise.
- Apidog. O plano gratuito cobre até 4 usuários.
Para duas a quatro pessoas desenvolvedoras compartilhando um projeto de API em um plano gratuito, essa diferença decide a escolha. Para uma empresa que já usa o Postman Enterprise, o plugin dá acesso por agente a ferramentas que você já paga.
Deixe o Claude Code comandar a Apidog CLI
Não construa casos de teste manualmente enquanto um agente fica ocioso no painel ao lado. Instale a CLI uma vez e dê um único prompt.

A configuração leva três comandos:
npm install -g apidog-cli@latest
apidog auth login --with-token <YOUR_TOKEN>
npx -y skills add https://apidog.com # escolha Claude Code quando solicitado
apidog skill install também instala ou atualiza a skill. Ou peça ao seu agente para ler o guia de instalação e fazer a configuração.
Depois, dê ao Claude Code um único prompt, usando a mesma API de Orders do guia do Postman, para que você possa executar as duas ferramentas em uma mesma especificação:
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.
O agente lê a skill e, em seguida, executa comandos como estes:
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
Um payload inválido para em cli-schema validate. Adicione --upload-report e a execução aparece no app da Apidog para sua equipe. A mesma chamada apidog run com -r junit se encaixa em um pipeline; consulte Apidog CLI em CI/CD e o guia completo de configuração do Claude Code.
Qual seu agente deve usar?
Escolha o plugin Postman para Claude Code se:
- Suas APIs, collections e especificações já vivem em workspaces do Postman.
- Você quer consultas de impacto no Context Graph antes de alterar uma API compartilhada.
- Você está no Enterprise e quer o Secret Scanner e os logs de auditoria dentro do fluxo do agente.
Escolha a Apidog CLI se:
- Sua equipe usa mais de um agente de programação, ou pode trocar.
- Você quer que toda escrita do agente seja validada localmente antes de chegar ao servidor.
- Você quer que as edições do agente fiquem isoladas em branches de IA até que um humano faça o merge.
- Você é uma equipe de duas a quatro pessoas que precisa de projetos compartilhados em um plano gratuito.
Para runners de CI especificamente, consulte Apidog CLI vs Postman CLI e nossa análise das Postman Claude Skills.
FAQ
O plugin Postman para Claude Code é gratuito? O plugin é instalado do marketplace oficial da Anthropic, e o guia do Postman diz que o plano gratuito funciona para o fluxo principal. Secret Scanner e logs de auditoria exigem Enterprise, e consultas ao Context Graph acima de 1.000 por mês no plano Free custam US$ 0,01 cada.
O plugin Postman usa MCP ou a CLI? Ambos. Ele direciona o trabalho para a CLI do Postman sempre que a CLI consegue completá-lo e recorre ao Postman MCP Server hospedado para tarefas que a CLI não cobre, como Secret Scanner e logs de auditoria.
A Apidog CLI funciona com o Claude Code? Sim. Instale a CLI, adicione a skill da Apidog com npx -y skills add https://apidog.com ou apidog skill install, e o Claude Code executa comandos apidog a partir do seu prompt. A mesma configuração funciona no Codex, Cursor e outros agentes.
Posso mover collections do Postman para a Apidog com a CLI? Sim. apidog import --project <projectId> --format postman --file <path> importa uma collection do Postman exportada para um projeto Apidog.
A economia de 43% de tokens diz respeito ao plugin do Claude Code? Não. O número de 43% do Postman vem de um benchmark do Context Graph executado com o GPT 6.1 Terra sobre 17 perguntas de busca de código, cada uma executada uma única vez. Ele não mede o plugin do Claude Code em tarefas cotidianas de API.
