【免费下载链接】claude-code.elClaude Code Emacs integration项目地址https://gitcode.com/gh_mirrors/cl/claude-code.el点击查看免费下载claude-code.el是 Claude Code CLI 的 Emacs 集成包而它的Hook 事件系统是整个项目最有主动权的设计借助emacsclient回调机制Claude Code 能在关键节点主动敲醒Emacs——通知你该回复了、在动用工具前请你审批、改完文件后自动同步 buffer。本文面向新手用最少代码讲清这条回调链路并给出可直接上手的配置步骤与实战场景。为什么需要 Hook从被动提示到主动回调默认情况下claude-code.el 靠检测终端响铃bell来判断Claude 处理完了等你输入再弹出 minibuffer 消息并闪烁 modeline。这属于被动监测——你只能在 Emacs 这一侧猜测事件。而 Hook 是双向的事件settings.json 中的键触发时机典型玩法NotificationClaude 等待输入、有通知时桌面提醒、自动切回 Claude bufferStop一轮回复结束写日志、更新 org 任务状态PreToolUseClaude 准备调用工具编辑文件、执行命令等在 minibuffer 里做 y/n/q 权限审批PostToolUse工具执行完成后自动 revert / git 三方合并文件变更事件发生时CLI 会把事件数据以JSON 写入 stdin交给你在 settings.json 里登记的命令——这就是主动回调的起点。一张流程看懂 emacsclient 回调链路整条链路只有 5 步理解它比背配置更重要Claude Code CLI 触发事件将 JSON 数据通过 stdin 传给claude-code-hook-wrapper 事件名bin/claude-code-hook-wrapper 读取 JSON执行emacsclient --eval (claude-code-handle-hook type \$CLAUDE_BUFFER_NAME\) $jsonEmacs server 端执行 claude-code-handle-hook它把 JSON 和额外参数装进一个 plist 消息该消息被依次投递给 claude-code-event-hook 上注册的每个监听函数run-hook-with-args-until-success语义第一个返回非 nil 结果的处理器生效处理器若返回 JSON如权限决定wrapper 会剥掉 emacsclient 自动加的外层引号把干净 JSON 回传给 CLI直接影响 Claude 的后续行为。其中第 3 步依赖一个巧妙细节claude-code.el 启动 Claude 实例时会把当前 buffer 名写入子进程环境变量见 claude-code.el 中 CLAUDE_BUFFER_NAME 注入于是 shell 侧的 hook 总能通过$CLAUDE_BUFFER_NAME知道这个事件属于哪个 Emacs buffer。仓库克隆方式如尚未安装git clone https://gitcode.com/gh_mirrors/cl/claude-code.el四步完成 Hook 配置最快配置方法第 1 步把 bin 目录加入 PATHwrapper 脚本需要能被 CLI 的 shell 环境找到export PATH/path/to/claude-code.el/bin:$PATH写入~/.bashrc或~/.bash_profile。第 2 步启动 Emacs serveremacsclient要能连上你正在用的 Emacs;; init.el (start-server)第 3 步在~/.claude/settings.json注册 Hook可直接参考模板 examples/hooks/example_settings.json最小配置形如{ hooks: { Notification: [{ matcher: , hooks: [{ type: command, command: claude-code-hook-wrapper notification }] }], PreToolUse: [{ matcher: , hooks: [{ type: command, command: claude-code-hook-wrapper pre-tool-use }] }] } }四个事件Notification/Stop/PreToolUse/PostToolUse按需各加一条即可。第 4 步在 Emacs 端注册监听器监听函数只需接收一个 plist 消息并做你想做的事(defun my-claude-hook-listener (message) (let ((type (plist-get message :type)) (buffer (plist-get message :buffer-name))) (when (eq type notification) (message Claude 等待输入%s buffer) (ding)))) (add-hook claude-code-event-hook #my-claude-hook-listener)examples/hooks/目录里还有一份完整参考实现 claude-code-hook-examples.el含通知、工具监控、日志、org 集成等多个现成监听器配合 examples/hooks/README.md 说明使用。Hook 消息的 4 个字段每个监听函数拿到的 plist 消息结构固定见 claude-code-handle-hook 源码键含义:type事件类型如notification、pre-tool-use:buffer-name来源 Claude buffer来自$CLAUDE_BUFFER_NAME:json-dataCLI 发来的 JSON 载荷工具名、参数等:argssettings.json 命令里追加的额外参数列表:args给了你一个带外通道在 settings.json 命令里追加 shell 表达式比如claude-code-hook-wrapper notification $PWD $(date -Iseconds) $$监听器即可在:args里拿到工作目录、时间戳、进程号适合做富上下文日志。实战场景场景一把权限审批搬到 minibufferPreToolUse最出彩的用法。Claude 每次要用工具前你会在 minibuffer 看到格式化的 JSON 参数并收到Allow? (y/n/q):提问y→ 返回allow放行n→ 返回deny拒绝q / ESC→ 返回ask交还给 Claude 自己的权限对话框现成实现是 my-claude-pretooluse-handler它会先读取~/.claude/settings.json的permissions.allow白名单自动放行已授权工具只有陌生工具才弹窗避免每次都被打断。执行setup-claude-pretooluse-control即可启用以最高优先级挂入 hook 链。场景二Claude 改完文件buffer 自动同步PostToolUseClaude 直接改磁盘文件Emacs buffer 会过期。claude-code-auto-revert-hook.el 是一对精心设计的 Pre/Post 监听器Pre 阶段在 Claude 动手前自动保存你的未存修改并记录文件原始内容作为合并基线Post 阶段用git merge-file做三方合并基线 你的修改 Claude 的修改无冲突时 buffer 直接更新并保存也可切换为简单:revert策略。一行(setup-claude-auto-revert :git-merge t)完成注册setup-claude-auto-revert从此Claude 在改、你在看不再互相覆盖。场景三通知、日志与 org 任务my-claude-notification-listenerNotification/Stop 事件触发(ding) 提示并可自动显示 Claude buffermy-claude-session-listener把所有事件带时间戳追加到~/claude-hooks.log排障利器my-claude-org-listenerClaude 就绪时在 org 文件里自动生成带 buffer 名和 JSON 摘要的 TODO 条目。三者分别对应 通知监听器、会话日志、org 集成用setup-claude-hooks-advanced一键全部挂上。JSON 响应机制第一个非 nil 响应生效claude-code-event-hook采用run-hook-with-args-until-success语义源码多个监听器按注册顺序依次执行第一个返回非 nil 值的函数立即赢下本次事件其返回值作为 JSON 经 emacsclient 回传给 CLI因此审批类处理器要返回permissionDecision应挂在前面的高优先级位置日志类处理器返回 nil 则不影响链路。这正是 Emacs 能反向控制 Claude 的关键——不只是接收事件还能决定Claude 能不能用某个工具。常见排查清单症状原因与解决Emacs 完全收不到回调确认 Emacs 已执行(start-server)确认claude-code-hook-wrapper在 CLI 的 shell PATH 中新开终端验证which claude-code-hook-wrapperCLI 收到带引号的奇怪输出说明事件没经过 wrapper而是直接emacsclient --eval换用 wrapper 即可自动清洗已允许的工具仍弹窗已知限制permissions.allow中的工具也会触发 PreToolUse现成 handler 已内置白名单检查规避冗余弹窗想查看所有已注册监听器运行交互式命令list-claude-hooks实现关键文件导航文件作用claude-code.elclaude-code-handle-hook统一入口与事件消息构造bin/claude-code-hook-wrappershell 侧 emacsclient 调用与 JSON 清洗examples/hooks/example_settings.json四事件完整 settings.json 模板examples/hooks/claude-code-hook-examples.el通知/日志/org/权限审批监听器合集examples/hooks/claude-code-auto-revert-hook.elPre/Post 自动保存与 git 三方合并examples/hooks/README.mdHook 示例快速上手指南小结claude-code.el 的 Hook 事件系统用一条极简链路stdin JSON → wrapper → emacsclient → event-hook → JSON 回传打通了 Claude Code 与 Emacs 的双向通信Notification/Stop负责叫你回来PreToolUse把审批权交还给你PostToolUse让 buffer 永远与磁盘同步。四步配置、零额外依赖值得每个 Emacs Claude Code 用户花十分钟体验一次这种AI 主动敲门的工作流 赞分享【免费下载链接】claude-code.elClaude Code Emacs integration项目地址https://gitcode.com/gh_mirrors/cl/claude-code.el点击查看免费下载相关推荐Handsontable Hook 事件系统深度指南发布订阅总线、回调与中间件的完整实现解析Handsontable Hook 事件系统深度指南发布订阅总线、回调与中间件的完整实现解析 Handsontable 的 Hook钩子系统是贯穿 Cor前端UI组件三步跑通 UmiJS MPA 多页面应用一份完整实战指南三步跑通 UmiJS MPA 多页面应用一份完整实战指南 新建一个 UmiJS 多页面应用MPA项目时第一步不是写配置而是把目录摆对。这篇文章带你完整前端Web框架前端构建SSR路由微前端国际化Claude改文件不丢工作claude-code.el的auto-revert hook与git三方合并实战指南Claude改文件不丢工作claude code.el的auto revert hook与git三方合并实战指南 如果你在用 Emacs 配合 claude上一篇nghttp2 项目教程下一篇骆驼大乱斗文本生成在游戏内容创作中的创新应用创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
