npx -y cc-safety-net@latest install を実行し、一覧からコーディングエージェントを選びます。インストーラーは、選んだ各エージェントに CC Safety Net をプラグイン、拡張機能、フックのいずれかとして追加します。エージェントによっては、その後に再起動や信頼の確認が必要です。最後に npx cc-safety-net doctor を実行して、保護が有効になったことを確認してください。
インストール前の確認
- Node.js 22 以降をインストールしてください。このページのコマンドは
npxを使います。Node.js 18 と 20 はすでに EOL を迎えており、CC Safety Net はサポートしていません。 - 使用するエージェントで、お使いのプラットフォームが対応しているか確認してください。
Amp のマニュアルが対応対象として挙げているのは macOS、Linux、WSL で、ネイティブの Windows ではありません。
対話形式でインストールする
1
インストーラーを起動する
2
エージェントを選ぶ
Space でエージェントを選び、Enter で確定します。そのほかのキーはターゲットセレクターのキーにまとめています。3
エージェント側の手順を済ませる
フックが動作する前にエージェントの再起動や信頼の確認が必要な場合は、ここで済ませてください。必要な手順は、エージェントごとのインストールの表の「追加の手順」列に載っています。
4
保護が有効か確認する
doctor は対応するすべてのエージェントをチェックし、失敗した項目があれば直し方を示します。
インストールコマンドの @latest は省略しないでください。npx はダウンロードしたパッケージをキャッシュに保存するため、バージョンを付けない cc-safety-net では、最新リリースではなくキャッシュに残った古いコピーが実行されることがあります。
エージェントごとのインストール
スクリプトなどから 1 つのエージェントだけにインストールするには、下の表にあるそのエージェントのターゲットフラグを渡します。インストールで何が変わるか、そのエージェントのフックが何をチェックするか、どう削除するかは、各エージェントのページで説明しています。
インストールコマンドは何度実行しても安全です。設定済みのエージェントで再実行しても、管理対象のエントリは 1 つだけ残ります。
CC Safety Net を更新する
update は、マシンにインストール済みの連携をすべて更新します。新しい連携をインストールすることはありません。エージェントごとの動作は update を参照してください。
v1 または 2.2 以前からのアップグレード
- v1 から。
updateを実行すると、インストール済みの連携がすべて現在のリリースに移行します。v1 のインライン設定でカスタムルールを定義していた場合は、旧形式の設定の移行を済ませてください。その後、npx cc-safety-net doctorでランタイムがreadyになっていることを確認します。 - 2.2 以前で、GitHub からルールブックを導入していた場合。 アップグレード後、スコープごとに
rule syncを 1 回実行してください。ユーザースコープの設定元には--globalを付けます。実行するまでそのルールは無効なままで、statusとdoctorは degraded の設定元として報告します。
CC Safety Net をアンインストールする
インストーラーのアンインストール用のセレクターを使うか、ターゲットフラグを 1 つ渡します。CLI をグローバルにインストールする
CLI を頻繁に使う場合は、グローバルにインストールしてください。グローバルインストールでは、同じコマンドを短く書けるエイリアスccsn も追加されます。
npx で実行する場合は、cc-safety-net という完全な名前を使ってください。
旧プラグイン識別子からの移行
以前のリリースでは、Claude Code と Codex がプラグイン識別子safety-net@cc-marketplace を、GitHub Copilot CLI が copilot-safety-net を使っていました。各エージェントの通常のインストールコマンドが古いプラグインを削除するため、手作業で削除する必要はありません。新しく設定を書くときは、現在の識別子 cc-safety-net@cc-marketplace を使ってください。