# 连接 AI 客户端

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

Claude Code 与 Codex 支持内置一键接入。其他 Agent 可复制 MCP 配置片段接入，或处理同一份真实文件，但不应被描述成已验证集成。

## 选择对应的连接方式

| 客户端 | 连接级别 | 当前路径 |
| --- | --- | --- |
| Claude Code | 直接连接 | 一键接入 MCP、Heedit Skill 与批注 hooks；会话 arm 后批注实时送达。 |
| Codex | 直接连接 | 一键接入 MCP、Heedit Skill 与 hooks；装完需重启 Codex 会话并用 /hooks 信任。 |
| 其他 Agent | 文件或手动工作流 | 在设置 › Connect里复制 MCP 配置片段，或使用 AI 收件箱、真实文件路径、复制的输出约定。 |

## 一键接入

打开“帮助 → 起步指南”，选择“连接 AI”；或在“设置 › Connect”里点“全部接入”。终端中的同一操作是：

- 自动检测本机装了哪些客户端，逐家注册 MCP、安装 Heedit Skill、挂批注 hooks；只增删 Heedit 自己的条目。
- 接入报告显示在“设置 › Connect”：每家的三项状态、送达档位与还需你做的步骤。
- 只接某一家：heedit install claude-code 或 heedit install codex；运行 heedit uninstall 可对称拆除。

```
heedit install
```

## 理解能力边界

内置直接设置目前覆盖 Claude Code 与 Codex。手动配置或文件工作流本身不代表已建立实时连接，也不允许静默读取任意文件。经由 Heedit 发起的正文请求仍走显式确认；Agent 在 Heedit 之外的文件权限由该 Agent 与操作系统另行控制。