Git GUI 中的 AI 提交消息生成器：Claude Code、Codex 和 Antigravity

Git GUI 的最简单的 AI 提交消息生成器是您已经使用的编码代理。在 GitTree（适用于 macOS、Windows 和 Linux 的桌面 Git 客户端）中，您可以暂存更改，单击提交摘要旁边的闪烁按钮，然后您安装的 Claude Code、Codex 或 Antigravity CLI 会从暂存的差异中起草消息。您阅读、编辑并提交。对于这些草稿，GitTree 不使用自己的 AI 模型，不存储 AI 密钥，也不出售积分，并且在您单击“生成”之前不会发送任何内容。

本指南解释了您的计算机会留下什么、如何设置它、如何进行常规提交以及如何审查草稿，以便历史记录仍然说明您的意思。相同的代理也起草拉取请求标题和描述。

当您携带自己的代理时，带有 AI 的 Git GUI 如何工作

许多开发者工具将人工智能作为附加组件出售：您购买积分，将 API 密钥粘贴到工具中或升级到计划。对于提交和拉取请求草稿，GitTree 会查找您计算机上已安装的编码代理 CLI，并在您询问时运行其中一个来编写草稿。 CLI 根据其供应商条款，使用您现有的订阅或 API 密钥进行应答，就像您自己在终端中输入请求一样。因此，GitTree 不出售任何 AI 积分：草稿是 GitTree Pro 的一部分，从免费试用开始，它们的 AI 使用量将计入您自己的 CLI 计划或密钥。

• 无法购买 AI 积分。 GitTree 不出售任何积分。这些草稿是 GitTree Pro（可免费试用）的一部分，此外还有 Nour、AI 助手和所有托管集成；免费计划保留整个本地 Git 客户端。草稿的 AI 使用量将根据您的 CLI 已登录的计划或 API 密钥进行计数。
• GitTree 没有存储密钥。 每个 CLI 都保留自己的登录信息。 GitTree 从不请求 API 密钥，也不会保留任何密钥。
• 后台没有任何运行。 CLI 仅在您单击“生成”时启动，并且您可以随时停止它。
• 您选择的代理。 在首选项中设置 Claude Code、Codex 或 Antigravity CLI，或从按钮旁边的菜单切换为一份草稿。

AI 提交消息生成器发送的内容以及保密的内容

当您单击“生成”时，GitTree 会通过标准输入将一个提示传递到 CLI，而不是作为其他程序可以读取的命令行参数。它包含：

• 分阶段的更改作为差异，由每个更改文件的摘要引导。未暂存的编辑被排除在外，并且非常大的差异被削减为 48 KB（摘要仍然命名每个文件）。
• 存储库中最多有十个最近的提交摘要，因此草稿遵循您的团队已经使用的风格。合并提交被跳过。
• 您来自首选项的额外说明（如果您已编写）。
• 如果您已打开该检查，则请求常规提交表单。

CLI 将该提示发送给您帐户下的自己的供应商（Anthropic、OpenAI 或 Google）。这以及您要求 Nour（使用 GitTree Pro）的问题，是 GitTree 规则的唯一例外，即您的代码保留在您的计算机上，并且仅在您点击时才会进行起草。 GitTree 隐私政策 也对此进行了描述。

代理周围的护栏

差异可以包含其他人编写的文本，例如尝试指导模型的合并的传入侧。因此 GitTree 为代理提供尽可能少的操作：

• CLI 在空的私有文件夹中运行，而不是在存储库中运行，因此不会拾取提交到存储库的代理指令文件、设置或挂钩。
• Claude Code 在其内置工具和 MCP 服务器关闭的情况下运行。 Codex 在只读沙箱中运行，并且 GitTree 还要求它关闭其 shell 工具。两者都被告知不要保存会话。
• Antigravity CLI 没有开关来关闭其工具并保留自己的对话历史记录，因此 GitTree 拒绝将其用于以受限模式打开的存储库（您不信任其设置或挂钩的存储库）。 Claude Code 和 Codex 即使关闭了工具，仍然可以在那里起草。
• 草稿仅填充消息框：在按下提交按钮之前不会提交任何内容。耗时超过三分钟的草稿将被停止。

要在打开 GitTree 之前检查 CLI，claude --version 会打印版本号，而 codex login status 显示 Codex 的登录方式：

claude --version
codex login status

来自 AI 提交消息生成器的常规提交

常规提交 是摘要行的一个小约定：type(scope): description。 feat 添加功能，fix 修补错误，类型后的 ! 或 BREAKING CHANGE: 页脚标记重大更改。由于历史记录变得机器可读，因此工具可以构建变更日志并从中选择版本号。

在 GitTree 的首选项中启用 检查常规提交。然后，提交框会在您键入时建议使用 type(scope): description 形式（仅提供建议；它绝不会阻止提交），并且每个 AI 草稿都会要求提供具有标准类型的该形式：build、chore、ci、docs、feat、fix、perf、refactor、revert、style 或 test。对于上面屏幕截图中的更改，草稿可能如下：

fix(web): type the invite dialog ref and toast on success

Type the input ref so focus() is checked, show a success toast
once the invites are sent, and close the dialog only when the
request succeeds.

打开或关闭检查时，每个草稿都被要求具有相同的基本形状：最多 72 个字符的命令性摘要（“添加”，而不是“添加”），没有尾随句点，然后仅在需要解释更改时才将正文包裹在 72 个字符中。

用额外的指令来引导草稿

生成消息的额外说明（最多 2,000 个字符）会添加到每个请求中。将其用于差异不能透露的内部规则，例如“用英语编写”、“将正文保持在三行”或“使用范围 web、api 和文档”。与常规提交检查一样，可以在存储库特定首选项中覆盖每个存储库。

如何在提交之前查看 AI 起草的提交消息

代理看到的是差异，而不是您的意图。它可以很好地描述哪些变化，但仍然错过原因、夸大变化或将重构称为修复。三十秒的回顾让历史值得信赖：

1. 一次阶段一个逻辑更改。 该草案准确地描述了所阶段的内容，并且逐行阶段使集中提交变得容易（请参阅 GitTree 的阶段和提交功能）。
2. 像审阅者一样阅读摘要。它是否以命令式的方式说明了提交的作用？类型和范围是否正确？
3. 添加原因。 原因、票号和您权衡的权衡只有您自己知道。将它们放入体内。
4. 删除任何发明的东西。 如果草案说添加了测试或修复了错误，而差异没有做到这一点，请将其删除。
5. 之后修复错误。 勾选 修改先前的提交 并生成描述整个修改后的提交。 GitTree 还可以撤消提交、重置或变基。

AI 使用同一代理拉取请求标题和描述

同样的闪光按钮位于 GitTree 的“启动拉取请求”对话框中的标题旁边。代理接收分支及其目标、分支自己的提交消息（最多 200 条，合并省略）、自离开目标分支以来的更改（减少到 48 KB）、对话框的拉取请求模板和额外的指令。描述以 Markdown 形式返回，并且 GitTree 在替换您输入的任何内容之前会询问。

草稿仅填充对话框：在您按下“创建拉取请求”之前，不会到达 GitHub、GitLab、Bitbucket 或 Azure DevOps。 （对 GitLab、Azure DevOps、GitHub Enterprise Server 和 Bitbucket Data Center 的支持是 GitTree 中的新增功能。）GitTree 中的拉取请求需要 Pro 版的 GitTree 帐户，因此此草案也是如此； AI提交消息草稿也需要Pro；自己写提交消息则不会。

Claude Code、Codex 或 Antigravity：哪个 CLI 应该编写您的提交消息？

GitTree 向每个人发送相同的提示，并期望返回几行文本，因此实际差异在于上面护栏中的访问权限和隐私详细信息。措辞有多好取决于每个 CLI 背后的模型，因此请根据您自己的代码来判断它们：

• 使用您已有的。 付费 Claude 计划涵盖 Claude Code，您的 ChatGPT 帐户登录 Codex，您的 Google 帐户登录 Antigravity CLI。
• 安装多个代理？ 在“首选项”中设置默认值，然后使用按钮旁边的菜单尝试使用另一个代理进行单个草稿。这是在您自己的代码上比较它们的快速方法。

生成按钮故障排除

• “Claude Code 未安装”（或 Codex，或 Antigravity）：GitTree 会在常用的安装文件夹和登录 shell 的 PATH 中查找。如果新终端也无法运行该命令，请先修复安装。
• 在 Windows 上： npm 安装的 CLI 是一个 .cmd 脚本，GitTree 不会运行。使用供应商的独立安装程序重新安装，以便真正的 .exe 位于您的路径上。
• “暂存此提交应首先包含的更改”： 生成需要暂存的更改，或勾选修改先前提交。
• CLI 报告错误： 登录过期或已用完的计划限制来自 CLI 本身，并且 GitTree 显示其消息，其中包含任何类似于已删除密钥的内容。在终端中再次登录。
• 草稿速度慢：随时按“停止生成”。 GitTree 也会在三分钟后停止草稿。

还卡住了吗？ GitTree 支持页面 列出了联系我们的所有方式以及错误报告表。

在 GitTree 中尝试 AI 提交消息

GitTree 在 macOS、Windows 和 Linux 上有一个免费计划，包含整个本地 Git 客户端，包括私有存储库。 AI 提交和拉取请求草稿随 GitTree Pro 一起提供，Nour、AI 助手、每个托管集成和创建组织也是如此；专业版从免费试用开始（请参阅定价）。它需要 Git 2.39 或更高版本，并且草稿需要登录三个 CLI 之一。获取下面的安装程序或查看 GitTree 下载页面 上的每个选项。

同时运行多个代理？阅读如何将 Git 工作树与 AI 编码代理结合使用。权衡视觉客户端与终端？请参阅 Git GUI 与命令行 以及我们对最佳 Git GUI 客户端 的综述。