本文へスキップ

Clearcote を最新の状態に保つ

ライセンスキーがない場合、SDK の各バージョンは SHA-256 で検証済みのオープンビルド 1 つに固定されており、更新は通常のパッケージのバージョンアップで済みます。キーがある場合は、SDK が起動のたびに現行のライセンスビルドを取得するので、バージョンアップは不要です。

利用できるビルド

現在提供中または開発中の Chromium メジャーバージョンと、各ティアで利用できるようになる時期：

Chromium ビルドオープンソース無料キー & Pro
現行のライセンスビルド156r57 · 25 Oct 2026約 2 か月後提供中
過去のライセンスビルド155·154·153·152未提供Pro のみ — version="155"
現行のオープンビルド151v0.1.0-pre.25 · 28 Oct 2026提供中提供中
過去のオープンビルド150·149提供中提供中

すべてのビルドは Windows + Linux x64 向けです。 新しい Chromium メジャーバージョンは、ビルドできたその日にライセンスビルド（ブラウザ 1 つなら無料、または Pro）へ提供されます。オープンビルドには、同じメジャーバージョンが完全にオープンで再現可能な形で、およそ 2 か月後に届きます。

ほかの依存関係と同じようにパッケージを更新します：

bash
npm i clearcote@latest          # Node
pip install -U clearcote        # Python
dotnet add package Clearcote    # .NET (adds or updates to the newest version)

次に launch() を呼んだとき、SDK は必要なビルドがキャッシュにないことを検知してダウンロードし（オープンビルドは GitHub Releases から、ライセンスビルドは clearcotelabs.com から）、使用前に SHA-256 を検証します。検証されていないものが実行されることはありません。ビルドはビルドごとにユーザーのキャッシュディレクトリ（Windows では %LOCALAPPDATA%\clearcote\Cache、Linux では ~/.cache/clearcote。場所を変えるには CLEARCOTE_CACHE を設定）にキャッシュされるため、ダウンロードはそれぞれ 1 回だけです。古いビルドは clearcote clear-cache を実行するまで残ります。

複数のプログラムで 1 つのキャッシュを共有する

キャッシュを共有するプログラムは、順番にビルドをインストールします（SDK 0.41.0+。Python、Node、.NET のいずれも同様）。最初のプログラムがダウンロードし、ほかのプログラムはその完了を待ってから使います。別のプログラムが実行中のビルドが、実行中に置き換えられることはありません。待機中のプログラムは 30 分で待つのをやめ、インストールを保持しているプロセスを示すメッセージを表示します（ロックはそのビルドのキャッシュフォルダーにある .install-lock ファイルで、いつ削除しても安全かはメッセージに示されます）。クラッシュしたプログラムが残したロックは、自動的に引き継がれます。

キャッシュ済みのビルドのファイルが破損したり削除されたりした場合（ウイルス対策ソフトによる隔離、フォルダーの削除など）は、次回の起動時に 1 回のダウンロードで修復されます。そのファイルがまだ使用中の場合は、起動がその場で停止し、そのブラウザを使っているプログラムをすべて閉じてから再試行するよう求めます。このロックが機能するには、キャッシュを共有するすべてのプロセスが SDK 0.41.0 以降で動いている必要があります。古いリリースはロックを待ちません。

Windows：環境によっては、ダウンロードしたビルドをその場所から起動できないことがあります。たとえば、パッケージ化された（MSIX）アプリの中で動くプログラムでは、%LOCALAPPDATA% への書き込みが Windows によってリダイレクトされます（起動は spawn UNKNOWN または "the side-by-side configuration is incorrect" で失敗します）。その場合、SDK はビルドのコピーを ~/.clearcote/recovered に 1 つ作り、以降は Python、Node、.NET のどこから起動してもそれを使います。そのため一時フォルダーには何も残らず、2 回目以降の起動は数秒で済みます（Python と Node は 0.40.1 から、.NET は 0.41.0 から）。clearcote clear-cache はこれらのコピーも削除します。.NET SDK にはコマンドラインがないため、そこでは WinLaunch.ClearRecovered() を呼び出してください。

SDK をアップグレードせずにオープンビルドを更新する

キーがない場合は、自動更新を有効にすると、SDK が固定しているビルドの代わりに GitHub 上の最新のオープンビルドを使えます。そのリリースの SHA256SUMS.txt と照合して検証し（gpg がインストールされていれば署名鍵とも照合します）、GitHub に接続できない場合は固定のビルドにフォールバックします。シェルからは clearcote update で同じことができます。キーがある場合は何も変わりません。すでに現行のライセンスビルドを使っているからです。

javascript
import { launch } from "clearcote";
await launch({ autoUpdate: true });   // or set env CLEARCOTE_AUTO_UPDATE=1
ブラウザ自体が外部へ勝手に通信したり、自らを更新したりすることはありません。キーがない場合、ブラウザが変わるのは SDK をバージョンアップしたときか、autoUpdate を有効にしたときだけです。キーがある場合、SDK は新しいライセンスビルドを次回の起動時に取り込みます。Pro では version でビルドを固定しておけます。

ビルドを選ぶ

version を渡します（または CLEARCOTE_BROWSER_VERSION を設定します）。指定できるのは "latest"、"156" のようなメジャーバージョン、"156.0.8078.47" のような正確なバージョン、またはライセンスビルドのリビジョン "r57" / "156.0.8078.47-r57" です。何かをダウンロードする前に、バージョンやメジャーは公開カタログと、リビジョンはライセンスサーバーと照合されます。releaseChannel: "preview"（Python では release_channel、または CLEARCOTE_RELEASE_CHANNEL=preview）を指定すると、プレビュービルドがあればそれを取得します。ライセンスビルドでは、古いビルド、バージョン固定、プレビューチャンネルは Personal と Pro で使えます。無料キーでは常に最新版が使われます。

bash
clearcote install --version 156        # fetch + verify a build ahead of time
clearcote install --channel preview     # the newest preview build (Pro)
clearcote info                          # what's installed and cached, and your key
clearcote clear-cache                   # delete cached builds

バイナリを直接使う場合 / Docker を使う場合

  • バイナリを直接使う場合（オープンビルドのみ。ライセンスビルドは SDK、clearcote serve、Docker イメージのいずれかを通じて実行します）：Releases ページから新しいアーカイブをダウンロードし、チェックサムと署名を検証して（検証を参照）、executable_path / executablePath（または CLEARCOTE_BINARY）を新しい chrome に向けます。
  • Docker：docker pull teamflatearth/clearcote で最新のイメージを取得し、コンテナを作り直します。無料キーには、SDK 0.30.0 以降でビルドされたイメージが必要です。キーを使う場合は -v clearcote-cache:/opt/xdg-cache をマウントしてください。そうすれば、ライセンスビルドは新しいコンテナのたびにダウンロードされることなく、1 回のダウンロードで済みます。デプロイを参照してください。

ライセンスビルド：常に最新、しかもいち早く

ライセンスビルドは最新の Chromium と最新のパッチに追従するため、手動で再ビルドしなくても更新を受け取れます。CLEARCOTE_LICENSE_KEY を設定するか、licenseKey を渡すか、clearcote login を実行してください（Python / Node の場合。npm でローカルにインストールしたときは npx clearcote login）。このコマンドはキーを確認して ~/.clearcote/license.key に保存します。このファイルは .NET を含むすべての SDK が読み込みます。キーの入手方法は 3 つあります：

  • GitHub で無料：同時に 1 つのブラウザを無料で使えます。ダッシュボードの「Licenses」を開き、次の 3 つのいずれかの方法で取得します。作成から 30 日以上経った GitHub アカウントを接続する（「Connect GitHub and get it free」）、カード確認を行う（カードに請求されることはありません。プリペイドカードは不可）、または会社の Google Workspace アカウントでサインインする（会社のドメインごとに 30 日あたり最大 3 件）。キーは GitHub アカウント、カード、Google アカウントそれぞれにつき 1 つです。キーの有効期間は 30 日です。期限が切れる前に、同じページから無料で更新してください。
  • Personal：同じビルドを、同時起動は最大 15 ブラウザまで使えます。古いビルド、バージョン固定、プレビューチャンネルも利用できます。メールサポートは付きません。
  • Pro：同じビルドを、同時起動は最大 250 ブラウザまで使えます。古いビルド、バージョン固定、プレビューチャンネルも利用でき、オーナーによるメールサポートも付きます。
新しいメジャーバージョンは、まずライセンスビルドに届きます。新しい Chromium メジャーがビルドされると、「GitHub で無料」と Pro ではすぐに利用できます。オープンビルドにはその後で入り、目標はリリースから約 2 か月後です（現在は Chromium 151）。オープンビルドは常に完全にオープンで、再現可能です。ライセンスビルドは最新のものをより早く受け取ります。

ライセンスブラウザのカウント方法

キーを使って起動したブラウザは、それぞれライセンスサーバーからスロットを 1 つ取得し、終了時に返却します。使用中の数はダッシュボードに表示され、clearcote info でも同じ数が表示されます。

  • 「GitHub で無料」はすべてのブラウザをカウントします。スロットは 1 つだけなので、最初のブラウザが終了するまで、2 つ目のブラウザは（同じプログラム内でも、別のプログラムでも、別のマシンでも）The free tier runs one browser at a time, and one is already running というエラーで拒否されます。正常に終了せずクラッシュしたブラウザのスロットは、6 分以内に解放されます。
  • Personal はすべてのブラウザをカウントし、同時に最大 15 までです。1 台のマシンでも複数台でも、ブラウザはそれぞれ自分のスロットを持ち、16 個目はどれかが終了するまで拒否されます。Personal には SDK 0.55.0 以降（Profile Manager 0.19.0）が必要です。
  • Pro は同時に最大 250 ブラウザまで対応します。SDK 0.55.0 以降ではブラウザごとに自分のスロットを持つため、ダッシュボードはマシンではなくブラウザを数えます。古い SDK では、引き続き 1 台のマシンにつき 1 つのスロットを共有します。2026 年 9 月 26 日より前に開始したサブスクリプションには、これまでの上限なしの条件が引き続き適用されます。250 を超える数が必要な場合は、100 単位のブロックを追加するか、ご相談ください。
  • 無料キーには SDK 0.30.0 以降が必要です（Python、Node、.NET）。すべてのブラウザをカウントするには、SDK が起動のたびにそれを報告し、ブラウザの実行中はライセンスを有効な状態に保つ必要があるためです。古い SDK にはアップグレード用のコマンドとともに SDK_UPGRADE_REQUIRED が返され、それでも古い SDK がエンジンまで到達した場合は、エンジン側で拒否されます。Pro キーは、これまでどおり古い SDK でも動作します。
  • 無料のブラウザは、スロットがなくなると停止します。チェックは起動時だけでなく継続的に行われます。キーが失効した場合、スロットが別の場所から返却（チェックイン）された場合、またはライセンスが上限を超えた場合、すでに開いている無料のブラウザは約 2〜3 分以内に終了します。短時間のネットワーク断（ハートビートの 1〜2 回の取りこぼし）は吸収されますが、約 2〜3 分を超えて接続できない状態が続くと、同じように無料のブラウザは停止します。
  • 無料キーでは常に最新ビルドが動きます。古いライセンスビルドやプレビューチャンネルを要求すると FREE_LATEST_ONLY が返されます。ビルドの固定には Personal または Pro が必要です。
  • 無料キーでのダウンロード：24 時間あたり最大 10 個の異なるビルドまで。同じビルドは、何度起動しても 1 回とカウントされます。
bash
pip install -U clearcote          # Python 0.30.0+
npm i clearcote@latest            # Node 0.30.0+
dotnet add package Clearcote      # .NET 0.30.0+

アップグレードで変わること

ほとんどの SDK リリースでは、対応が必要な変更はありません。以下のリリースは、既存の構成の動作を変えます。すべてのリリースは、ダッシュボードの「Releases」に掲載しています。

  • ライセンスビルド 156 r53、ブラウザのデフォルト：Chrome と同じくパスワードの保存がオンになり、サインイン後にブラウザがパスワードの保存を提案します（パスワードマネージャーの設定「パスワードとパスキーの保存を提案する」でオフにできます）。新規・既存のどちらのプロファイルでも Google が再びデフォルトの検索エンジンになり、アドレスバーに入力した検索は Google に送られます。別の検索エンジンは「設定 > 検索エンジン」で選べます。Playwright では SDK 0.63.3 以降を併用してください。アイデンティティは変わっていません。
  • 0.64.1：personaSchema / persona_schema / PersonaSchema はどの SDK でも 5 と 7 を受け付けます。
  • 0.64.0、ライセンスキーなし：SDK は 150 ではなく、オープンビルドの Chromium 151（リリース v0.1.0-pre.25）をダウンロードします。version="150" を指定すれば、引き続き 150 のビルドを取得できます。
  • 2026-10-26 以降に提供されるアイデンティティ（r52、および r51 も）、既存のシード：デフォルトのペルソナスキーマが 7 になりました。グラフィックスカードがマシンの種類、プロセッサー、スレッド数、メモリ、画面を決めるマシンモデルで、シードからは以前とは異なるマシンが導出されます。シードが r45〜r51 で持っていたアイデンティティを維持するには、persona_schema=5 / personaSchema: 5 を設定してください。別のマシンで同じシードを使う場合を参照してください。
  • ライセンスビルド 156 r51：アイデンティティは起動のたびに Clearcote のペルソナサービスから取得されるため、マシンから persona.clearcotelabs.com（フォールバックとして persona-us）への外向き HTTPS 接続が必要です。ブラウザには SDK 0.63.0 以降（無料キーは 0.63.2 以降）、Profile Manager 0.27.0 以降が必要です。r51 でアイデンティティは変わっていません。アーキテクチャを参照してください。
  • ライセンスビルド 155 r45、既存の Windows シード：Windows のプロファイルごとに独自の Office フォントセットを選ぶため、フォントリストが一度だけ変わります。persona_schema=4 / personaSchema: 4 で r44 のアイデンティティをそのまま維持できます。
以前の注意事項（154 ビルド、SDK 0.40〜0.42）
  • ライセンスビルド 154 r37、既存のシード：シードは、マシン自身のグラフィックスのメーカーの実在するモデルのうち、これまでより幅広い範囲から、実際のブラウザトラフィックと同じ出現率でグラフィックスカードを選ぶようになりました。そのため、ほとんどのシードは r36 とは異なるカードを報告します。グラフィックスカードのないマシンは、これまでの Intel のものだけではなく、Intel または AMD の内蔵グラフィックスを名乗るようになりました。シードのハードウェアのほかの部分は変わりません。シードが r36 で持っていたカードを維持するには、persona_schema=3 / personaSchema: 3 を設定してください。r36 より前のアイデンティティは、これまでどおり 2 で維持できます。別のマシンで同じシードを使う場合を参照してください。
  • ライセンスビルド 154 r37、ヘッドレスでのファイル選択と印刷：ページが開き、スクリプトが処理しないファイル選択ダイアログは、すぐには閉じず 4〜9 秒間開いたままになり、その後キャンセルされるようになりました。不要なダイアログを閉じるユーザーと同じ動きです。開いている間は、headed のブラウザと同じく、そのタブはポップアップやピクチャー・イン・ピクチャーのウィンドウを開けません。window.print() はページを約 1.2 秒止めてから afterprint を発火するようになりました。ユーザーが閉じる印刷プレビューと同じ動きです。これまではどちらも数ミリ秒で応答していました。setInputFiles や、スクリプトが処理する filechooser イベントによるアップロードは、これまでどおり動作します。
  • ライセンスビルド 154 r36、既存のシード：シードは、メーカーごとに 1 つのモデルではなく、マシン自身のグラフィックスのメーカーの実在する複数のモデルからグラフィックスカードを選ぶようになりました。そのため、ほとんどのシードは r35 とは異なるカードを報告します。NVIDIA のカードを搭載したマシンでは、エントリーレベルのハードウェア（プロセッサーのスレッド数 4〜6、メモリ 4〜8 GB、小さな画面）を名乗っていたシードが、ミドルレンジ以上を名乗るようになり、そうしたマシンではタッチスクリーンを名乗るシードもありません。シードが r36 より前に持っていたアイデンティティを維持するには、persona_schema=2 / personaSchema: 2 を設定してください。別のマシンで同じシードを使う場合を参照してください。
  • ライセンスビルド 154 r36、サードパーティ Cookie：古い SDK や独自のランチャーが Cookie のオプションを何も渡さない場合も含め、ブラウザは Chrome と同じくデフォルトでサードパーティ Cookie を許可するようになりました。--block-third-party-cookies でブロックできます。
  • ライセンスビルド 154 r36、ヘッドレスでの権限リクエスト：ヘッドレスのブラウザは、サイトからの権限リクエスト（通知、カメラ、マイク、位置情報など）を、求められた瞬間に拒否しなくなりました。リクエストは、headed のブラウザで権限の確認が開いたままのときと同じく、未回答のまま残ります。そのため、Notification.requestPermission() や getUserMedia() を待つスクリプトは、待ち続けるようになります。先に権限を付与するか（Playwright の context.grant_permissions() / context.grantPermissions()）、以前の拒否を得るには --deny-permission-prompts を渡してください。
  • 0.42.0、Linux ホスト：Linux ペルソナの WebGL は、ヘッドレスだけでなく headed でも EGL 経由の Mesa で描画されるようになりました（ホストに libegl1 が必要です）。そのため、headed の Linux ペルソナの WebGL のレンダラー文字列、拡張機能の一覧、上限値が一度だけ変わり、ヘッドレス起動がすでに示していた、実際の Linux マシンの多くが報告するのと同じ形式になります。ウィンドウマネージャーのない Xvfb 上で headed 起動すると、ウィンドウは画面に合わせた状態で開きます。ヘッドレス起動では、ペルソナが適用されない場合でも現実的なディスプレイが保たれ、serve() では --window-position だけを渡した場合もそれが保たれます。Playwright & Puppeteer を参照してください。
  • 154 r34 以降のライセンスビルド、disableGpuFingerprint：GPU が報告する内容だけを変えるようになりました。WebGL のピクセル読み出しにはシードに基づくサイトごとのノイズが残るため、readPixels と WebGL canvas の書き出しが一致します。以前は readPixels のノイズだけを止めていました。フィンガープリントフラグを参照してください。
  • 0.41.1、人間らしい入力：humanize を有効にすると、スクロールは実際のホイールと同じように、マウスホイールのノッチ単位で動きます。1 ノッチあたり、Windows のアイデンティティでは 100 px、Linux では 120、macOS では 40 です。要求した距離は最も近いノッチ数に丸められる（最低 1 ノッチ）ため、mouse.wheel(0, 800) は Windows では 800 px、Linux では 840 スクロールします。また、速いキーの組み合わせでは、タイピング時に前のキーを離す前に次のキーを押すことがあるようになりました。.NET では、数値をシードにしたヒューマナイザーが、Python や Node と同じ運動特性で動くようになりました。以前は、0 以外の数値シードがすべて同じ運動特性を共有していました。人間らしい入力を参照してください。
  • 0.41.0（r32 以降のライセンスビルド）：ペルソナはコマンドラインではなく環境変数経由でブラウザに渡されるため、プロセス一覧からシードを読み取っていたツールでは見つからなくなります（persona_env=False で従来の方法に戻せます）。ローカル起動で作成されるコンテキストはライトのカラースキームをエミュレートしなくなったため、ダークのペルソナはどこでもダークを報告します（固定するには color_scheme を渡します）。ペルソナを指定したヘッドレスの Linux 起動では、ペルソナが名乗るサイズの画面が割り当てられます。起動オプションを参照してください。
  • 0.41.0、Linux 上の .NET：起動時に、ホストのフォントではなく、Python と Node が以前からそうしているようにブラウザに同梱のフォントを使うようになりました。そのため Linux 上の Windows ペルソナの計測値が変わり、ほかの 2 つの SDK と同じになります。Linux で独自のフォントを使うを参照してください。
  • 0.41.0、Windows コンピューター上の Linux ペルソナ：SDK がプロセスごとに一度だけ警告します。Windows は GPU を Direct3D 経由で動かすため、WebGL と WebGPU の上限値に制約がかかります。ペルソナは上限値を下げることはできても、ドライバーの上限を超えて引き上げることはできないため、Windows 上の Linux ペルソナは、どの Linux マシンにもない上限値を報告してしまいます。Windows では Windows を名乗るか、Linux ペルソナは Linux 上か Docker 内で実行してください。この警告は quiet または CLEARCOTE_NO_WARN で抑制できます。
  • Docker イメージ sdk-0.41.0：イメージの seccomp プロファイルを指定してコンテナを起動すれば、Chrome はサンドボックスありで動作できます。指定しなければ、コンテナはこれまでどおり動作します。各文字体系用のフォントも内蔵しています。デプロイを参照してください。
  • 0.40.0：macOS では、launch() が Clearcote の Docker イメージを実行します（Docker Desktop が必要です。docker=False でオフにできます）。macOS を参照してください。

アップグレード後は再検証を

新しいビルドでは、シグナルが変わることがあります。フィンガープリントのチェック（CreepJS など）を再実行し、インポートしたプロファイルを使っている場合は、引き続き整合性を保って読み込まれることを確認してください（検証を参照）。現在のオープンビルドは v0.1.0-pre.25（Chromium 151.0.7922.108）、現在のライセンスビルドは 156.0.8078.47-r57 です。今後の予定はロードマップで確認できます。