Install
npm i -g @playwright/cli@latest누구에게 맞나
이 기술은 같은 API로 Chromium, Firefox, WebKit을 구동하고 싶은 사람에게 맞다. 공식은 웹 자동화와 테스트 프레임워크로 쓰며, 테스트, 스크립트, 코딩 에이전트의 도구로도 쓸 수 있다. 이미 Claude Code나 Copilot 같은 코딩 에이전트를 쓰고 공식 명령줄을 설치할 준비가 된 사람에게도 맞다. 이 두 이름은 원문 예시이며 그것만 지원한다고 읽으면 안 된다.
아직 전역 패키지 설치에 동의하지 않았는데 테스트 프로젝트 전체를 바로 만들고 싶은 사람에게는 맞지 않는다. 공식에는 따로 npm init playwright@latest가 있어 테스트 프로젝트를 초기화한다. 첫 번째에는 그 경로를 가지 마라. 에이전트가 먼저 명령줄을 쓰게 하려면 주 경로는 @playwright/cli의 전역 설치다.
공식 저장소는 https://github.com/microsoft/playwright 그 페이지에 이미 적힌 명령으로 조작한다.
3분 만에 첫 시도 끝내기
공식이 코딩 에이전트용으로 적은 이 설치 경로만 간다.
전제: 이 기기에서 npm을 실행할 수 있고 전역 설치 한 번에 분명히 동의한다. 먼저 확인한다: npm i -g @playwright/cli@latest는 명령줄을 전역에 설치한다. 아직 이 기기의 전역 패키지를 바꾸고 싶지 않으면 실행하지 마라. 이 단계에서는 테스트 프로젝트를 초기화하지 말고 실제 사이트도 열지 마라.
설치 위치: 아무 터미널에서 위 부작용을 확인한 뒤 실행한다:
npm i -g @playwright/cli@latest
낮은 위험 확인: 설치 후 먼저 에이전트가 공식 설명만으로 이 CLI의 용도를 되풀이하게 한다. 코딩 에이전트용 브라우저 자동화 명령줄로 쓰여 있고, MCP보다 token을 아끼며, 큰 도구 스키마와 접근성 트리를 모델 맥락에 넣지 않는다. 브라우저를 켜지 마라. 외부 사이트에 요청을 보내지 마라. 더 두꺼운 에이전트 통합을 나중에 넣고 싶다면 원문에 playwright-cli install --skills도 있다. 그건 스킬 파일을 쓰므로 실행 전에 다시 확인한다.
성공 신호: 전역 설치가 끝났고, 에이전트가 주 명령이 @playwright/cli라고 가리키며, 나타나지 않은 설치 프로그램으로 바꾸지 않았다. npm init playwright@latest를 바로 돌리면 경로가 틀린 것이니 멈춰라.
사용 사례
사례 1: 코딩 에이전트에 공식 CLI를 설치한다. 원문은 Claude Code, Copilot 옆에 npm i -g @playwright/cli@latest를 쓰고, 이어서 playwright-cli install --skills로 더 풍부한 에이전트 통합을 설치할 수 있다. 먼저 명령줄이 필요하고 스킬 파일을 쓸지는 나중에 정하는 사람에게 맞다. 두 번째 명령은 로컬 스킬 디렉터리를 바꾼다. 실행 전에 확인한다.
사례 2: 엔드투엔드 테스트 프로젝트를 새로 만든다. 공식 명령은 npm init playwright@latest다. 테스트 발판이 필요하다고 이미 정했고 프로젝트 파일을 만드는 데 동의한 사람에게 맞다. 초기화는 디스크에 쓴다. 아직 명령줄만 시험하고 싶을 때 실행하지 마라. 원문에 브라우저 다운로드 스위치가 없으면 인자를 스스로 채우지 마라.
사용 경계
주 경로는 npm i -g @playwright/cli@latest다. 나타나지 않은 설치 프로그램을 주 경로에 넣지 마라. playwright-cli install --skills와 npm init playwright@latest는 원문의 다른 두 명령이며 용도가 다르다. 하나로 섞지 마라.
능력은 같은 API로 Chromium, Firefox, WebKit을 구동해 테스트, 스크립트, 코딩 에이전트에 쓴다. 이름 없는 브라우저 엔진을 구동할 수 있음은 증명하지 않는다. Claude Code, Copilot은 예시 목록일 뿐이다.
공식 페이지는 https://github.com/microsoft/playwright
에이전트가 제안하는 첫 명령이 @playwright/cli의 전역 설치가 아니면 그 페이지를 기준으로 한다. 첫 시도에서 프로덕션 사이트에 자동화를 걸지 마라.