接手老旧项目不用改公共gitignore:用git exclude静默忽略AI配置文件

接手老旧项目不用改公共gitignore:用git exclude静默忽略AI配置文件

接手维护年代久远的历史项目时,很多人会借助 Coding Agent (例如Claude Code,Codex)生成 CLAUDE.mdAGENT.md,用来定制本地代码辅助规则。 这类文件只服务于我个人本地AI开发,不需要同步给团队、不能提交到远程仓库。但历史仓库的 .gitignore 是团队统一维护的,随意新增规则会打乱原有规范,不适合修改;全局gitignore又会让所有项目都屏蔽这两个文件,灵活性太差。

这时最佳方案:使用 git exclude


极简使用步骤

  1. 进入项目根目录,创建对应目录(不存在则自动新建)
mkdir -p .git/info
  1. 编辑私有忽略文件 .git/info/exclude,写入两行规则
CLAUDE.md
AGENT.md

保存后即时生效,无需额外Git命令。


核心优势

  1. 文件存放在 .git 目录内,不会被Git追踪、推送远程,仅当前本地这份仓库生效;
  2. 全程不动仓库里任何公开文件,.gitignore 零改动,不会影响团队所有人;
  3. 语法和gitignore完全一致,上手无学习成本。

简单选型对比

  • 项目.gitignore:改公共配置,全员生效,适合团队通用文件,此处不合适;
  • 全局gitignore:全电脑所有仓库统一屏蔽,会误伤其他需要保留CLAUDE.md的项目;
  • git exclude:单仓库、个人私有屏蔽,完美适配本地AI配置。

结尾小结

所有仅自己使用、不方便改动团队忽略清单的本地文件,优先交给git exclude管理。