拓冰网站定制 
Clawd on Desk 接入 Claude Code 教程自动注册 Hooks让像素螃蟹立刻开工【免费下载链接】clawd-on-deskA pixel desktop pet that watches Claude Code, Codex, Cursor other AI coding agents — so you dont have to.项目地址: https://gitcode.com/gh_mirrors/cl/clawd-on-deskClawd on Desk 是一款开源的像素风桌面宠物专为 AI 编码代理而生。它常驻在你的桌面上实时监视 Claude Code 等 AI 代理的每一次动作思考时冒泡泡、运行工具时敲键盘、任务完成时庆祝。而它和 Claude Code 的接入堪称零配置——启动应用的瞬间Hooks 就会自动注册到~/.claude/settings.json无需你手写任何配置像素螃蟹立刻开工。本教程将带你完成安装、理解自动注册机制、并快速排查常见问题。为什么 Claude Code 用户需要一个桌面监工用 Claude Code 跑长任务时你是否经常要切回终端看进度Clawd on Desk 把答案变得可视化实时状态感知你提交提示词 → 螃蟹冒思考泡泡工具开始执行 → 它切换成敲字动画子代理启动 → 戴耳机摇摆、2 个以上子代理则杂技抛球。权限气泡Claude Code 请求权限时桌面上直接弹出悬浮气泡一键 Allow / Deny不用切窗口。睡觉与唤醒60 秒无活动就犯困入睡鼠标一动立刻惊醒。多会话追踪多个 Claude Code 会话并行时独立追踪每一个会话的状态。一键安装步骤两种方式任选方式一下载预构建安装包推荐新手从项目 Releases 页面下载对应平台的最新安装包即可平台安装包Windows x64 / ARM64Clawd-on-Desk-Setup-version.exemacOS.dmgx64 与 arm64 均有Linux.AppImage或.deb安装后直接启动 Clawd就完成了一切——全新安装默认只启用 Claude Code 与 Codex 两个集成Claude Code 的 Hooks 会在启动时自动写入这就是标题所说的自动注册。方式二从源码运行适合贡献者与调试源码方式需要 Node.js 环境克隆仓库并启动git clone https://gitcode.com/gh_mirrors/cl/clawd-on-desk.git cd clawd-on-desk npm install npm start # 启动时自动注册 Claude Code 与 Codex Hooks自动注册 Hooks 是如何工作的这是 Clawd on Desk 与 Claude Code 集成最核心的部分核心逻辑在 hooks/install.js 中钩子事件处理器在 hooks/clawd-hook.js 中。第一步把钩子命令合并进 Claude Code 配置Clawd 会安全地把命令追加而不是覆盖到~/.claude/settings.json的hooks数组中已注册的 11 个核心事件覆盖整个会话生命周期事件触发时机螃蟹的反应SessionStart/SessionEnd会话开始 / 结束唤醒 / 回到空闲UserPromptSubmit你提交提示词 思考泡泡PreToolUse/PostToolUse工具调用前后⌨️ 敲字动画Stop一轮任务完成 开心庆祝SubagentStart/SubagentStop子代理启停 摇摆 / 杂耍NotificationClaude 发出通知 提醒姿态Elicitation/PostToolUseFailure提问 / 工具失败提问卡片 / 报错姿态如果你的 Claude Code 版本 ≥ 2.1.76还会额外注册PreCompact、PostCompact≥ 2.1.78 则加上StopFailure。版本探测失败时会自动回退到核心钩子并清理过期的版本化钩子。第二步权限请求走本地 HTTP 通道权限请求PermissionRequest不走命令钩子而是通过 Clawd 本地回环服务127.0.0.1:23333-23337以阻塞式 HTTP 方式处理——这样螃蟹才能在气泡上真正拦截请求等你点完 Allow/Deny 再放行给 Claude Code。第三步每 5 分钟一次只读健康检查Clawd 还会持续监视钩子是否还活着即使settings.json没变只要钩子脚本被系统清理例如 Windows 的 Temp 目录被清空它也能发现并自动修复同一问题连续 3 次修不好才会在 Doctor 面板提示你手动修复绝不盲目乱改配置。权限气泡不切窗口批准 Claude Code 请求当 Claude Code 弹出权限询问比如执行 Bash 命令前时Clawd 会在屏幕右下角堆叠弹出气泡卡片你可以点击Allow直接批准或Deny拒绝用全局快捷键CtrlShiftY批准、CtrlShiftN拒绝最新一条如果你先回到终端里回答了气泡会自动消失两边永不冲突在Settings → Agents中可以随时关闭某个代理的气泡把权限交还给终端。更进一步的自动化每次询问 / 仅工具提示 / 自动批准三种模式见官方设置指南 docs/guides/setup-guide.md。常见问题排查Q启动后螃蟹对 Claude Code 毫无反应先确认~/.claude/settings.json中是否存在hooks配置再打开 Clawd 的 Doctor 面板检查钩子健康状态。注意 WSL 场景下若 Claude Code 跑在 WSL 内钩子需要在 WSL 的家目录里单独注册一次详见设置指南的 WSL 章节。Q我自定义了 Claude Code 的 statusline会被覆盖吗不会。本地的 Claude 用量采集默认关闭且 Clawd 从不静默替换你已有的自定义 status line开启时它走的是 Claude Code 官方文档化的 status-line 扩展机制不发起任何额外 API 请求。Q卸载 Clawd 会破坏我的 Claude Code 配置吗不会。卸载只移除 Clawd 自己标记管理的条目你手动添加的其他 hooks 原样保留。还能做什么多代理与远程 SSHClaude Code 只是起点。Clawd 支持 20 余种 AI 代理Codex、Cursor、Gemini、Copilot、Qwen 等同时运行、独立追踪完整对照表见 docs/guides/state-mapping.md。如果你把 Claude Code 跑在远程服务器上Clawd 还支持通过 SSH 反向隧道把状态与权限气泡搬回本地桌面——在Settings → Remote SSH中部署钩子即可完整流程见 docs/guides/guide-remote-ssh.md。总结Clawd on Desk 接入 Claude Code 的关键就三点启动即自动注册 Hooks无需手写配置、权限走本地 HTTP 气泡不切窗口一键批准、健康检查自动修复配置不怕被清理。装好启动你的像素螃蟹监工就已经开始上班了——下次跑长任务时放心走开螃蟹会喊你回来。【免费下载链接】clawd-on-deskA pixel desktop pet that watches Claude Code, Codex, Cursor other AI coding agents — so you dont have to.项目地址: https://gitcode.com/gh_mirrors/cl/clawd-on-desk创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 Clawd on Desk 接入 Claude Code 教程：自动注册 Hooks，让像素螃蟹立刻开工
Clawd on Desk 接入 Claude Code 教程自动注册 Hooks让像素螃蟹立刻开工【免费下载链接】clawd-on-deskA pixel desktop pet that watches Claude Code, Codex, Cursor other AI coding agents — so you dont have to.项目地址: https://gitcode.com/gh_mirrors/cl/clawd-on-deskClawd on Desk 是一款开源的像素风桌面宠物专为 AI 编码代理而生。它常驻在你的桌面上实时监视 Claude Code 等 AI 代理的每一次动作思考时冒泡泡、运行工具时敲键盘、任务完成时庆祝。而它和 Claude Code 的接入堪称零配置——启动应用的瞬间Hooks 就会自动注册到~/.claude/settings.json无需你手写任何配置像素螃蟹立刻开工。本教程将带你完成安装、理解自动注册机制、并快速排查常见问题。为什么 Claude Code 用户需要一个桌面监工用 Claude Code 跑长任务时你是否经常要切回终端看进度Clawd on Desk 把答案变得可视化实时状态感知你提交提示词 → 螃蟹冒思考泡泡工具开始执行 → 它切换成敲字动画子代理启动 → 戴耳机摇摆、2 个以上子代理则杂技抛球。权限气泡Claude Code 请求权限时桌面上直接弹出悬浮气泡一键 Allow / Deny不用切窗口。睡觉与唤醒60 秒无活动就犯困入睡鼠标一动立刻惊醒。多会话追踪多个 Claude Code 会话并行时独立追踪每一个会话的状态。一键安装步骤两种方式任选方式一下载预构建安装包推荐新手从项目 Releases 页面下载对应平台的最新安装包即可平台安装包Windows x64 / ARM64Clawd-on-Desk-Setup-version.exemacOS.dmgx64 与 arm64 均有Linux.AppImage或.deb安装后直接启动 Clawd就完成了一切——全新安装默认只启用 Claude Code 与 Codex 两个集成Claude Code 的 Hooks 会在启动时自动写入这就是标题所说的自动注册。方式二从源码运行适合贡献者与调试源码方式需要 Node.js 环境克隆仓库并启动git clone https://gitcode.com/gh_mirrors/cl/clawd-on-desk.git cd clawd-on-desk npm install npm start # 启动时自动注册 Claude Code 与 Codex Hooks自动注册 Hooks 是如何工作的这是 Clawd on Desk 与 Claude Code 集成最核心的部分核心逻辑在 hooks/install.js 中钩子事件处理器在 hooks/clawd-hook.js 中。第一步把钩子命令合并进 Claude Code 配置Clawd 会安全地把命令追加而不是覆盖到~/.claude/settings.json的hooks数组中已注册的 11 个核心事件覆盖整个会话生命周期事件触发时机螃蟹的反应SessionStart/SessionEnd会话开始 / 结束唤醒 / 回到空闲UserPromptSubmit你提交提示词 思考泡泡PreToolUse/PostToolUse工具调用前后⌨️ 敲字动画Stop一轮任务完成 开心庆祝SubagentStart/SubagentStop子代理启停 摇摆 / 杂耍NotificationClaude 发出通知 提醒姿态Elicitation/PostToolUseFailure提问 / 工具失败提问卡片 / 报错姿态如果你的 Claude Code 版本 ≥ 2.1.76还会额外注册PreCompact、PostCompact≥ 2.1.78 则加上StopFailure。版本探测失败时会自动回退到核心钩子并清理过期的版本化钩子。第二步权限请求走本地 HTTP 通道权限请求PermissionRequest不走命令钩子而是通过 Clawd 本地回环服务127.0.0.1:23333-23337以阻塞式 HTTP 方式处理——这样螃蟹才能在气泡上真正拦截请求等你点完 Allow/Deny 再放行给 Claude Code。第三步每 5 分钟一次只读健康检查Clawd 还会持续监视钩子是否还活着即使settings.json没变只要钩子脚本被系统清理例如 Windows 的 Temp 目录被清空它也能发现并自动修复同一问题连续 3 次修不好才会在 Doctor 面板提示你手动修复绝不盲目乱改配置。权限气泡不切窗口批准 Claude Code 请求当 Claude Code 弹出权限询问比如执行 Bash 命令前时Clawd 会在屏幕右下角堆叠弹出气泡卡片你可以点击Allow直接批准或Deny拒绝用全局快捷键CtrlShiftY批准、CtrlShiftN拒绝最新一条如果你先回到终端里回答了气泡会自动消失两边永不冲突在Settings → Agents中可以随时关闭某个代理的气泡把权限交还给终端。更进一步的自动化每次询问 / 仅工具提示 / 自动批准三种模式见官方设置指南 docs/guides/setup-guide.md。常见问题排查Q启动后螃蟹对 Claude Code 毫无反应先确认~/.claude/settings.json中是否存在hooks配置再打开 Clawd 的 Doctor 面板检查钩子健康状态。注意 WSL 场景下若 Claude Code 跑在 WSL 内钩子需要在 WSL 的家目录里单独注册一次详见设置指南的 WSL 章节。Q我自定义了 Claude Code 的 statusline会被覆盖吗不会。本地的 Claude 用量采集默认关闭且 Clawd 从不静默替换你已有的自定义 status line开启时它走的是 Claude Code 官方文档化的 status-line 扩展机制不发起任何额外 API 请求。Q卸载 Clawd 会破坏我的 Claude Code 配置吗不会。卸载只移除 Clawd 自己标记管理的条目你手动添加的其他 hooks 原样保留。还能做什么多代理与远程 SSHClaude Code 只是起点。Clawd 支持 20 余种 AI 代理Codex、Cursor、Gemini、Copilot、Qwen 等同时运行、独立追踪完整对照表见 docs/guides/state-mapping.md。如果你把 Claude Code 跑在远程服务器上Clawd 还支持通过 SSH 反向隧道把状态与权限气泡搬回本地桌面——在Settings → Remote SSH中部署钩子即可完整流程见 docs/guides/guide-remote-ssh.md。总结Clawd on Desk 接入 Claude Code 的关键就三点启动即自动注册 Hooks无需手写配置、权限走本地 HTTP 气泡不切窗口一键批准、健康检查自动修复配置不怕被清理。装好启动你的像素螃蟹监工就已经开始上班了——下次跑长任务时放心走开螃蟹会喊你回来。【免费下载链接】clawd-on-deskA pixel desktop pet that watches Claude Code, Codex, Cursor other AI coding agents — so you dont have to.项目地址: https://gitcode.com/gh_mirrors/cl/clawd-on-desk创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考