インストールと動作のトラブルシューティング

​

まず診断を実行する

npx cc-safety-net status
npx cc-safety-net doctor

​

コマンドが検査されないまま実行される

​

コマンドの実行前に毎回数秒待たされる

time npx -y cc-safety-net --version
time npx -y --prefer-offline cc-safety-net --version
npm cache verify

​

破壊的なコマンドがブロックされずに実行された

1. npx cc-safety-net explain "<the command>" を実行します。検査したルール、実際に適用されている安全レベル、そのレベルで無効になっているルールが表示されます。
2. レベルが standard なら、standard で意図的に緩めている範囲に該当する可能性があります。コマンドが敵対的な文脈から来る可能性があるなら、strict か paranoid を使ってください。
3. Claude Code では、自分で承認した可能性があります。Claude Code がブロックせずに確認を求める場合を参照してください。
4. カレントディレクトリ配下の rm -rf のように、意図的に許可されているコマンドの可能性があります。ブロックされるコマンドを参照してください。
5. CC Safety Net がルールの設定元を破棄すると、npx cc-safety-net status の判定は degraded になり、その設定元の拒否は適用されなくなります。設定の復旧を参照してください。
6. status の Project policy の欄には、このプロジェクトでプロジェクトの policy.json が緩めた項目が並びます。報告される緩和を参照してください。
7. CC Safety Net が中身を解析しないプロキシ経由でコマンドが実行された可能性があります。npx -y cc-safety-net rule wrapper add <command> でそのプロキシを登録してください。
8. エージェントがそのツールやディレクトリをカバーしていない可能性があります。エージェント固有の制限を参照してください。

​

必要なコマンドがブロックされる

• リンクされた git ワークツリーで作業しているなら、ワークツリーモードを有効にして、ローカル破棄のルールを緩めます。
• より安全な書き方を使います。git push --force-with-lease と git clean -n は許可されています。
• エージェントの外で、自分でコマンドを実行します。

​

拒否メッセージ

​

派生コマンドの処理量の上限を超えた

Command analysis exceeds CC Safety Net's derived-command work limit. Reduce nested or embedded command complexity and retry.

​

安全に解析できる上限を超えた

CC Safety Net could not analyze the command because it exceeds safe analysis limits. Simplify or split the command and retry.

​

解析が予期せず失敗した

CC Safety Net failed closed because command analysis failed unexpectedly. This is not caused by your command. Report it to the user.

​

ツール呼び出しが不正な形で届いた

CC Safety Net could not check this tool call because it arrived without a usable tool name or arguments. This is not a CC Safety Net failure. Send the call again with its tool name and complete arguments.

​

セッションの作業ディレクトリが使えない

CC Safety Net cannot check tool calls because the session's working directory or workspace root no longer exists, is inaccessible, is not a directory, or uses an unsupported path form. Ask the user to restart the session from an existing directory.

​

呼び出しが指定した作業ディレクトリを指す拒否

CC Safety Net could not use the requested working directory because it does not exist, is inaccessible, is not a directory, or uses an unsupported path form. Use an existing accessible working directory. If the requested directory is missing, create it from an accessible location before retrying the command.

​

Claude Code が「could not verify this command」と確認を求める

​

ポリシーの提案を適用できるのはユーザーだけ

Only the user may apply a policy proposal, because it rewrites the configuration CC Safety Net enforces. Ask them to run `cc-safety-net policy apply <file>` themselves in a terminal; you can run `cc-safety-net policy check <file>` to show them what it would change.

​

カスタムルールが適用されない

1. npx cc-safety-net doctor を実行します。拒否されたファイルとその理由が表示されます。
2. npx -y cc-safety-net rule list を実行し、各スコープが読み込んだ設定元とルールブックを確認します。別の名前のルールブックを編集しても効果はありません。また、rule.json の overrides のエントリでルールが無効になっている場合もあります。
3. 修正のたびに npx -y cc-safety-net rule verify を実行します。エラーが残っていれば、成功とは報告せずにそのエラーで失敗します。
4. 以前の .safety-net.json や ~/.cc-safety-net/config.json を使っていた場合は、npx -y cc-safety-net rule migrate を実行します。doctor は未移行のファイルを config.legacy-ignored として報告します。

​

policy や rule のコマンドが、パスはユーザー設定だと報告する

<home>/.cc-safety-net/policy.json is the user policy, not a project policy; use --global for the user scope, or run from a project directory

​

status が degraded と報告する

1. npx cc-safety-net doctor を実行します。config.runtime-degraded の項目に、対象のファイルと修正方法が示されます。
2. そのファイルを修正するか、npx -y cc-safety-net rule update で見つからないリモートの設定元を取り込み、npx -y cc-safety-net rule verify を実行します。
3. policy.json は自分で修正します。拒否されたセクションの多くはより厳しい既定値に戻りますが、無効な safety.level は standard に戻るため、保護が弱くなります。

​

doctor がルールブックのロックとキャッシュの残骸を報告する

​

Claude Code にステータスラインが表示されない

​

更新が反映されない

npx -y cc-safety-net@latest update

​

診断情報を集めて報告する

npx cc-safety-net doctor --json