Vercel CLI ganha o vercel doctor, que diagnostica problemas de configuração e indica o comando de correção

O vercel doctor é um comando novo da Vercel CLI que verifica a configuração do ambiente e mostra o comando que corrige cada problema encontrado. Ele checa a versão e a instalação da CLI, o login e o time atual, o vínculo do projeto e a configuração do projeto no vercel.json. Também reporta incidentes ativos da página de status da Vercel, o que ajuda a separar problema local de problema da plataforma.

Cada verificação retorna OK, Warning, Failed ou Skipped. Se o vercel upgrade não consegue atualizar a CLI instalada, a checagem de instalação mostra de onde a CLI está sendo executada e como reinstalá-la. O doctor roda sem login e sem projeto vinculado, e nunca pede entrada, faz login nem vincula projeto. Com a flag --json, o status de cada verificação e os comandos sugeridos saem como saída estruturada, o que permite que coding agents o executem antes de tentar adivinhar uma correção.

O doctor segue uma linha que o CEVIU já vinha registrando na CLI, a de torná-la utilizável por scripts e agentes. Em 23 de outubro de 2026, o CEVIU noticiou que o "Vercel CLI ganha comando para gerenciar o Spend Management da equipe", com o vercel budgets servindo a você, a scripts e a agentes. Em 28 de outubro de 2026, em "Agents agora podem ativar Web Analytics e Observability Plus pela Vercel CLI", a CLI deixou de exigir terminal interativo para esses recursos. Agora, em 3 de novembro de 2026, o doctor entrega diagnóstico sem prompts e com saída em JSON.

Para quem usa agentes de código com a Vercel, a leitura é que o diagnóstico passa a ser um passo previsível antes de qualquer correção. Em vez de o agente chutar por que um deploy falha, ele pode rodar vercel doctor --json e agir sobre o resultado. Para quem trabalha direto no terminal, é um atalho para problemas comuns de instalação, login e vínculo de projeto.