最近不少用 Claude Code 做开发的团队碰到一个奇怪现象：git log里突然多了一行Claude Session URL: https://claude.ai/session/xxxx，PR 描述底部也被自动追加了同一条链接。有人在群里问：这是中病毒了，还是哪个插件在“夹带私货”？
先说结论：这不是病毒，也不是某个人手动粘的。这是 Claude Code 默认会执行的一个行为——在 AI 生成的 commit message 和 PR description 后面追加当前会话的 Session URL。它的设计意图是“可追溯”，让后续开发者能顺着链接找到这段改动背后的完整对话过程。
但这个行为在工程圈引发了不小的争议：有人认为这是 AI 协作开发的理想形态，提交不再只是冷冰冰的 diff，而是一条能回到“思考现场”的线索；也有人认为它污染了 git 历史、泄露了内部讨论信息，必须立刻关闭。这篇文章我会把这个行为拆开讲清楚：它到底做了什么、为什么会默认开启、如何关闭、以及团队落地时该怎么定策略。
1. 这篇文章真正要解决的问题
如果你正在做 AI 辅助开发的落地，或者刚把 Claude Code 引入团队，大概率会遇到下面这些困惑：
- commit 信息里为什么多了一段 URL？可不可以删掉？
- PR 描述里也被追加了 Session URL，这是 Claude Code 的默认行为吗？
- 这个 URL 对别人有没有用？外部协作者能看到什么？
- 公司项目能不能保留？内部保密项目怎么处理？
- 有没有办法只对某类仓库关闭，而不是所有项目一刀切？
这篇文章的核心目的，就是帮你快速建立对这个行为的完整判断。读完你会知道：
- Session URL 是什么，它为什么会被追加到 commit 和 PR 描述里。
- 传统的人工提交记录和 AI 自动追加追溯信息，在工程流程上有什么本质差异。
- 如何按需开启或关闭，如何用脚本清理历史提交里已经写入的 URL。
- 团队协作时应该怎么定规范，才能既享受 AI 可追溯性，又不牺牲代码库的整洁度和安全性。
如果你只用 Claude Code 写个人项目，这个行为影响不大；但如果你在一个多人仓库、商业项目或外包项目里使用，请务必看完第 4 节和第 7 节，那两部分决定了你要不要在第一时间处理这件事。
2. Claude Code 为什么会默认追加 Session URL
要理解这个行为，先要理解 Claude Code 的“会话”是怎么工作的。当你在命令行里启动 Claude Code 并让它完成一个编码任务时，它会创建一个会话（Session），并生成一个唯一的会话 ID。这个 ID 对应一个 URL，格式通常是https://claude.ai/session/xxxx。
这个 URL 的价值在于：它保存了当前会话内的全部对话过程。比如你让 Claude Code 排查一个 bug，中间问过哪些问题、给过哪些上下文、Claude 中间修正过几次方案，最终提交了什么样的代码，这些信息都会被记录在会话里。
那么 Claude Code 为什么要把这个 URL 追加到 commit message 和 PR description 里？核心设计意图是解决 AI 编程时代的一个新问题：diff 可归因。
在传统开发模式下，代码审查者看一个 commit，可以调用作者来问“为什么这么改”。但在 AI 辅助编码场景下，一个 commit 可能是人和模型来回对话 20 轮之后生成的，单看 diff 根本不知道上下文。Session URL 提供了一个入口，让后来者可以回溯整个推理链条。
这个设计的另一层意图，是缩短“代码变更”和“变更原因”之间的距离。现在很多团队的 PR 描述写得很敷衍，只有一句“修复了登录问题”。但有了 Session URL，审查者可以直接打开链接，看完整对话，了解开发者到底怎么定位问题、对比过哪些方案。这种透明性，对长期维护的项目非常有价值。
但如果只看表面，很容易误以为“这就是 Claude Code 想打广告”。其实它更接近一种工程决策：在 AI 生成内容的时代，把“生成依据”随产物一起提交。类似的做法在软件工程里也不少见，比如编译产物附上源码版本号、Docker 镜像打上构建日志关联 ID。
明白了这个背景，你就能理解为什么它不是简单的“广告链接”，而是一个有明确使用场景的追踪字段。
3. 从终端到 Git 再到 GitHub 的完整流程
这个行为不是一次性发生的，而是贯穿了你用 Claude Code 完成一次编码任务的全流程。为了后面排查方便，我按执行顺序拆一遍。
3.1 Claude Code 生成 commit message
你在 Claude Code 会话里完成代码修改后，可以授权它直接执行git commit。这是最常见的触发点。Claude Code 在生成 commit message 时，会把当前会话的 URL追加到提交信息末尾。
实际效果类似下面这样：
Fix race condition in session manager The session manager had a race condition when multiple clients tried to update the same session concurrently. This change adds a per-session lock to serialize updates. Claude Session URL: https://claude.ai/session/abc123从 git 的角度看，这就是一条普通的 commit message，git log、git show都会显示它。
3.2 Claude Code 生成 PR description
当你继续让 Claude Code 创建 Pull Request 时，它同样会把 Session URL 追加到 PR 描述中。如果你使用 GitHub、GitLab 这类平台，PR 描述底部会多出一行链接。
这里要留意：很多团队配置了 PR 模板，Claude Code 通常会在模板内容之后追加 Session URL，而不是覆盖模板。这意味着你的 PR 描述可能长这样：
## Description Fixed the race condition... ## Test Plan - Unit tests passed - Manual test with 100 concurrent clients --- Claude Session URL: https://claude.ai/session/abc1233.3 写入位置：本地 git 配置与仓库级行为
这个行为是不是对所有项目都生效，取决于你的 Claude Code 配置。它可能读取的是用户级配置，也可能是项目级配置，还可能与当前终端环境变量有关。不同版本、不同启动方式，行为会有差异。
更稳妥的判断是：不要假设它只出现在某个固定目录下，而应该通过命令查看当前生效的配置。下面这组命令可以帮你定位：
# 查看 Claude Code 当前可用的配置项（命令形式以实际版本帮助为准） claude config list # 查看全局或项目级配置中的关键字段 claude config get -g sessionUrlInCommitMessage claude config get -g sessionUrlInPrDescription # 如果你的版本支持 JSON 输出，可以更直观地看到完整配置 claude config list --json如果claude config里没有对应字段，说明你的版本可能使用其他命名，或者该行为由环境变量控制。此时可以检查环境里是否有相关变量：
# 在类 Unix 系统下查看环境变量 env | grep -i claude # Windows PowerShell 下用下面这行 Get-ChildItem Env: | Where-Object { $_.Name -like "*CLAUDE*" }请记住：这里每一步都要以你实际安装的 Claude Code 版本为准。遇到字段不存在的情况，优先查看claude config --help或官方文档，不要盲目照搬网络上过时的配置名。
4. 如何关闭 Session URL 追加行为
如果你决定不保留 Session URL，关闭方式可以从三个层面操作。我建议先了解全部方案，再选择最适合团队的那一种。
4.1 通过配置开关关闭
如果当前版本的 Claude Code 提供了配置项，可以在settings.json中关闭。先找到配置文件位置：
# Linux / macOS 下常见的 Claude Code 配置目录 ls ~/.claude/ # 查看 settings.json 内容（如果没有，可先创建） cat ~/.claude/settings.json配置示例（注意：具体字段名以你的版本实际支持为准，这里只是展示配置结构）：
{ "sessionUrlDisplay": "off", "commitMessage": { "includeSessionUrl": false }, "pullRequest": { "includeSessionUrl": false } }如果你不希望影响全局项目，只针对某个仓库关闭，可以把配置放到项目目录下的.claude/settings.json中。此时项目级配置会覆盖全局配置。
4.2 通过环境变量关闭
部分版本支持用环境变量控制行为。你可以在启动 Claude Code 的终端里临时设置，也可以写进 shell 配置文件。下面是一个保守示例：
# 临时关闭当前终端会话的 Session URL 追加行为（变量名以实际版本为准） export CLAUDE_SESSION_URL_IN_COMMIT=false export CLAUDE_SESSION_URL_IN_PR=false # 启动 Claude Code claude如果你希望每次启动都生效，可以把这两行追加到~/.bashrc、~/.zshrc或 Windows 的用户环境变量中。
4.3 通过 git 钩子清理
如果配置开关找不到，或者你希望“后端不管怎么变，提交里坚决不出现 Session URL”，最稳妥的办法是在 git 层面做过滤。可以用prepare-commit-msg钩子，在提交信息写入后立即移除 Session URL 行。
在项目根目录创建或编辑.git/hooks/prepare-commit-msg：
#!/bin/sh # 文件路径：.git/hooks/prepare-commit-msg COMMIT_MSG_FILE="$1" cleanup_session_url() { sed -i '' '/^Claude Session URL: https:\/\/claude\.ai\/session\//d' "$COMMIT_MSG_FILE" } # macOS 的 sed 语法与 Linux 不同，这里做兼容判断 if [ "$(uname)" = "Darwin" ]; then cleanup_session_url else sed -i '/^Claude Session URL: https:\/\/claude\.ai\/session\//d' "$COMMIT_MSG_FILE" fi保存后给钩子添加执行权限：
chmod +x .git/hooks/prepare-commit-msg注意：钩子只在本地有效，不会随仓库自动同步到其他人。如果团队要统一执行，需要把钩子脚本纳入版本管理，并用工具（如 husky、pre-commit 框架）分发。
4.4 清理已经提交进历史的 Session URL
如果你已经在几十个 commit 里留下了 Session URL，想一次性清理，可以用git filter-branch或git filter-repo。这里给出git filter-repo的示例，因为它更快，也更安全。请先备份仓库：
# 安装 git-filter-repo（Python 环境一般用 pip） pip install git-filter-repo # 备份原仓库 git clone --mirror your-repo.git your-repo-backup.git # 在原始仓库中移除 commit message 里的 Session URL 行 git filter-repo --message-callback ' if b"Claude Session URL:" in message: lines = message.split(b"\n") lines = [line for line in lines if not line.startswith(b"Claude Session URL:")] message = b"\n".join(lines) return message '注意：这是重写历史操作，会改变 commit hash。如果仓库已经推送到远端，必须走强推流程，并通知所有协作者重新拉取。任何重写历史操作都要在确认备份、征得团队同意后进行。
5. 用完整示例看一遍：从“保留”到“移除”的全过程
只看命令有时候不容易建立整体感知。这里用一个最小示例，走一遍完整流程，帮助你理解每个环节的判断点。
5.1 初始化与首次提交
假设你在本地新建了一个项目：
mkdir demo-session-url cd demo-session-url git init echo "# Demo" > README.md此时启动 Claude Code，让它修改 README 并提交。如果 Claude Code 处于默认行为，生成的 commit 可能是：
git log --oneline --decorate某条提交信息里会出现 Session URL 行。使用git log -1查看完整信息：
git log -1输出可能会包含：
Update README Added project overview and usage instructions. Claude Session URL: https://claude.ai/session/abc1235.2 用钩子拦截并验证
接着我们启用钩子，再次发起一个新的提交。比如修改README.md，让 Claude Code 再次提交。此时prepare-commit-msg钩子会在提交前把 Session URL 行删除。最终git log -1的输出应该不再包含Claude Session URL。
这个过程可以验证钩子是否生效，也方便你在团队推广前做小范围测试。
5.3 在 PR 描述层面做过滤
如果你的问题更多出在 PR 描述上，可以在创建 PR 时使用 Claude Code 的提示词，明确要求“不要添加 Session URL”，也可以考虑用 CI 脚本在 PR 合并前检查描述内容。
一个简单的 CI 检查脚本片段：
#!/bin/bash # 文件路径：.github/scripts/check-pr-description.sh # 功能：PR 描述里不允许出现 Claude Session URL if grep -qi "Claude Session URL: https://claude.ai/session/" <<< "$PR_BODY"; then echo "PR description should not contain Claude Session URL." exit 1 fi exit 0这个脚本在 GitHub Actions 中可以通过读取github.event.pull_request.body来使用。原理很简单：匹配到 Session URL 就拒绝通过 CI，直到开发者移除该行。
6. 运行结果与效果验证
配置完成后，不能只看“好像没出现了”，要有一套验证方法。
6.1 验证 commit 层面
用下面命令检查所有历史提交中是否还包含 Session URL：
# 在当前分支上搜索所有 commit message 中包含 Session URL 的记录 git log --all --oneline --grep="Claude Session URL" # 如果有输出，说明仍有提交包含该 URL # 没有输出，说明当前分支已清理干净注意--all会搜索所有分支，如果只想检查当前分支，去掉--all。
6.2 验证 PR 描述层面
在本地环境中，如果 PR 描述由 Claude Code 自动生成，可以先用它生成一版草稿，在推送到远端前手动打开草稿检查底部是否多了 URL。
如果有 CI 脚本，则可以直接推送一个测试 PR，观察 CI 是否拦截。通过检查能确认脚本是否正常工作。
6.3 验证配置开关生效
如果你通过配置项关闭，可以重新启动 Claude Code 会话，让它执行一次“修改一个小文件并提交”的任务。提交完成后立即查看：
git log -1如果信息里没有 Session URL，说明配置已生效。如果仍然有，可能原因包括：配置文件路径不对、字段名不匹配、缓存未刷新，或该版本确实不支持关闭。
7. 常见问题与排查思路
| 问题现象 | 可能原因 | 排查方式 | 解决方案 |
|---|---|---|---|
| 关闭后 commit 里仍出现 Session URL | 配置字段名与当前版本不一致，或配置未加载 | 执行claude config list查看实际字段；检查settings.json路径是否正确 | 使用当前版本支持的字段名；重启 Claude Code 会话；必要时改用 git 钩子 |
| PR 描述里的 URL 删不掉 | PR 模板或 Claude Code 在生成描述时强制追加 | 查看最终 PR 草稿的原始 Markdown；检查模板中是否有动态插入逻辑 | 在创建 PR 时明确提示“不要添加 Session URL”；用 CI 脚本拦截检查 |
| 只有部分仓库出现该行为 | 项目级配置与全局配置不一致，或只在特定目录启动了 Claude Code | 对比~/.claude/settings.json与项目下.claude/settings.json | 按仓库维度设置统一配置 |
| 钩子脚本不生效 | 钩子没有执行权限，或脚本放在其他 git 目录下 | 检查ls -l .git/hooks/prepare-commit-msg是否有x权限 | 执行chmod +x .git/hooks/prepare-commit-msg |
| 远端的旧 commit 还带 URL | 本地清理后没有强推远端 | 查看远端仓库的提交记录 | 走git push --force-with-lease推送，并通知团队 |
| Session URL 打开后提示无权限 | 会话属于私人会话，外部协作者没有访问权限 | 用无痕模式打开链接；请求会话创建者截图或导出 | 不要依赖链接作为唯一审查依据 |
排查时有个通用原则：先确认现象是发生在 commit 层面还是 PR 描述层面，再分别定位。commit 层面通常是 Claude Code 生成 commit message 时写入的，PR 描述层面则可能是生成 PR 描述时写入的。两个环节的配置可能相互独立，不能用一个开关解决所有问题。
8. 最佳实践与工程建议
关于 Session URL 该不该保留，我的建议不是“一律关闭”，也不是“无脑保留”，而是按项目类型和团队协作方式分类处理。
8.1 个人项目和开源项目：建议保留
对于个人项目，Session URL 是你自己的回忆线索。几个月后你回来看一段提交，点开链接就能知道当时对话的上下文，非常有用。
对于开源项目，Session URL 可以让贡献者看到 AI 辅助开发的完整过程，相当于给审查者提供了“设计文档”。如果你的项目本身不涉及敏感信息，保留它是加分项。
8.2 商业项目和内部保密项目：谨慎关闭
商业项目里，commit 历史和 PR 描述会长期留在代码托管平台。如果 Session 里包含敏感讨论，比如客户数据、未公开的商业逻辑、内部安全分析，这些信息就可能通过一个 URL 被不该看到的人访问。即使设置了权限，也增加了审计难度。
更稳妥的做法是：关闭自动追加，但在 commit message 正文里保留足够的修改说明。如果确实需要追溯 AI 对话，可以单独维护一份日志，而不是把它塞进 git 历史。
8.3 不要只依赖 Session URL 做审查依据
Session URL 只有对能访问对应 Claude 账号的人才有意义。如果团队里有人离职、账号被回收、会话被清理，链接就失效了。所以不要把它当作唯一的代码审查依据，更不要约定“审查者必须打开 Session URL 才能 approve”。
代码审查仍然应该围绕 diff、测试、设计合理性展开。Session URL 是补充信息，不是必需信息。
8.4 团队落地时先写进规范，再动手配置
如果你在团队里推广 Claude Code，建议先确定规范，例如：
- 所有 AI 辅助生成的 commit message 必须能被人类看懂，不能只有机器生成的一堆标签。
- 默认关闭 Session URL 追加行为，除非项目负责人明确要求保留。
- 禁止在 commit 或 PR 描述中粘贴包含敏感信息的对话片段。
- 重写 git 历史必须提前申请，由仓库管理员执行。
规范确定后再统一配置工具和钩子，避免每个人各自为政。
8.5 对“自动化生成内容”保持审查习惯
Claude Code 自动提交 commit message 和 PR 描述，确实提升了效率，但也引入了新的风险：你不再逐字阅读提交内容，可能把某些多余信息一起提交进去。建议即使配置了自动追加，也养成提交前看一眼的习惯，尤其是在多人协作分支上。
9. 总结与后续学习方向
这个看似小的问题，背后是 AI 辅助开发进入工程化阶段后一个真实的碰撞：AI 生成的产物需要可追溯，传统 git 历史又要求简洁干净。Claude Code 默认追加 Session URL，本质上是把“AI 生成依据”作为一等公民写进了提交信息里。这个行为本身没有对错，只有是否适合你的项目。
如果你正在引入 Claude Code，先做三件事：第一，查看当前版本的配置项，确认这个行为在你的环境里是否开启；第二，根据项目性质决定保留还是关闭，不要盲目跟风；第三，如果要关闭，优先用配置开关，配置覆盖不到再用 git 钩子。
后续可以继续深入的方向包括：Claude Code 的权限管理、它在 CI/CD 流程中的自动化用法、以及 AI 生成 commit message 的团队规范落地。这些话题都比“关闭一个 URL”更值得建模，但前提是你已经被这次小问题提醒过：AI 工具的参数配置，会在你意想不到的角落影响代码库的长期质量。
比较字符串)
