> ## Documentation Index
> Fetch the complete documentation index at: https://ccsafetynet.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# install コマンド

> cc-safety-net install のリファレンスです。16 個のターゲットフラグ、npx キャッシュの消去、対話型のターゲットセレクターとそのキー操作、インストールの失敗を説明します。

`install` は、コーディングエージェント CLI に CC Safety Net を設定します。フラグなしで実行するとリストからエージェントを選べます。スクリプトでインストールする場合は、ターゲットフラグを 1 つだけ指定します。失敗したターゲットは、原因のヒントを表示して `1` で終了します。

```bash theme={"dark"}
npx -y cc-safety-net install
npx -y cc-safety-net install --claude-code
```

エージェントごとの手順と、インストールで変更される内容は、[インストール](/docs/ja/installation.md)を参照してください。

## install のターゲットフラグ

`install` は 16 個のターゲットを受け付けます。インストールで何を書き込み、何を実行するかは、各エージェントのページに記載しています。

| フラグ | エージェント |
| - | - |
| `--amp` | [Amp Code](/docs/ja/installation/amp-code.md) |
| `--agy-cli` | [Antigravity CLI](/docs/ja/installation/antigravity-cli.md) |
| `--claude-code` | [Claude Code](/docs/ja/installation/claude-code.md) |
| `--codex` | [Codex](/docs/ja/installation/codex.md) |
| `--cursor` | [Cursor](/docs/ja/installation/cursor.md) |
| `--deepseek-harness` | [DeepSeek Harness](/docs/ja/installation/deepseek-harness.md) |
| `--devin` | [Devin CLI](/docs/ja/installation/devin-cli.md) |
| `--droid` | [Factory Droid](/docs/ja/installation/factory-droid.md) |
| `--gemini-cli` | [Gemini CLI](/docs/ja/installation/gemini-cli.md) |
| `--copilot-cli` | [GitHub Copilot CLI](/docs/ja/installation/github-copilot-cli.md) |
| `--grok-build` | [Grok Build](/docs/ja/installation/grok-build.md) |
| `--hermes-agent` | [Hermes Agent](/docs/ja/installation/hermes-agent.md) |
| `--kimi-code` | [Kimi Code](/docs/ja/installation/kimi-code.md) |
| `--openclaw` | [OpenClaw](/docs/ja/installation/openclaw.md) |
| `--opencode` | [OpenCode](/docs/ja/installation/opencode.md) |
| `--pi` | [Pi](/docs/ja/installation/pi.md) |

指定できるフラグは 1 つまでです。複数指定すると、`install` は `Choose exactly one install|uninstall target:` に続けてフラグの一覧を出力し、`1` で終了します。不明なオプションや余分な引数もエラーになります。

## npx キャッシュの消去

Antigravity CLI、Cursor、Devin CLI、Factory Droid、Grok Build、Hermes Agent、Kimi Code は、`npx` でフックを実行します。`install` はこれらを設定する前に、npm キャッシュの `_npx` フォルダーからキャッシュ済みの `cc-safety-net` を削除します。これにより、新しいフックは最新のリリースを実行します。npm キャッシュの場所は次のとおりです。

* `$npm_config_cache`（この変数が設定されている場合）
* macOS と Linux では `~/.npm`
* Windows では `%LOCALAPPDATA%\npm-cache`

`uninstall` はキャッシュに触れません。`update` は 1 回の実行につき 1 回キャッシュを消去します。

## ターゲットの選択

対話型のターミナルでフラグなしで実行すると、`install` はエージェントを一覧表示し、各行にラベルを付けます。

| ラベル | 意味 |
| - | - |
| `CLI not installed` | エージェントがインストールされていない |
| `already installed` | そのエージェントには CC Safety Net が設定済み |
| `not installed` | そのエージェントは未設定（uninstall 時に表示される） |

Cursor は、`cursor --version` と `cursor-agent --version` のどちらかが成功すればインストール済みとみなされます。

## ターゲットセレクターのキー

| キー | 動作 |
| - | - |
| `Space` | 強調表示したターゲットの選択を切り替える |
| `Enter` | 選択を確定する |
| `Up`/`Down`, `k`/`j` | 選択できる行の間を移動する |
| `u`, `U` | セレクターを終了して [`update`](/docs/ja/reference/cli/update) のフローを実行する。install 時のみ |
| `q`, `Esc` | キャンセルする |

## ターゲットセレクターのキャンセル

`q` または `Esc` を押すと、`Cancelled: nothing was installed.` または `Cancelled: nothing was uninstalled.` を出力して `0` で終了します。

## 選択したターゲットの実行

インストールによっては、エージェント自身の CLI を実行します。そのコマンドが 120 秒経っても終わらない場合、`install` はコマンドを停止し、そのターゲットを失敗として報告します。

## install の失敗と終了コード

インストールに失敗すると `1` で終了します。次のエラーについては、`install` がヒントを出力します。

* 権限の問題
* パスが存在しない
* パスの途中にディレクトリではない要素がある


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.