Agentic 调试
CLion 通过集成的 MCP 服务器向外部 AI 代理公开其调试器。 连接了调试器工具后，Claude、Codex 或 Junie 等代理可以自主驱动 CLion 的调试会话：启动和停止、管理断点、逐步执行代码、检查线程和变量，以及计算表达式。
无需自己步进代码，只需用自然语言描述问题，让代理收集运行时证据。 这有助于定位仅凭源代码和日志难以发现的问题，比如只在运行时才出现的不正确值。
启用调试器 MCP 工具包插件
此功能依赖于调试器 MCP 工具包插件，该插件默认在 CLion 中捆绑并启用。 如果相关功能不可用，请确保您未禁用该插件。
按下 Ctrl+Alt+S 打开设置，然后选择 。
打开 已安装 选项卡，找到 调试器 MCP 工具包插件，并勾选插件名称旁的复选框。
调试器如何访问代理
CLion 以两种方式向代理提供调试器功能：
调试器工具与分析、格式设置和其他 IDE 工具一同，通过 MCP 服务器提供。 它们的描述始终在代理上下文中，即使未进行调试。 调试器工具均以
xdebug_为前缀。 此选项适用于 CLion 2026.1.3 及更高版本。- 路由器模式
MCP 服务器同时公开一个通用工具
execute_tool，以及clion-debugger技能。 命令、参数和调试场景都在该技能中，只有代理需要调试器时才会加载。 调试器描述直到需要时才进入代理上下文，因此路由器模式减少了 token 消耗。 路由器模式支持 GDB、LLDB 和基于 DAP 的调试器，被 Claude Code、Codex 等代理使用。 此选项适用于 CLion 2026.2 及更高版本。
将代理连接到调试器
调试器工具通过 CLion MCP 服务器提供，服务器启用后客户端即可访问这些工具。
按 MCP 服务器 中的说明启用 MCP 服务器并设置客户端。
重启客户端以加载 CLion 工具，包括以
xdebug_为前缀的调试器工具。
可在 MCP 服务器 设置中查看已公开的工具，并可为单个工具启用或禁用。
开启路由器模式
在路由器模式下，CLion 会将调试器命令描述保持在代理上下文之外，直到代理需要它们。 MCP 服务器同时公开一个通用工具 execute_tool ，代理可按需加载 clion-debugger 技能。 路由器模式适合较长会话，因常驻工具描述会占用代理可用于任务的上下文。
在主菜单中，进入 .
请选择 启用仅路由器模式 复选框。 调试器工具依旧可通过
execute_tool访问，且clion-debugger技能会告知代理何时使用。 要关闭路由器模式，请取消复选框。
要加载调试任务所需技能，请在代理中调用：
在 Claude Code 中输入
/clion-debugger。在 Codex 中输入
$clion-debugger。
该技能提供运行程序、逐步执行、查看状态和步入函数等命令，因此代理仅为调试任务加载它们。
代理可以执行的操作
通过调试器工具，代理可以像你一样进行运行时调查：
为运行配置或源代码位置启动调试会话，并检查正在运行会话的状态（
xdebug_start_debugger_session，xdebug_get_debugger_status）。列出、设置和移除断点，并运行到指定行（
xdebug_list_breakpoints，xdebug_set_breakpoint，xdebug_remove_breakpoint，xdebug_run_to_line）。通过步进、恢复、暂停或停止会话来控制执行（
xdebug_control_session）。读取局部变量、帧值和嵌套字段，评估或更改表达式（
xdebug_get_frame_values，xdebug_get_value_by_path，xdebug_evaluate_expression，xdebug_set_variable）。检查线程及其调用堆栈（
xdebug_get_threads，xdebug_get_stack）。
使用代理调试代码
打开项目，然后向代理描述问题并让其调试代码。 例如：
代理会设置所需断点，启动调试会话并等待程序暂停。 当执行停止时，代理会读取调用堆栈、局部变量及需用于假设测试的表达式，然后汇报所发现的信息。
代理控制标准 CLion 调试器，可在 调试 工具窗口跟踪会话，并可随时接管。
限制
断点错误和日志型断点输出仅由基于 JVM 的调试器报告。 对于 C 和 C++ 调试器，即使配置了日志断点，这些事件流也可能保持为空。
调试会话期间通过调试器工具暂不支持对
constexpr表达式的计算。