npx -y cc-safety-net@latest install --codex を実行します。cc-marketplace マーケットプレイスが追加され、cc-safety-net@cc-marketplace プラグインがインストールされます。Codex は信頼されていないフックを実行しないため、続けて Codex の /hooks メニューでフックを信頼してください。
Codex に CC Safety Net をインストールする
1
インストーラーを実行する
2
フックを信頼する
Codex を起動して
/hooks を開き、cc-safety-net PreToolUse hook を選択して t を押し、信頼済みにします。3
プラグインが有効か確認する
doctor の出力で Codex の行は Detected と Configured になります。
Codex のインストールで変わること
インストーラーはkenryu42/cc-marketplace から cc-marketplace マーケットプレイスを追加し、cc-safety-net@cc-marketplace プラグインをインストールします。
このプラグインには /cc-safety-net スキルも含まれています。
Codex のフックがチェックする内容
プラグインのフックは、Codex のPreToolUse イベントで cc-safety-net hook --codex(短いフラグは -cx)を実行します。
Codex での保護範囲の制限
- 入力されたテキスト。 Codex は、コマンドがシェルセッションを開くときには
PreToolUseイベントを送りますが、write_stdinでは送りません。そのため CC Safety Net がチェックするのは、セッションを開いたコマンドだけです。その後モデルが実行中のセッションに入力したテキストは、チェックされないままシェルに届き、監査ログにも残りません。この穴をふさげるのは Codex だけです。 - 作業ディレクトリ。 Codex はコマンドを呼び出しの
workdirで実行しますが、workdirをフックに渡しません。そのため CC Safety Net は、代わりにそのターンの作業ディレクトリを基準にコマンドを解析します。結果として、相対パスや、作業ディレクトリ外のパスに関するルールを、誤ったディレクトリを基準に解決します。安全なコマンドをブロックしたり、ルール上ブロックされるはずのコマンドを許可したりすることがあります。
Codex でチェックが失敗したときの動作
Codex のフックはフェイルオープンです。フックがクラッシュした、タイムアウトした(既定は 600 秒)、起動できなかった、不正な出力を返した場合、Codex はフックの実行を失敗として記録し、そのままツール呼び出しを実行します。CC Safety Net 自身が捕捉したエラーは、フックが拒否を出力するため引き続きブロックされます。Codex から CC Safety Net をアンインストールする
Codex のトラブルシューティング
-
Codex の行が
Not configuredになる。 プラグインはインストールされていますが、有効になっていません。Codex で有効にしてください。Not detectedの場合は、プラグインがインストールされていません。 -
doctorが信頼のリマインダーを表示する。 Codex の行がConfiguredのとき、doctorは信頼の状態を確認できないため、実行のたびに次のメッセージを表示します。信頼されていないという意味ではなく、終了コードも変わりません。