#+TITLE: Emacs 的 Claude Code IDE #+AUTHOR: Yoav Orot #+EMAIL: orot.yoav@gmail.com #+DESCRIPTION: Emacs 的 Claude Code 集成 #+KEYWORDS: emacs, claude, ai, code-assistant #+OPTIONS: toc:t num:nil

[[https://github.com/manzaltu/claude-code-ide.el/actions/workflows/test.yml][file:https://github.com/manzaltu/claude-code-ide.el/workflows/CI/badge.svg]] [[https://www.gnu.org/software/emacs/][file:https://img.shields.io/badge/GNU%20Emacs-28--30-blueviolet.svg]] [[https://www.gnu.org/licenses/gpl-3.0][file:https://img.shields.io/badge/License-GPL%20v3-blue.svg]]

• 概述

Emacs 的 Claude Code IDE 通过模型上下文协议 (Model Context Protocol, MCP) 提供与 Claude Code CLI 的原生集成。与简单的终端包装器不同，此软件包在 Claude 和 Emacs 之间创建了一个双向桥梁，使 Claude 能够理解并利用 Emacs 的强大功能——从语言服务器协议 (LSP) 和项目管理和自定义 Elisp 函数。这将 Claude 转变为真正的 Emacs 感知 AI 助手，它可以在您现有的工作流程中工作，并与您的整个 Emacs 生态系统进行交互。

** 功能

• 自动项目检测和会话管理
• 使用 =vterm= 或 =eat= 的全彩支持终端集成
• 用于 IDE 集成的 MCP 协议实现
• 支持文件操作、编辑器状态和工作区信息的工具支持
• 可扩展的 MCP 工具服务器，用于访问 Emacs 命令（如 xrefs、tree-sitter、项目信息等）
• 与 Flycheck 和 Flymake 的诊断集成
• 带有 ediff 集成的高级差异视图（应用前修改建议）
• 用于正确上下文切换的标签栏支持
• 选择和缓冲区跟踪以提供更好的上下文感知

** Emacs 工具集成

此软件包使 Claude Code 能够通过 MCP 工具集成利用 Emacs 的全部功能。Claude 可以直接访问和利用 Emacs 的功能，包括：

• 通过 xref 命令的*语言服务器协议 (Language Server Protocol, LSP)*集成，用于智能代码导航（eglot, lsp-mode 等）
• Tree-sitter用于语法树分析，并在抽象语法树 (AST) 级别理解代码结构
• Imenu用于结构化符号列表和文件内导航
• Project集成用于感知项目的操作
• 任何 Emacs 命令或函数都可以作为 MCP 工具暴露，允许 Claude：
  • 执行项目范围的搜索和重构
  • 访问专用模式及其功能
  • 执行针对您工作流程定制的自定义 Elisp 函数

这种深度集成意味着 Claude Code 了解您的项目上下文，并可以利用 Emacs 广泛的生态系统来提供更智能和上下文感知的辅助。

** 截图

*** 活动文件感知 #+CAPTION: Claude Code 自动知道您在 Emacs 中当前查看的文件 #+html: #+html:

Claude Code 自动知道您在 Emacs 中当前查看的文件

*** 代码选择上下文 #+CAPTION: Claude Code 可以访问和处理缓冲区中的选定文本 #+html: #+html:

Claude Code 可以访问和处理缓冲区中的选定文本

*** 带诊断的高级差异视图 #+CAPTION: 用于代码更改的集成 ediff 视图，Claude Code 能够直接访问打开文件中的诊断数据（错误、警告等） #+html: #+html:

用于代码更改的集成 ediff 视图，Claude Code 能够直接访问打开文件中的诊断数据（错误、警告等）

*** 自动文本提及 #+CAPTION: 在 Claude 对话中自动提及和引用选定的文本 #+html: #+html:

在 Claude 对话中自动提及和引用选定的文本

*** 会话恢复 #+CAPTION: 使用 --resume 标志恢复之前的 Claude Code 对话 #+html: #+html:

使用 --resume 标志恢复之前的 Claude Code 对话

• 安装

** 前置条件

• Emacs 28.1 或更高版本
• 已安装 Claude Code CLI 并可从 PATH 访问
• =vterm= 或 =eat= 软件包（用于终端支持）

** 安装 Claude Code CLI

请遵循 [[https://docs.anthropic.com/en/docs/claude-code][Claude Code 文档]] 中的安装说明。

** 安装 Emacs 软件包

目前，该软件包处于早期开发阶段。

要使用 =emacs-version= >= 30 和 =use-package= 配合 =vc= 绑定进行安装：

#+begin_src elisp (use-package claude-code-ide :vc (:url "https://github.com/manzaltu/claude-code-ide.el" :rev :newest) :bind ("C-c C-'" . claude-code-ide-menu) ; 设置您喜欢的快捷键 :config (claude-code-ide-emacs-tools-setup)) ; 可选地启用 Emacs MCP 工具 #+end_src

要使用 =use-package= 和 [[https://github.com/raxod502/straight.el][straight.el]] 进行安装：

#+begin_src emacs-lisp (use-package claude-code-ide :straight (:type git :host github :repo "manzaltu/claude-code-ide.el") :bind ("C-c C-'" . claude-code-ide-menu) ; 设置您喜欢的快捷键 :config (claude-code-ide-emacs-tools-setup)) ; 可选地启用 Emacs MCP 工具 #+end_src

*** Doom Emacs

在 =packages.el= 中：

#+begin_src emacs-lisp (package! claude-code-ide :recipe (:host github :repo "manzaltu/claude-code-ide.el")) #+end_src

在 =config.el= 中： #+begin_src emacs-lisp (use-package! claude-code-ide :bind ("C-c C-'" . claude-code-ide-menu) ; 设置您喜欢的快捷键 :config (claude-code-ide-emacs-tools-setup)) ; 可选地启用 Emacs MCP 工具 #+end_src

保存上述内容后，在终端运行：=doom sync=。

• 使用

** 基本命令

与 Claude Code IDE 交互的最简单方法是通过瞬态菜单界面，它提供对所有可用命令的视觉访问。只需运行 =M-x claude-code-ide-menu= 即可打开交互式菜单。

| Command | Description | |-----------------------------------------+---------------------------------------------------| | =M-x claude-code-ide-menu= | 打开包含所有 Claude Code 命令的临时菜单 | | =M-x claude-code-ide-emacs-tools-setup= | 设置内置 MCP（模型上下文协议）工具（例如 xref（交叉引用）、project） | | =M-x claude-code-ide= | 为当前项目启动 Claude Code | | =M-x claude-code-ide-send-prompt= | 从 minibuffer（小缓冲区）输入向 Claude 发送提示词 | | =M-x claude-code-ide-continue= | 继续目录中最近的一次对话 | | =M-x claude-code-ide-resume= | 使用之前的对话恢复 Claude Code | | =M-x claude-code-ide-stop= | 停止当前项目的 Claude Code | | =M-x claude-code-ide-switch-to-buffer= | 切换到项目的 Claude buffer（缓冲区） | | =M-x claude-code-ide-list-sessions= | 列出所有活跃的 Claude Code 会话并切换 | | =M-x claude-code-ide-check-status= | 检查 Claude Code CLI（命令行接口）是否已安装并正常工作 | | =M-x claude-code-ide-insert-at-mentioned=| 将选中的文本发送到 Claude 提示词 | | =M-x claude-code-ide-send-escape= | 向 Claude 终端发送 Escape 键 | | =M-x claude-code-ide-insert-newline= | 在 Claude 提示词中插入换行符（发送 \ + Enter） | | =M-x claude-code-ide-toggle= | 切换 Claude Code 窗口的可见性 | | =M-x claude-code-ide-toggle-recent= | 全局切换最近的 Claude 窗口 | | =M-x claude-code-ide-show-debug= | 显示包含 WebSocket（Web 套接字）消息的调试 buffer（缓冲区） | | =M-x claude-code-ide-clear-debug= | 清除调试 buffer（缓冲区） |

** 多项目支持

Claude Code IDE 利用 Emacs 内置的 =project.el= 自动检测您的项目。每个项目都会获得一个独立的 Claude Code 实例，拥有唯一的 buffer（缓冲区）名称，例如 =claude-code[project-name]=。

您可以为不同的项目同时运行多个 Claude Code 实例。使用 =claude-code-ide-list-sessions= 查看所有活跃会话并在它们之间切换。

** 窗口管理

• 当会话已经活跃时运行 =claude-code-ide= 将切换窗口可见性
• 可以使用标准的 Emacs 窗口命令 (=C-x 0=) 关闭窗口而无需停止 Claude
• 使用 =claude-code-ide-toggle-recent= 可以从任何地方切换最近的 Claude 窗口，无论您当前的项目上下文如何。当您不在项目目录下但想要快速隐藏/显示 Claude 时，这非常有用

** 使用 Ediff 查看差异

当启用 =claude-code-ide-use-ide-diff=（默认）时，Claude 的代码建议将通过 Emacs 强大的 =ediff=（Emacs 差异对比工具）界面显示。这提供了两个关键优势：

1. 视觉差异比较 - 通过并排或统一差异视图查看 Claude 想要更改的确切内容
2. 交互式编辑 - 您可以在应用之前修改 Claude 的建议

*** 如何使用 ediff:

1. 当 Claude 建议代码更改时，=ediff= 会自动打开
2. ediff 控制 buffer（缓冲区）变为活动状态（一个带有 ediff 命令的小窗口）
3. Buffer A 显示当前代码，Buffer B 显示 Claude 的建议
4. 您可以修改 Buffer B 以完善 Claude 提议的更改
5. 在 ediff 控制 buffer（缓冲区）中按 =q= 退出
6. 当被提示时，选择是否接受更改 (=y= 或 =n=)
7. 如果您接受 (=y=)，来自 Buffer B 的任何更改将被发送回 Claude 以应用于原始文件

这允许您在应用之前完善 Claude 的建议，确保最终代码符合您的确切要求。

** 配置

*** 配置变量

| Variable | Description | Default | |-----------------------------------------------+---------------------------------------------+--------------------------------------| | claude-code-ide-cli-path | Claude Code CLI (命令行接口) 路径 | "claude" | | claude-code-ide-buffer-name-function | 缓冲区命名函数 | claude-code-ide--default-buffer-name | | claude-code-ide-cli-debug | 启用 CLI 调试模式（-d 标志） | nil | | claude-code-ide-cli-extra-flags | 其他 CLI 标志（例如 "--model"） | "" | | claude-code-ide-debug | 启用调试日志记录 | nil | | claude-code-ide-terminal-backend | 终端后端（vterm 或 eat） | 'vterm | | claude-code-ide-vterm-anti-flicker | 启用 vterm 闪烁减少功能 | t | | claude-code-ide-vterm-render-delay | vterm 渲染批处理延迟（秒） | 0.005 | | claude-code-ide-terminal-initialization-delay | 终端初始化延迟 | 0.1 | | claude-code-ide-log-with-context | 在日志消息中包含会话上下文 | t | | claude-code-ide-debug-buffer | 调试输出缓冲区名称 | "claude-code-ide-debug" | | claude-code-ide-use-side-window | 使用侧边窗口还是普通缓冲区 | t | | claude-code-ide-window-side | Claude 窗口所在侧 | 'right | | claude-code-ide-window-width | 侧边窗口宽度（左/右） | 90 | | claude-code-ide-window-height | 侧边窗口高度（上/下） | 20 | | claude-code-ide-focus-on-open | 打开时聚焦 Claude 窗口 | t | | claude-code-ide-focus-claude-after-ediff | 打开 ediff (差异比较工具) 后聚焦 Claude 窗口 | t | | claude-code-ide-show-claude-window-in-ediff | ediff 期间显示 Claude 窗口 | t | | claude-code-ide-use-ide-diff | 使用 IDE 差异查看器而非终端 | t | | claude-code-ide-switch-tab-on-ediff | 打开 ediff 时切换到 Claude 标签页 | t | | claude-code-ide-system-prompt | 要追加的自定义系统提示词 | nil | | claude-code-ide-enable-mcp-server | 启用 MCP (模型上下文协议) 工具服务器 | nil | | claude-code-ide-mcp-server-port | MCP 工具服务器端口 | nil (自动选择) | | claude-code-ide-mcp-server-tools | 暴露的 Emacs 函数列表 | nil | | claude-code-ide-diagnostics-backend | 诊断后端（自动/flycheck/flymake） | 'auto | | claude-code-ide-prevent-reflow-glitch | 防止终端重排故障（问题 #1422） | t |

*** 侧边窗口配置

Claude Code 缓冲区默认在侧边窗口中打开。您可以自定义其位置：

#+begin_src emacs-lisp ;; Open Claude on the left side (setq claude-code-ide-window-side 'left)

;; Open Claude at the bottom with custom height (setq claude-code-ide-window-side 'bottom claude-code-ide-window-height 30)

;; Open Claude on the right with custom width (setq claude-code-ide-window-side 'right claude-code-ide-window-width 100)

;; Don't automatically focus the Claude window (setq claude-code-ide-focus-on-open nil)

;; Keep focus on ediff control window when opening diffs (setq claude-code-ide-focus-claude-after-ediff nil)

;; Hide Claude window during ediff for more screen space (setq claude-code-ide-show-claude-window-in-ediff nil)

;; Disable IDE diff viewer to show diffs in terminal instead (setq claude-code-ide-use-ide-diff nil) #+end_src

或者，如果您更喜欢使用普通窗口：

#+begin_src emacs-lisp ;; Use regular window instead of side window (setq claude-code-ide-use-side-window nil) #+end_src

*** 终端后端配置

Claude Code IDE 支持将 =vterm= 和 =eat= 作为终端后端。默认情况下使用 =vterm=，但如果您偏好，可以切换到 =eat=：

#+begin_src emacs-lisp ;; Use eat instead of vterm (setq claude-code-ide-terminal-backend 'eat)

;; Or switch back to vterm (default) (setq claude-code-ide-terminal-backend 'vterm) #+end_src

=eat= 后端是一个纯 Elisp (Emacs Lisp) 终端模拟器，在某些 =vterm= 编译存在问题的环境中可能表现更好。两个后端均提供完整的终端功能，包括颜色支持和特殊按键处理。

**** vterm 渲染优化

Claude Code IDE 包含针对 vterm 终端的智能闪烁减少功能，以提供更流畅的视觉输出：

#+begin_src emacs-lisp ;; Enable/disable vterm anti-flicker optimization (enabled by default) (setq claude-code-ide-vterm-anti-flicker t)

;; Adjust the render delay for batching updates (default is 0.005 seconds) (setq claude-code-ide-vterm-render-delay 0.01) ; Increase for smoother but less responsive #+end_src

此优化会检测快速的终端重绘序列（例如当 Claude 扩展文本区域时），并将它们批处理以实现更流畅的渲染。5ms 的默认延迟提供了最佳的视觉效果且延迟不可感知。

**** 终端初始化延迟

Claude Code IDE 在启动终端时包含短暂的初始化延迟，以确保正确的布局渲染：

#+begin_src emacs-lisp ;; Adjust the terminal initialization delay (default is 0.1 seconds) (setq claude-code-ide-terminal-initialization-delay 0.15)

;; Or disable it entirely (may cause visual glitches) (setq claude-code-ide-terminal-initialization-delay 0) #+end_src

此延迟可防止显示伪影，例如终端模拟初始化时可能出现的提示符未对齐和光标定位错误。默认的 100ms 延迟是不可感知的，但能确保可靠的终端启动。

**** 终端快捷键绑定

Claude Code IDE 为终端添加了自定义快捷键，以便更轻松地交互：

| 快捷键 | 命令 | 描述 | |--------+--------------------------------------+--------------------------------| | =M-RET= | =claude-code-ide-insert-newline= | 在提示符中插入换行 | | =C-= | =claude-code-ide-send-escape= | 发送 Escape 键以取消操作 |

这些快捷键会自动为 =vterm= 和 =eat= 后端设置，并且仅适用于 Claude Code 终端缓冲区。

**** 终端重排故障预防（临时）

Claude Code IDE 包含一个针对已知 Claude Code 错误 ([[https://github.com/anthropics/claude-code/issues/1422][#1422]]) 的临时解决方案，该错误会导致窗口调整大小时终端重排引起不可控的滚动。此解决方案默认启用，但如有需要可禁用：

#+begin_src emacs-lisp ;; Disable the terminal reflow glitch prevention (not recommended until bug is fixed) (setq claude-code-ide-prevent-reflow-glitch nil) #+end_src

一旦上游错误修复，此解决方案将被移除。

*** 诊断配置

Claude Code IDE 支持使用 Flycheck 和 Flymake 进行代码诊断。默认情况下，它会自动检测哪一个处于激活状态：

#+begin_src emacs-lisp ;; Let Claude Code automatically detect the active diagnostics backend (setq claude-code-ide-diagnostics-backend 'auto) ; default

;; Or force a specific backend (setq claude-code-ide-diagnostics-backend 'flycheck) (setq claude-code-ide-diagnostics-backend 'flymake) #+end_src

*** 自定义缓冲区命名

您可以自定义 Claude Code 缓冲区的命名方式：

#+begin_src emacs-lisp (setq claude-code-ide-buffer-name-function (lambda (directory) (if directory (format "Claude:%s" (file-name-nondirectory (directory-file-name directory))) "Claude:Global"))) #+end_src

*** 自定义 CLI 标志

您可以向 Claude Code CLI (命令行界面) 传递额外的标志：

#+begin_src emacs-lisp ;; Use a specific model (setq claude-code-ide-cli-extra-flags "--model opus")

;; Pass multiple flags (setq claude-code-ide-cli-extra-flags "--model opus --no-cache")

;; Flags are added to all Claude Code sessions #+end_src

注意：这些标志会追加到 Claude 命令之后，位于任何内置标志（如 =-d= (调试) 或 =-r= (恢复)）之后。

*** 自定义系统提示词

您可以将自定义系统提示词附加到 Claude 的默认提示词中，从而针对特定项目或上下文自定义 Claude 的行为：

#+begin_src emacs-lisp ;; Set a custom system prompt (setq claude-code-ide-system-prompt "You are an expert in Elisp and Emacs development.")

;; Or configure it per-project using dir-locals.el ;; In .dir-locals.el: ((nil . ((claude-code-ide-system-prompt . "Focus on functional programming patterns and avoid mutations."))))

;; Set via the transient menu: M-x claude-code-ide-menu → Configuration → Set system prompt #+end_src

设置后，这会将 =--append-system-prompt= 标志添加到 Claude 命令中。设置为 =nil= 以禁用（默认）。

*** 调试

**** Claude CLI 调试模式

要启用 Claude Code CLI 的调试模式（传递 =-d= 标志）：

#+begin_src emacs-lisp (setq claude-code-ide-cli-debug t) #+end_src

**** Emacs 调试日志记录

要在 Emacs 内启用调试日志记录（记录 WebSocket 消息和 JSON-RPC 通信）：

#+begin_src emacs-lisp (setq claude-code-ide-debug t) #+end_src

然后使用以下命令查看调试日志：

• =M-x claude-code-ide-show-debug= - 显示调试缓冲区
• =M-x claude-code-ide-clear-debug= - 清除调试缓冲区

调试缓冲区显示：

• WebSocket 连接事件
• 所有 JSON-RPC 消息（请求/响应）
• 错误消息和诊断信息
• 带有会话上下文的通用调试信息

** 单个项目上的多个 Claude Code 实例

使用 git worktrees (git 工作树) 是在同一项目的不同分支上运行多个 Claude Code 实例的推荐方式。这允许您并行开发功能或修复错误：

#+begin_src bash

为功能分支创建新的 worktree (工作树)

git worktree add ../myproject-worktree feature-branch #+end_src

#+begin_src elisp ;; Start Claude Code in the main project find-file /path/to/myproject M-x claude-code-ide

;; Start another Claude Code instance in the worktree find-file /path/to/myproject-worktree M-x claude-code-ide #+end_src

每个 worktree (工作树) 都被 =project.el= 视为独立的项目，允许您拥有独立的 Claude Code 会话，并拥有各自的缓冲区（例如 =claude-code[myproject]= 和 =claude-code[myproject-worktree]=）。

** Emacs MCP (Model Context Protocol) 工具

Claude Code IDE 包含内置的 MCP 工具，将 Emacs 功能暴露给 Claude，从而实现强大的代码导航和分析能力：

*** 内置工具

• =xref-find-references= - 查找项目中符号的所有引用
• =xref-find-apropos= - 在整个项目中查找匹配模式的符号
• =treesit-info= - 获取 tree-sitter 语法树信息以进行深层代码结构分析
• =imenu-list-symbols= - 使用 imenu 列出文件中所有符号（函数、类、变量）
• =project-info= - 获取当前项目信息（目录、文件等）

*** 启用 MCP 工具

要启用这些工具，请将以下内容添加到您的配置中：

#+begin_src emacs-lisp ;; Set up the built-in Emacs tools (claude-code-ide-emacs-tools-setup) #+end_src

启用后，Claude 可以使用这些工具来浏览您的代码库。例如：

• "查找函数 foo 的定义"
• "显示此变量使用的所有位置"
• "光标下的 AST (抽象语法树) 节点是什么类型？"
• "分析整个文件的解析树"
• "列出此文件中的所有函数和变量"
• "此项目中有多少文件？"

** 创建自定义 MCP 工具

您可以通过 MCP 工具系统将自己的 Emacs 函数暴露给 Claude。这允许 Claude 与专门的 Emacs 功能、自定义命令或特定领域的功能进行交互。

*** 工具定义格式

使用 =claude-code-ide-make-tool= 函数定义工具：

#+begin_src emacs-lisp (claude-code-ide-make-tool :function #'function-name ; The Emacs function to call :name "tool_name" ; Name for Claude to use (snake_case recommended) :description "..." ; Human-readable description :args '((:name "param1" ; List of argument specifications :type string ; Type: string, number, integer, boolean, etc. :description "..." ; What this parameter does :optional t))) ; Optional parameters marked with :optional t #+end_src

可用的参数类型：=string=, =number=, =integer=, =boolean=, =array=, =object=, =null=

*** 上下文感知工具示例

#+begin_src emacs-lisp ;; Define a context-aware function that operates in the session's project (defun my-project-grep (pattern) "Search for PATTERN in the current session's project." (claude-code-ide-mcp-server-with-session-context nil ;; This executes with the session's project directory as default-directory (let* ((project-dir default-directory) (results (shell-command-to-string (format "rg -n '%s' %s" pattern project-dir)))) results)))

;; Define and register the tool (automatically added to claude-code-ide-mcp-server-tools) (claude-code-ide-make-tool :function #'my-project-grep :name "my_project_grep" :description "Search for pattern in project files" :args '((:name "pattern" :type string :description "Pattern to search for")))

;; Enable Emacs tool MCP server (claude-code-ide-emacs-tools-setup) #+end_src

=claude-code-ide-mcp-server-with-session-context= 宏确保您的工具在正确的项目上下文中执行。

• 许可证

本项目采用 GNU 通用公共许可证 v3.0 或更高版本授权。有关详细信息，请参阅 LICENSE 文件。

• 商标声明

Claude® 是 Anthropic, PBC 的注册商标。Claude Code 是由 Anthropic, PBC 开发的应用程序。

• 相关项目

• [[https://docs.anthropic.com/en/docs/claude-code][Claude Code CLI]]
• [[https://github.com/anthropics/claude-code][Claude Code VS Code 扩展]]
• [[https://github.com/coder/claudecode.nvim][claudecode.nvim]] - Neovim 集成

claude-code-ide.el 快速上手指南

claude-code-ide.el 是一款专为 Emacs 设计的 Claude Code 集成工具。它通过模型上下文协议（MCP）在 Claude 与 Emacs 之间建立双向桥梁，使 Claude 能够理解并利用 LSP、项目管理和自定义 Elisp 函数等 Emacs 强大功能，成为真正的 Emacs 感知型 AI 助手。

环境准备

在开始之前，请确保您的系统满足以下要求：

• Emacs 版本：28.1 或更高版本
• Claude Code CLI：已安装并配置到系统 PATH 中
  • 安装说明请参考 Anthropic 官方文档
• 终端后端：需安装 vterm 或 eat 包以支持终端功能

安装步骤

根据您的 Emacs 配置方式，选择以下一种方法进行安装。

方法一：使用 use-package (Emacs 30+)

适用于原生 use-package 且版本较新的用户：

(use-package claude-code-ide
  :vc (:url "https://github.com/manzaltu/claude-code-ide.el" :rev :newest)
  :bind ("C-c C-'" . claude-code-ide-menu) ; 设置您喜欢的快捷键
  :config
  (claude-code-ide-emacs-tools-setup)) ; 可选：启用 Emacs MCP 工具

方法二：使用 straight.el

如果您使用 straight.el 管理包：

(use-package claude-code-ide
  :straight (:type git :host github :repo "manzaltu/claude-code-ide.el")
  :bind ("C-c C-'" . claude-code-ide-menu)
  :config
  (claude-code-ide-emacs-tools-setup))

方法三：Doom Emacs

在 packages.el 中添加：

(package! claude-code-ide
  :recipe (:host github :repo "manzaltu/claude-code-ide.el"))

在 config.el 中添加：

(use-package! claude-code-ide
  :bind ("C-c C-'" . claude-code-ide-menu)
  :config
  (claude-code-ide-emacs-tools-setup))

保存后，请在终端运行 doom sync 同步配置。

基本使用

启动与交互

最便捷的方式是通过临时菜单界面访问所有命令：

M-x claude-code-ide-menu

核心命令列表：

命令	描述
M-x claude-code-ide	为当前项目启动 Claude Code
M-x claude-code-ide-send-prompt	从 minibuffer 发送提示词给 Claude
M-x claude-code-ide-resume	恢复之前的 Claude Code 对话
M-x claude-code-ide-stop	停止当前项目的 Claude Code
M-x claude-code-ide-list-sessions	列出所有活跃会话并切换

启用深度集成

为了充分利用 Emacs 的生态能力（如 LSP 导航、Tree-sitter 分析等），建议运行以下命令启用内置 MCP 工具：

M-x claude-code-ide-emacs-tools-setup

多项目支持

该工具自动检测 Emacs 的 project.el。每个项目都会生成独立的 Claude Code 实例（例如 *claude-code[project-name]*）。您可以同时为不同项目运行多个实例，并通过 claude-code-ide-list-sessions 进行切换。

高级功能：Ediff Diff 查看

默认启用的 Ediff 集成允许您在应用代码更改前进行可视化对比和修改。当 Claude 提出代码建议时，Ediff 窗口会自动打开，您可以在其中调整建议内容后再确认应用。