# AI クライアントを接続

Canonical: https://heedit.ai/ja/docs/start/ai-clients/
Language: ja

Claude Code と Codex には内蔵のワンショット設定があります。ほかの Agent は MCP スニペットを貼って接続するか、同じ実ファイルを扱えますが、検証済み統合としては扱いません。

## 接続方法を選ぶ

| クライアント | 接続レベル | 現在の方法 |
| --- | --- | --- |
| Claude Code | 直接接続 | MCP、Heedit Skill、注釈 hook をワンショットで設定。セッションを arm すると注釈がリアルタイムに届きます。 |
| Codex | 直接接続 | MCP、Heedit Skill、hook をワンショットで設定。設定後は Codex セッションを再起動し、/hooks で信頼します。 |
| ほかの Agent | ファイルまたは手動 | 設定 › Connectから MCP スニペットをコピーするか、AI Inbox、実ファイルのパス、出力規約を使います。 |

## ワンショット設定

ヘルプ → セットアップガイドで Connect AI を選ぶか、設定 › Connectで「すべて接続」を押します。同じ操作はターミナルでも実行できます。

- この Mac にどのクライアントがあるかを検出し、それぞれに MCP server の登録、Heedit Skill の設置、注釈 hook の追加を行います。触るのは Heedit 自身の項目だけです。
- 設定レポートは設定 › Connectにあります。クライアントごとの状態、配送レベル、残っている手順を示します。
- 1 つだけ接続するなら heedit install claude-code または heedit install codex。heedit uninstall で対称に削除できます。

```
heedit install
```

## 能力の境界を知る

内蔵の直接設定があるのは現在 Claude Code と Codex です。手動設定やファイルワークフローだけでライブ接続が成立するわけではなく、任意ファイルへの無言アクセスも許しません。Heedit 経由の本文要求は確認規則に従い、Agent 自身の別のファイル権限は Agent と OS が管理します。