https://orangon.github.io/tags/claude-code/Recent content in Claude Code on 武成龙Hugo -- gohugo.iozh-CNFri, 24 Jul 2026 00:00:00 +0000https://orangon.github.io/posts/2026-07-24-git-exclude-ai-config/Fri, 24 Jul 2026 00:00:00 +0000https://orangon.github.io/posts/2026-07-24-git-exclude-ai-config/<h1 id="接手老旧项目不用改公共gitignore用git-exclude静默忽略ai配置文件">接手老旧项目不用改公共gitignore：用git exclude静默忽略AI配置文件 </h1><p>接手维护年代久远的历史项目时，很多人会借助 Coding Agent （例如Claude Code，Codex）生成 <code>CLAUDE.md</code>、<code>AGENT.md</code>，用来定制本地代码辅助规则。 这类文件只服务于我个人本地AI开发，不需要同步给团队、不能提交到远程仓库。但历史仓库的 <code>.gitignore</code> 是团队统一维护的，随意新增规则会打乱原有规范，不适合修改；全局gitignore又会让所有项目都屏蔽这两个文件，灵活性太差。</p> <p>这时最佳方案：使用 <strong>git exclude</strong>。</p> <hr> <h2 id="极简使用步骤">极简使用步骤 </h2><ol> <li>进入项目根目录，创建对应目录（不存在则自动新建）</li> </ol> <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"><span class="line"><span class="cl">mkdir -p .git/info </span></span></code></pre></div><ol start="2"> <li>编辑私有忽略文件 <code>.git/info/exclude</code>，写入两行规则</li> </ol> <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-fallback" data-lang="fallback"><span class="line"><span class="cl">CLAUDE.md </span></span><span class="line"><span class="cl">AGENT.md </span></span></code></pre></div><p>保存后即时生效，无需额外Git命令。</p> <hr> <h2 id="核心优势">核心优势 </h2><ol> <li>文件存放在 <code>.git</code> 目录内，不会被Git追踪、推送远程，仅当前本地这份仓库生效；</li> <li>全程不动仓库里任何公开文件，<code>.gitignore</code> 零改动，不会影响团队所有人；</li> <li>语法和gitignore完全一致，上手无学习成本。</li> </ol> <hr> <h2 id="简单选型对比">简单选型对比 </h2><ul> <li><strong>项目<code>.gitignore</code></strong>：改公共配置，全员生效，适合团队通用文件，此处不合适；</li> <li><strong>全局gitignore</strong>：全电脑所有仓库统一屏蔽，会误伤其他需要保留CLAUDE.md的项目；</li> <li><strong>git exclude</strong>：单仓库、个人私有屏蔽，完美适配本地AI配置。</li> </ul> <hr> <h2 id="结尾小结">结尾小结 </h2><p>所有仅自己使用、不方便改动团队忽略清单的本地文件，优先交给git exclude管理。</p>