# 手動インストール

本書では、GitHubリポジトリをクローンしてスキルファイルを配置する手動インストールを説明します。エアギャップ環境にある場合、Node.jsがない場合、インストール内容を細かく管理したい場合に有効な手順です。より手早くセットアップする場合は、AIエージェント向けの[インストール方法一覧](/keeperpam/jp/secrets-manager/integrations/ai-agents.md#installation)をご参照ください。

***

### 手順1: リポジトリのクローン <a href="#step-1-clone-the-repo" id="step-1-clone-the-repo"></a>

```bash
git clone https://github.com/Keeper-Security/keeper-agent-kit
cd keeper-agent-kit
```

### 手順2: エージェントにスキルをコピー <a href="#step-2-copy-skills-to-your-agent" id="step-2-copy-skills-to-your-agent"></a>

エージェントごとにスキルを置くディレクトリが異なります。下表で使用するエージェントの行を確認し、右列のパスへファイルをコピーしてください。

| エージェント                 | スキル格納パス               |
| ---------------------- | --------------------- |
| Claude Code (グローバル)    | `~/.claude/skills/`   |
| Claude Code (プロジェクト)   | `./.claude/skills/`   |
| Cursor (グローバル)         | `~/.cursor/skills/`   |
| Cursor (プロジェクト)        | `./.cursor/skills/`   |
| Codex                  | `~/.codex/skills/`    |
| GitHub Copilot         | `~/.github/skills/`   |
| VS Code (Copilot Chat) | `./.github/skills/`   |
| OpenCode               | `~/.opencode/skills/` |
| Gemini CLI             | `~/.gemini/skills/`   |

**例: Claude Code (グローバルインストール)**

```bash
mkdir -p ~/.claude/skills
cp -r plugins/*/skills/* ~/.claude/skills/
```

**例: Claude Code (プロジェクト単位、チームと共有)**

```bash
mkdir -p .claude/skills
cp -r plugins/*/skills/* .claude/skills/
```

プロジェクト側に配置した場合は、`.claude/skills/` をリポジトリにコミットすると、共同作業者も同じスキルを利用できます。

**例: Cursor**

```bash
mkdir -p ~/.cursor/skills
cp -r plugins/*/skills/* ~/.cursor/skills/
```

### 手順3: 動作確認 <a href="#step-3-verify" id="step-3-verify"></a>

コピーしたらエージェントのセッションを再起動し、以下のようなプロンプトで試します。

> "How do I list my KSM profiles?"

エージェントが `ksm profile list` と応答すれば、スキルが読み込まれています。

Claude Codeでは、`/plugin` を実行し、**\[インストール済み]** タブでも確認できます。

***

### 個別スキルのインストール <a href="#installing-individual-skills" id="installing-individual-skills"></a>

必要なスキルが1つだけの場合は、該当するフォルダだけをコピーします。

```bash
# secretsスキルのみ
cp -r plugins/keeper-secrets/skills/keeper-secrets ~/.claude/skills/

# adminスキルのみ
cp -r plugins/keeper-admin/skills/keeper-admin ~/.claude/skills/

# setupスキルのみ
cp -r plugins/keeper-setup/skills/keeper-setup ~/.claude/skills/
```

***

### 複数エージェントへのセットアップ <a href="#multi-agent-setup" id="multi-agent-setup"></a>

複数のエージェントを使う場合、同じクローンからまとめてインストールできます。

```bash
# Claude Code、Cursor、Codex向け
for dir in ~/.claude/skills ~/.cursor/skills ~/.codex/skills; do
  mkdir -p "$dir"
  cp -r plugins/*/skills/* "$dir/"
done
```

または、シンボリックリンクで正本を1か所にまとめると、更新内容を各エージェントへまとめて反映しやすくなります。

```bash
CANONICAL=~/.agent-skills/keeper
mkdir -p "$CANONICAL"
cp -r plugins/*/skills/* "$CANONICAL/"

# 各エージェントへシンボリックリンク
ln -sf "$CANONICAL"/keeper-secrets ~/.claude/skills/keeper-secrets
ln -sf "$CANONICAL"/keeper-secrets ~/.cursor/skills/keeper-secrets
# ... スキルとエージェントごとに繰り返し
```

***

### アップデート <a href="#updating" id="updating"></a>

GitHubから最新の変更を取得したあと、各エージェントのスキルディレクトリへファイルを再コピーします。

```bash
cd keeper-agent-kit
git pull
cp -r plugins/*/skills/* ~/.claude/skills/
```

***

### アンインストール <a href="#uninstall" id="uninstall"></a>

エージェントのスキルフォルダから、該当するスキルディレクトリを削除します。

```bash
rm -rf ~/.claude/skills/keeper-secrets
rm -rf ~/.claude/skills/keeper-admin
rm -rf ~/.claude/skills/keeper-setup
```

他のエージェントに入れた場合も同様に繰り返します。

これで削除されるのはエージェント用スキルのみです。KSM CLIとコマンダーCLIはマシン上に残ります。


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.keeper.io/keeperpam/jp/secrets-manager/integrations/ai-agents/manual-install.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.