콘텐츠

vercel doctor를 이용한 Vercel CLI 설정 문제 진단

역량 개발 · Vercel 테크 · 2026.11.03

Vercel CLI에 새로운 기능인 vercel doctor가 추가되었습니다! 이 도구는 사용자의 설정 상태를 점검하고, 발견된 문제점을 해결할 수 있는 명령어를 직접 안내해 줍니다. CLI 버전 및 설치 상태, 로그인 정보와 현재 팀, 프로젝트 연결 여부, 그리고 vercel.json 설정값까지 꼼꼼하게 확인합니다. 또한 Vercel status page의 활성 장애 정보도 함께 보고해 줍니다. 각 점검 결과는 OK, Warning, Failed, Skipped 중 하나로 표시됩니다. 특히 --json 옵션을 사용하면 결과값을 구조화된 데이터로 받을 수 있어 코딩 에이전트에서 활용하기 매우 유용합니다. 설정 문제를 빠르게 진단하고 싶다면 vercel doctor를 실행해 보세요!