接入 Claude Code
Windows 接入
方式一 · 驱动设置页修复（推荐）
打开驱动设置页，点击"预览并修复插件副本"，确认 Claude Code 脚本和用户级 hooks 后执行。修复会自动复制脚本、增量合并 settings.json，保留已有配置。
完成后重启 Claude Code，在 /hooks 中确认来源为 User。
方式二 · 让 Claude Code 自己配置
把下面的提示复制给 Claude Code：
text
帮我配置知言家 AI Coding 伴侣的 Claude Code Hook。读 https://zyhome.run/docs/integrations/claude-code.txt 按步骤执行；无法联网则读驱动 plugins\claude 中的模板。保留已有配置，冲突时先问我，不要整文件覆盖。完成后告诉我改了什么、是否需要重启。方式三 · 手动安装
模板目录：%LOCALAPPDATA%\zy_home_vibe_coding_driver\plugins\claude\（修改过安装目录的，把前缀替换为实际路径，如 D:\mydriver\plugins\claude\）
1. 复制脚本
把 zy-vibe-coding-driver.ps1 复制到 %USERPROFILE%\.claude\。
2. 配置 settings.json
目标：%USERPROFILE%\.claude\settings.json
文件不存在则直接从模板复制；已存在则增量合并以下 8 个事件：UserPromptSubmit、PermissionRequest、PermissionDenied、PreToolUse、PostToolUse、PostToolUseFailure、Stop、StopFailure。
每个 handler 必须满足：
- 显式设置
"shell": "powershell"（安装 Git for Windows 后默认 shell 会变成 Git Bash，不设会报语法错误） - 命令结构为"优先调用 hookbridge.exe，失败回退 PowerShell 脚本"，不要简化
- 只追加知言家的 handler，保留已有的 env、插件和自定义 hooks，不要写入项目级
.claude目录
3. 重启并信任
重启 Claude Code，执行 /hooks 确认驱动 Hook 来源为 User、核对命令路径。
4. 验证
发一条普通消息，确认驱动控制台出现 Claude Code 任务、设备灯效变化。
WSL 接入
Claude Code 安装在 WSL（Ubuntu） 里时，宿主侧的 PowerShell 脚本无法直接使用，需改用 bash 转发脚本，并先在宿主侧开启桥接。
WSL 前置检查（必看）
WSL 侧脚本通过网关 IP 访问宿主机驱动，需要宿主侧已开启 netsh portproxy 桥接（<WSL适配器IP>:25263 → 127.0.0.1:25263）。未开启时事件无法送达，见WSL 桥接配置。注意桥接监听地址须为 WSL 虚拟网卡 IP，不要用 0.0.0.0（0.0.0.0:25263 会与驱动的 127.0.0.1:25263 绑定冲突，导致驱动无法启动）。
让 Claude Code 自己配置
把下面的提示复制给 WSL 内的 Claude Code：
text
帮我配置知言家 AI Coding 伴侣的 WSL Claude Code Hook。读 https://zyhome.run/docs/integrations/claude-code.txt 的 WSL 部分按步骤执行；无法联网则读驱动 plugins\claude 中的模板。保留已有配置，冲突时先问我，不要整文件覆盖。完成后告诉我改了什么、是否需要重启。手动安装
把
zy-vibe-coding-driver-claude.sh复制到~/.claude/并加执行权限：bashchmod +x ~/.claude/zy-vibe-coding-driver-claude.sh增量合并
~/.claude/settings.json的 hooks 节点，保留已有的 env、插件和自定义 hooks。干跑验证：
bashZY_VIBE_CLAUDE_DRY_RUN=1 bash ~/.claude/zy-vibe-coding-driver-claude.sh UserPromptSubmit确认输出 source 为 claude。
重启 Claude Code，发一条普通消息验证灯效。