Claude Code Git Attribution 管理指南：关闭提交署名并清理历史记录

1. 背景#

Claude Code 在执行 git commit 时，默认可能会在提交信息里追加 Claude 相关署名信息，例如：

1
🤖 Generated with Claude Code
2

3
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

这类 attribution 信息在个人项目中通常无碍，但在团队协作、开源项目或有统一提交规范的仓库中，可能带来以下问题：

• commit message 格式不符合团队约定。
• PR 描述被自动追加额外内容，显得不够简洁。
• 对外开源项目不希望引入第三方工具署名。
• 历史提交中混入大量不需要的 attribution 信息。

核心处理思路分两部分：

1. 关闭新提交和 PR 中的自动署名。
2. 视情况清理已经存在的历史提交。

2. 禁止新提交带 Claude 署名#

编辑 Claude Code 全局配置文件：

1
~/.claude/settings.json

加入或修改以下配置：

1
{
2
  "attribution": {
3
    "commit": "",
4
    "pr": ""
5
  }
6
}

1
{
2
  "includeCoAuthoredBy": false,
3
  "includeGitInstructions": false
4
}

3. 清理已有历史提交#

如果仓库里已经存在 Claude Code 自动生成的 attribution，需要根据提交是否已经推送到远程来选择处理方式。

1
brew install git-filter-repo
2
# 或
3
pip install git-filter-repo --break-system-packages

1
git filter-repo --force --message-callback '
2
return re.sub(b".*Co-Authored-By: Claude.*\n", b"", message)
3
'

1
git push --force

1
git commit --amend

4. 按项目单独配置#

Claude Code 的 attribution 不只能做全局配置，也可以按项目覆盖。

实践选择：

• 个人只是想关闭自己所有项目中的署名：使用全局配置。
• 团队希望所有成员保持一致：使用项目级 .claude/settings.json。
• 只想在某个项目本地临时覆盖：使用 .claude/settings.local.json。

5. 推荐处理流程#

如果只是从现在开始不再追加 Claude 署名：

1. 打开 ~/.claude/settings.json。
2. 将 attribution.commit 和 attribution.pr 都设为空字符串。
3. 重启 Claude Code。
4. 后续新提交和 PR 描述将不再自动追加 attribution。

如果还需要清理旧提交：

1. 先确认提交是否已经 push。
2. 未 push 的本地提交可以使用 git filter-repo 或 git commit --amend 清理。
3. 已 push 的历史提交需要谨慎评估是否改写远程历史。
4. 确认风险后，再执行清理和 git push --force。

6. 总结#

Claude Code 的 Git attribution 是可配置行为。对于需要保持提交记录简洁、遵守团队提交规范、或避免额外工具署名的项目，建议尽早关闭 attribution。

如果仓库尚未推送，清理成本较低；如果历史已经进入远程仓库，改写历史会影响协作者，应先评估风险再决定是否强制推送。