Install
npm install -g @playwright/cli@latest누구에게 맞나
이 가이드는 Playwright CLI가 필요하고 코딩 Agent에 짝이 되는 SKILLS를 넣고 싶은 개발자를 위한 것이다. 공식 문장은 Playwright CLI with SKILLS로 적혀 있다.
시작 전에 이 기기가 Node.js 18 or newer인지 확인하라. 페이지는 또한 Claude Code, GitHub Copilot, 또는 그 외 coding agent가 필요하다고 적는다. 이는 실행면 설명이지 배타 목록이 아니며, 전역 npm 설치를 나타나지 않은 마켓 플러그인으로 일반화하지 마라.
CLI는 기본이 headless다. 브라우저를 분명히 열고 싶을 때만 open에 --headed를 붙여라. 첫 시도에서는 확인하지 않은 URL을 열거나 녹화하지 마라.
3분 안에 첫 시도 완료하기
페이지가 제시한 권장 설치 명령만 사용한다.
npm install -g @playwright/cli@latest
전제 조건: Node.js 18 이상이고, 현재 환경에 쓸 수 있는 coding agent가 있다. 설치 위치는 전역 npm 패키지 @playwright/cli다. 나타나지 않은 다른 설치기로 바꾸어 쓰지 마라.
부작용 확인 지점: 이 명령은 CLI를 전역 환경에 쓴다. 이 기기의 전역 패키지를 바꿀 생각이 없다면 먼저 멈춰라. 확인한 뒤에 실행한다. 설치가 성공한 뒤 로컬 스킬 파일이 더 필요하면 페이지의 playwright-cli install --skills를 실행하라. 이는 설치 이후 스킬 배치이지 두 번째 주 설치기가 아니다. 스킬 파일을 쓰므로 실행 전에도 현재 프로젝트/Agent 디렉터리를 확인하라.
성공 신호: 전역 명령을 쓸 수 있고, (실행했다면) --skills가 정상 종료된다. 이어서 확인만 한다. Agent에서 Playwright CLI 스킬을 인식하는지, 또는 터미널에서 CLI가 설치되었는지 확인하라. 서둘러 사이트를 open하거나, 스크립트를 녹화하거나, 스크린샷을 찍지 마라. open을 쓰려거든 기본이 헤드리스임을 먼저 기억하라. 브라우저를 보고 싶을 때만 --headed를 붙이고, 대상 주소를 먼저 확인하라.
사용 사례
사례 1: 공식 CLI를 전역 설치한다. Node.js 18+를 확인한 뒤 npm install -g @playwright/cli@latest를 실행한다. 근거가 다루는 것은 이 설치 명령과 “Playwright CLI with SKILLS”다. 완료 기준은 전역 패키지 설치 성공까지다. 나타나지 않은 제거 단계나 미러 지정은 보태지 마라.
사례 2: 스킬을 로컬에 넣고 헤드리스 기본값을 이해한다. CLI가 설치된 뒤 playwright-cli install --skills를 실행한다. 근거는 로컬 스킬을 이 명령으로 설치한다고 적으며, CLI는 기본이 headless이고 브라우저를 보려면 open에 --headed를 넘긴다고 적는다. 첫 시도 성공 신호는 --skills가 끝나고 Agent가 스킬을 보는 것이다. 발췌에는 open URL이 없으므로 URL을 만들지 말고, --headed를 기본 동작으로 삼지 마라.
사용 경계
주 설치 경로는 npm install -g @playwright/cli@latest뿐이다. playwright-cli install --skills는 스킬 배치이지 병렬 마켓 설치가 아니다. Node.js 18+가 필요하다. 나열된 Agent는 유일한 지원 범위가 아니다. 기본은 헤드리스이며, open에 --headed를 붙이면 브라우저가 뜬다. 적히지 않은 녹화 대상, 선택자, 스크린샷 경로를 안전 결론으로 삼을 수 없다.