インストール
npm install -g @playwright/cli@latest誰向けか
このガイドは Playwright CLI が必要で、コーディング Agent に対応する SKILLS を入れたい開発者向けです。公式には Playwright CLI with SKILLS として書かれています。
着手前に、このマシンが Node.js 18 or newer であることを確認してください。ページは Claude Code、GitHub Copilot、または any other coding agent も必要だと書いています。これは実行面の説明であり排他リストではなく、グローバル npm インストールを未掲載のマーケットプラグインへ一般化しないでください。
CLI はデフォルトで headless です。ブラウザを明示的に開きたいときだけ open に --headed を付けます。初回は未確認の URL に対する open や録画をしないでください。
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 を付けるとブラウザが出ます。書いていない録画対象、セレクタ、スクリーンショットパスを安全結論にしてはいけません。