用过 Claude Code 的人应该都见过这个场景让它在仓库里帮忙生成提交信息或者直接创建 PR等提交完成后再看 git logcommit message 末尾多了一行 “Generated with Claude Code”后面还跟着一个claude.ai/share/xxx的会话 URL。第一次遇到的人大概率会愣一下这一行是哪来的是不是配置出了问题实际上这不是错误而是 Claude Code 的默认行为它会将会话 URL 自动附加到提交信息和 PR 描述中。这篇内容就把这个行为讲透——它是什么、为什么存在、能不能关掉、以及团队协作时到底该保留还是清理同时把安装、登录、VS Code 配置、git hook 清理这些实际操作链路一并覆盖。适合正在用 Claude Code 写代码、做代码评审或者正准备在团队里推广 AI 辅助编码的开发者。1. 先看清那个 URL 是从哪来的1.1 一个最小场景跑一次提交就看见了假设你在一个 git 仓库里做了几处改动然后启动 Claude Codeclaude接着告诉它“帮我把当前改动整理成一次提交。” Claude Code 会先分析git diff理解改动的意图生成一个提交信息然后执行类似这样的命令git commit -m feat: 新增文章标签筛选 支持按标签聚合查询文章列表并补充分页边界处理。提交完成之后你用git log -1查看刚才的提交看到的内容可能变成这样commit 3f0a8c2e... Author: yourname youexample.com Date: ... feat: 新增文章标签筛选 支持按标签聚合查询文章列表并补充分页边界处理。 Generated with Claude Code: https://claude.ai/share/xxxx注意最后一行。这个https://claude.ai/share/xxxx就是 Claude 会话 URL它默认被附加到了提交信息里。如果你让 Claude Code 生成 PR它也会在 PR 描述末尾放上类似的内容## Summary 本次提交新增文章标签筛选能力。 ## Changes - 新增 /api/posts?tagxxx 查询参数 - 补充分页边界处理 - 增加对应单元测试 Generated with Claude Code: https://claude.ai/share/xxxx这里用纯文本展示是因为不同版本的 Claude Code 文案格式不完全一样有的带图标符号有的不带但核心结构是一致的一段生成标识加上一个会话链接。1.2 附加内容拆解标识文案 会话 URL把这个附加内容拆开看其实就两部分。部分典型内容作用生成标识Generated with Claude Code说明这条提交或 PR 由 AI 辅助生成会话链接https://claude.ai/share/xxxx指向生成这段内容时的对话上下文附加位置提交信息末尾、PR 描述末尾方便 reviewer 和审计人员反查来源这个链接指向的是 Claude Code 当时的会话。只要你没有主动删除对应会话打开链接就能看到当时的对话内容包括你提出的需求、Claude 的分析、它执行过的命令以及中途的调整过程。1.3 这是功能设计不是报错很多人第一次看到这个 URL第一反应是自己哪里配错了。其实它不影响代码编译不影响测试也不影响部署。它只存在于提交信息和 PR 描述这些文本内容里不会出现在代码 diff 里也不会改变你提交的文件内容。可以把它理解成一种“来源标记”类似我们在 commit message 里常见到的Issue #123或JIRA-456引用。只不过这次引用的不是需求管理系统的工单而是 AI 编码助手自己的会话记录。2. 为什么 Claude Code 会默认附加会话 URL2.1 给每个变更补一份“来源档案”AI 辅助生成代码和手写代码有一个很大的区别手写代码时提交信息通常能反映开发者的意图而 AI 生成代码时意图藏在对话里提交信息只是最后结论。比如“为什么这里要做分页边界处理”从提交信息里看不出来但打开会话 URL 就能看到当时完整的讨论过程。Claude Code 把会话链接放进提交信息本质上是给这次变更补了一份“来源档案”。半年后有人在git log里翻到这条提交只要点开链接就能恢复当时的上下文。这个设计和“在提交信息里关联需求单号”是同一个思路区别是它不再需要你手动维护而是工具替你加上了。2.2 对 Reviewer、审计和新人都有价值对代码评审来说这个链接能省不少沟通成本。Reviewer 在 PR 里看到一段不太容易理解的改动点开会话 URL就能看到 Claude 是依据什么判断做出这个改动的。如果 Claude 在会话里已经解释过某段逻辑的取舍reviewer 就不需要再重复问一遍。对审计场景也一样。现在不少团队对 AI 生成代码有治理要求需要知道哪些代码是 AI 写的、经过哪些步骤、有没有人工确认。这个 URL 提供了一条可追溯的路径。对新加入项目的开发者来说这个链接还能当学习材料。你去看一条历史提交点开会话链接能还原当时的需求背景和实现思路比干看 diff 更容易理解。2.3 风险面URL 背后是整段对话看到价值的同时也要看到风险。会话 URL 背后是整段对话而对话里往往包含比提交信息本身更多的东西内部服务名、文件路径、业务逻辑、排查问题的过程甚至某些不适合公开的技术决策。如果这个仓库是公开的提交历史会被搜索引擎收录这个 URL 也会跟着出现。链接对应的会话能不能被任何人打开取决于平台对分享链接的可见范围控制。如果你不确定最稳妥的做法是把它当成公开链接处理。即便仓库是私有的一个带链接的提交信息被截图、转发、或者拷贝到外部文档里也很容易扩散。所以在决定“保留还是移除”之前先想清楚这个会话里到底装了什么。3. 先把环境跑通安装、登录和首次提交3.1 安装 Claude Code 的最小前置条件在讨论怎么处理 URL 之前先把 Claude Code 跑起来。很多后面看到的奇怪现象其实都是环境问题。安装前确认三样东西Node.js 版本常见要求是 18 及以上具体以当前版本官方文档为准npm 或者能在命令行使用的 Node 包管理器一个可以正常执行命令的终端Windows 可以选 PowerShell 或 CMDLinux/macOS 用自带终端就行全局安装命令npm install -g anthropic-ai/claude-code安装完成后验证一下claude --version这里有一个非常常见的坑。Windows 用户安装完在终端输入claude会看到这样的提示claude 不是内部或外部命令也不是可运行的程序或批处理文件PowerShell 里则可能提示无法将“claude”项识别为 cmdlet、函数、脚本文件或可运行程序的名称这不是 Claude 安装失败了而是 npm 的全局目录没有加入系统 PATH。先查目录npm prefix -g然后把输出的目录加到 PATH 里。Windows 上通常是%APPDATA%\npm。加完之后重启终端再执行claude --version。如果着急使用也可以先用npx anthropic-ai/claude-code临时启动但体验上不如全局命令方便。3.2 登录、账号和组织策略问题首次执行claude会引导登录。你需要有可用的 Claude 账号并且账号有对应的使用权限或 API 配置。有几种提示看起来像报错其实都是账号层的问题如果提示 “Claude is not available to new users right now”说明当前账号状态不可用要去官方账号体系里看订阅和权限状态不要在本地配置上瞎折腾。如果提示 “your organization has disabled claude subscription access for claude code”说明企业的管理策略限制了 Claude Code 的使用需要找管理员确认权限。如果是在团队统一管理下使用管理员可能会统一分发凭证个人不需要单独处理登录。这些情况都不是改配置文件能解决的先确认账号层再回头看本地。3.3 通过 VS Code 或终端进入真实仓库Claude Code 的常见使用方式有三种终端 CLI、VS Code 插件、桌面端。不同入口的界面上有差异但核心能力是同一套代码生成、提交、PR 创建走的都是同一套流程。刚才说的“提交信息里附加 URL”这个行为主要发生在代码生成的流程层和前端入口关系不大。实际使用时你需要先进到一个真正的 git 仓库再启动 Claude Codecd /path/to/your/repo git status claude如果当前目录不是 git 仓库很多和提交、PR 相关的功能会不可用。Claude Code 的设计是围绕 git 工作流展开的不要在非仓库目录里测试它能不能提交代码。如果你是通过兼容端点接入其他模型服务比如团队内部网关或者使用 DeepSeek 这类提供兼容 API 的服务常见做法是把端点信息配置到环境变量里并把模型名设置为服务端支持的标识。具体变量名和取值要以你的服务提供方文档为准。模型配置改完之后提交行为本身不会变附加会话 URL 的行为取决于 Claude Code 版本和工作流配置和模型是哪家的没有直接关系。3.4 用一次最小提交验证默认行为环境跑通之后不要直接拿正式业务改动来实验。我一般会先做一个很小的验证在仓库里新建一个分支随便改一个文件比如补一行注释或调整一个文案。启动 Claude Code让它复查改动并提交。Claude 会先给出它准备执行的 git 命令确认命令无误后批准执行。提交完成后执行git log -1如果一切正常提交信息末尾应该能看到会话 URL。如果你没看到可能的原因有三个你的版本默认关闭了这个行为你在对话里明确要求过不要附加本地 git hook 已经把内容清理掉了。然后再验证 PR 场景。如果你有 GitHub CLI 权限可以让 Claude Code 准备一个 PR创建完打开 PR 描述看末尾是否有同样的 URL。这一步能帮你确认到底是“提交信息”和“PR 描述”两处都会附加还是只有一处触发。4. 不想让 URL 出现在提交信息里怎么处理4.1 先查官方配置而不是复制旧参数不同版本的 Claude Code对属性的命名方式不一样。网上关于“关闭 URL 附加”的旧帖不一定适用你当前版本直接照抄可能导致配置失效甚至破坏其他行为。我建议的顺序是在 Claude Code 会话里输入/config看当前版本提供哪些配置项。检查用户级配置一般在~/.claude/settings.json。检查项目级配置一般在.claude/settings.json。找和attribution、footer、signature、commit format相关的关键词。如果你在当前版本的配置里找不到明确开关不要硬套旧参数。直接跳到后面的 git hook 方案更稳妥。配置项还有一个优先级问题用户级配置、项目级配置、环境变量三者可能存在覆盖关系。排查时尽量按“先看环境变量再看项目配置最后看用户配置”的顺序来避免被你自己的配置覆盖掉预期值。4.2 用 commit-msg 钩子做提交信息清理git hook 是本地脚本会在 git 执行到特定阶段时自动运行。commit-msg钩子在提交信息确定之后、提交完成之前执行最适合用来清理自动附加的内容。在仓库里创建一个脚本文件比如.githooks/commit-msg#!/bin/sh # 删除 Claude Code 自动附加到提交信息中的生成标记和会话 URL if [ -f $1 ]; then grep -v -E Generated with Claude Code|claude\.ai/share/ $1 $1.tmp mv $1.tmp $1 fi解释一下这个脚本在做什么$1是 git 传入的提交信息文件路径grep -v会删除匹配到的行保留其他行匹配条件覆盖了 “Generated with Claude Code” 和claude.ai/share/两种模式如果你的版本把标识和 URL 写在同一行这一整行也会被删掉给脚本加执行权限并让 git 使用这个目录chmod x .githooks/commit-msg git config core.hooksPath .githooks然后在 Claude Code 里再跑一次提交验证。如果git log -1里不再出现 URL说明 hook 生效了。4.3 让全团队共享同一套清理规则.git/hooks目录默认不会提交到仓库但core.hooksPath可以指向一个已提交的目录。把.githooks/提交到仓库然后在每个克隆仓库里执行一次git config core.hooksPath .githooks再配合一个简单的 CI 校验确保有人绕过 hook 时也能被拦下来。比如在 CI 里检查最近一次提交信息git log -1 --format%B | grep -q claude\.ai/share/ exit 1 || exit 0这段命令的意思是如果提交信息里出现了会话 URL就让 CI 失败。这样做不能替代 hook但能兜底防止有人用git commit --no-verify绕过本地检查。4.4 PR 描述里的 URL 另做处理要注意PR 描述不经过本地的 commit-msg 钩子。它是在 PR 创建时通过 API 或命令行工具生成的因此 hook 拦截不到。很多团队在这里踩过坑本地提交信息已经干净了结果 PR 描述里还是带着 URL。处理方式有三种让 Claude Code 先创建 draft PR你在合入前检查并编辑描述删掉 footer。让 Claude 把 PR 描述写成文件你清理之后再通过gh pr edit提交。