Windowsへのインストール
ワンクリックインストーラー、セキュリティ警告の意味、そして動作確認の方法。
Windowsでは、コマンドライン操作の代わりにワンクリックのインストーラーが用意されています。ダウンロードして実行するだけの小さなプログラムで、管理者権限は必要ありません。
1. インストーラーをダウンロードして実行する
プロジェクトのGitHubリリースページから andon-light-setup.exe を取得し、実行してください。ユーザーアカウント単位でインストールされ（管理者権限のプロンプトは出ません）、PATHにも自動的に追加されます。
2. セキュリティ警告について
インストーラーもツール本体も、デジタル署名がされていません。そのため、どちらを初めて実行してもWindowsが「Windows によって PC が保護されました」という警告を表示し、一部のセキュリティソフトが反応することもあります。
これは、このような小規模で未署名のツールがパッケージ化される際によく起こる副作用で、一部のマルウェアの挙動と似て見えてしまうことが原因です。何かが壊れているわけではありません。
そのまま続行するには： 「詳細情報」をクリックし、続けて「実行」をクリックします。
この警告への本当の対策（有料のコード署名証明書を取得すること）には、年間おおよそ70〜400ドルほどかかります。しかも、新しく取得した証明書であっても、Windows側の信頼を積み上げるまでには時間がかかります。ごく少人数に直接配布するだけの趣味のプロジェクトとしては、今のところそこまでする価値はないと考えています。
3. うまくいったか確認する
新しいターミナルウィンドウを開き（インストール前から開いていたターミナルは、更新後のPATHを認識しません）、次を実行します。
andon-light doctorツールがデバイスを見つけられるか確認できます。
4. 使っているエージェントと接続する
インストーラーの完了画面には、Claude Code用とCodex CLI用、それぞれ独立したチェックボックスがあります。使っている方にチェックを入れてください。どちらも、Claude Code フック連携やCodex CLI フック連携で説明している「変更内容を表示してから確認を求める」流れで、そのエージェント向けの andon-light install-hooks を実行してくれます。後からでも、ターミナルで次を実行すればいつでも同じことができます。
andon-light install-hooks # Claude Code
andon-light install-hooks --agent codex # Codex CLICodex CLIのチェックボックスを入れた場合、インストーラーでは代行できないもう一つの手順があります：Codex CLIを開いて /hooks を一度実行し、新しいフックファイルを信頼する必要があります。理由と、ChatGPTデスクトップアプリのCodexタブしか使わない場合に必要な追加手順は、Codex CLI フック連携を参照してください。
うまくいかない場合
トラブルシューティングページのWindows特有の注意点を参照してください。インストール後のPATHの問題や、古いバージョンからアップグレードする際に残ってしまうPATHの後始末について説明しています。