做 AI 辅助开发也有段时间了Claude Code 和 Codex 这两个工具我几乎每天都在用。先说结论如果没有 Git 做版本管理这两个工具用起来会非常痛苦——AI 自动生成的改动经常横跨几十个文件思路一偏就可能把项目改废手一抖就找不回上一版。这篇指南不讲虚的从 Git 安装配置讲到 Claude Code / Codex 的分支提交工作流再聊几个我踩过的坑目标是让刚接触这套工具的人也能安安稳稳用起来。这套组合最值钱的地方不是某个单一功能而是把AI 写代码这个不可控过程重新装回可回滚、可审查、可协作的开发流程里。你可以先读一遍整体思路再照着后面的命令操作基本不会出大问题。1. 为什么 Claude Code / Codex 需要 Git 做底座1.1 Claude Code 和 Codex 到底解决什么问题Claude Code 是 Anthropic 推出的终端编程助手它能读懂整个项目的上下文直接改文件、跑命令、看报错然后在对话里跟你解释每一处改动。Codex 则是 OpenAI 的终端编程代理核心思路是你给一个任务它自己读代码、写计划、动手改更像一个能独立干活的临时同事。这两个工具的共同点是它们不是简单的代码补全而是会真的动你的文件。这意味着每次 AI 运行结束后工作区里可能多出十几个被修改的文件甚至还有新增文件。如果不开版本管理你根本不知道它到底碰了哪些东西也没办法在不影响其他改动的情况下单独挑出某一块代码来看效果。恰恰是这种主动改文件的工作方式让 Git 成了必需品。AI 再聪明也无法替代你自己对代码历史的掌控。你把控制权交给 AI但提交历史和安全网必须握在自己手里。1.2 没有版本管理的 AI 辅助开发会变成什么样我第一次用 Claude Code 改一个后端服务时项目里没有 Git 仓库它一次性改了 20 多个文件。改完以后发现有个接口的返回格式变了但我完全想不起它是在哪个文件里改的只能一个文件一个文件去翻。那天下午我至少浪费了两个小时只为了找回一段十分钟前的逻辑。那之后我就立了个规矩任何 AI 编程工具进入项目前必须先git init或者git clone否则我不让它碰代码。原因特别简单——版本管理不仅是为了代码丢了能找回来更重要的是它给了你一个 diff 的视角。你能看到 AI 到底改了哪些行哪些改动是合理的哪些是无意中夹带的私货。另外AI 在生成代码时经常会有惯性。它会延续项目里的旧模式哪怕那个模式本身就有问题。如果没有 Git你就很难把它的改动拆成小块逐块 review。有分支和提交以后你可以随时打断它切换任务甚至直接放弃这版改动重新来过。1.3 Git 到底解决了 AI 编程的哪些痛点Git 在 AI 辅助开发里的核心价值可以总结成四个词回滚、隔离、审查、协作。回滚是最基础的。AI 改出问题第一反应不是去查代码而是git checkout或者git reset先把工作区恢复到上一个稳定状态。隔离更重要——每次给 AI 派一个新任务就开一个新分支这样任务之间不会互相污染。审查是 AI 编程时代最容易被忽略的动作你用git diff看改动比让 AI 自己讲我改了什么靠谱得多。协作则体现在提交信息上AI 帮你把改动整理成规范的历史后续不管是同事 review 还是自己回看都能省下大量时间。Claude Code 和 Codex 本身也意识到了这一点它们都会在运行过程中调用 Git 命令、查看状态、分析 diff。所以掌握 Git 的常用操作就是掌握了和这两个工具对话的基础语言。2. 环境准备把 Git、Claude Code、Codex 一次装好2.1 安装 Git 并完成基础配置如果你在 Windows 上去 git-scm.com 下载安装包一路 next 就能装完建议勾选Git Bash Here和Git GUI Here这两个右键菜单项后面会很方便。macOS 用户直接brew install gitUbuntu / Debian 用sudo apt install git。装完以后先不要急着用做两件事。第一件事配置用户名和邮箱。提交历史里记录的是这个身份写错了后面很难改git config --global user.name Your Name git config --global user.email youexample.com第二件事生成 SSH 密钥并绑定到你常用的代码托管平台。如果你主要用 Gitee可以这样做ssh-keygen -t ed25519 -C youexample.com cat ~/.ssh/id_ed25519.pub把输出的公钥内容复制到 Gitee 的 SSH 公钥设置页面。这一步不是可选项因为 Claude Code 和 Codex 在 clone 私有仓库时都需要通过 SSH 或令牌来鉴权。如果你不想在终端里敲命令可以装 TortoiseGit大家习惯叫它小乌龟它会把 Git 操作变成右键菜单里的图形化选项对新手很友好。我个人的建议是小乌龟可以辅助看图但核心命令还是要会因为 Claude Code 和 Codex 是在终端里跑的你起码得能看懂它们在执行什么。2.2 安装 Claude CodeClaude Code 最常用的安装方式是通过 npm 全局安装前提是机器上有 Node.js 环境。打开终端执行npm install -g anthropic-ai/claude-code装完以后运行claude --version能输出版本号就说明成功了。新版也提供了桌面客户端和网页版入口但我个人更推荐终端版因为它离 Git 工作流更近切换项目、查看状态都更直接。第一次运行claude会引导你完成登录授权跟着提示走就行。登录成功后会进入 CLI 交互界面你在里面输入自然语言指令Claude 理解后会执行命令、修改文件。这里要特别提醒一下第一次进入项目时建议先输入/status或者直接问这个项目的结构是什么让它先熟悉一下代码再开始派活效果会好很多。如果你在用 VS Code可以配合 Cluade Code 的扩展或者直接在终端分屏使用。把编辑器窗口放在左边终端放在右边左边看 diff右边跟 AI 对话这是我觉得比较舒服的姿势。2.3 安装 Codex 并完成登录Codex 同样可以通过 npm 安装npm install -g openai/codex装完运行codex第一次会提示登录。如果是 Windows 用户登录时如果出现弹窗被拦截或者安装未完成的情况注意检查一下系统的用户权限必要的话用管理员身份重新运行终端。Codex 的默认模型和 Claude Code 不一样但它的工作流程本质上也是读仓库—改代码—给结果。它还支持把请求指向兼容的外部模型服务比如接入 DeepSeek 等第三方模型。如果你的配置里写了不支持的模型名启动时就会报类似这样的错the gpt-5.6-sol model is not supported when using codex with a...。遇到这种提示去配置文件里把模型改成官方支持的标识或者确认第三方服务的接口兼容性就能解决问题。2.4 用 Mise 管好 Node.js 版本安装 Claude Code 和 Codex 都需要 Node.js但这个版本不是随便装的。项目 A 可能要求 Node 18项目 B 可能要求 Node 22装全局版本很容易冲突。更麻烦的是如果 Node.js 版本太低npm 全局包的安装会直接失败。这里推荐用 Mise 来做多语言版本管理。Mise 的前身是大家熟悉的 RTX它不仅能管 Node还能管 Python、Java、Go 等等一个工具全搞定。安装完 Mise 以后只需要在项目目录里执行mise install node22 mise use node22这样就把当前项目的 Node 版本锁定在 22Claude Code 和 Codex 依赖的 npm 环境永远不会乱。我之前吃过亏为了装一个工具把系统的 Node 从 18 升到 20结果老项目直接跑不起来。用了 Mise 之后这种事情再没发生过。3. 从零搭建 Claude Code / Codex 的 Git 工作流3.1 初始化仓库与分支隔离很多人拿到项目第一件事就是让 AI 开始干活这是不对的。正确的第一步是确认代码已经在版本管理控制下。如果项目还没有 Git 仓库先执行git init git add . git commit -m chore: initial commit然后立刻开一个独立的分支给 AI 用git checkout -b feature/ai-refactor-login这个习惯特别重要。AI 的改动是不可控的它可能会中途出现完全错误的思路也可能会在改了十几个文件后告诉你这条路走不通。如果这些改动直接出现在主分支上你想回退都没法干净地回退。开一个专属分支就相当于给 AI 划了一个隔离区干得好就合并干不好就整条分支删掉主分支毫发无损。我个人在使用中还有一个小技巧分支名里带上 AI 工具的名称和任务关键词比如feature/claude-refactor-payment、fix/codex-login-page。这样一周以后回看分支列表你还能一眼看出来当时是哪次任务、用哪个工具干的活。3.2 提交规范与 commit --amend 的正确用法提交信息是 Git 历史的脸面。AI 工具帮你生成了一堆改动如果你不在提交阶段把历史整理清楚后面 review 和回溯会非常难受。我建议采用约定式提交的格式每个提交信息长这样feat: 新增用户积分接口 fix: 修复登录页面按钮点击无效的问题 refactor: 抽取数据库连接工具类 test: 补充结算模块单元测试 docs: 更新部署文档在 Claude Code 或者 Codex 完成修改后你可以自己手动执行git add和git commit这样最有掌控感。如果发现最后一次提交有遗漏别急着再开一个新提交可以用git commit --amend把它补进去git add forgotten-file.js git commit --amend -m feat: 新增用户积分接口--amend会把当前改动合并到上一个提交里并允许你重写提交信息。需要注意这只适合还没有 push 到远程的提交。如果已经推送给别人了就别再用这个命令否则会产生分叉历史害得同事骂人。有些场景下Claude Code 也会主动建议使用git commit --amend来整理提交。比如你让它重构一个接口并把提交合并到上一个它就会执行这个命令。这时候你只需要在对话里确认是否允许执行即可。3.3 在 Claude Code 中用自然语言指挥 GitClaude Code 最实用的能力之一是你能直接用自然语言操作 Git。比如我想快速了解当前分支改了什么不需要自己敲git status加git diff直接在对话里说帮我总结一下当前改动它就会自动执行相关命令然后把结果整理成人话汇报。复杂一点的场景也能处理。比如我有个需求改了一半想让它把目前修改提交成一个 WIP我会说把当前所有改动提交提交信息写成 wip: 登录页重构进行中把未跟踪的文件也加进去。Claude Code 会先执行git status确认改动再执行git add -A和git commit -m wip: 登录页重构进行中整个过程我只需要在旁边看着它敲命令必要时点一下确认。不过要小心Claude Code 执行 Git 命令时默认需要你的授权。如果你觉得自己已经非常熟练不想每个命令都确认可以在配置里设置特定命令免确认。但我劝你保守一点尤其是git push、git reset --hard这类不可逆操作还是保留确认环节给手抖留点余地。3.4 用 Codex 处理批量变更的完整流程Codex 在处理跨多个文件的批量变更时特别有优势。它一上来会先读仓库结构然后像写 PR 一样把改动计划列出来再逐文件修改。这个过程中你会看到终端里频繁闪现git diff、git status之类的命令那就是它在确认自己的工作区状态。使用 Codex 的正确流程我一般是这样几板斧第一步在分支上启动任务。git checkout -b fix/codex-invoice-calculation确保工作区是干净的。第二步在终端里执行codex 修复发票计算里税率重复叠加的问题它会自动分析和改动。第三步Codex 完成输出后我不急着相信它先自己执行git diff --stat看看改了哪些文件再git diff看具体内容。第四步确认没问题就用git add . git commit -m fix: 修复发票计算税率重复叠加的问题提交。Codex 也能处理需要修改多个文件但逻辑相对统一的重构任务比如改函数名、调整报错文案、统一日期格式化工具。这类事情让它做效率确实比我手改高。但如果涉及复杂的业务规则我建议把任务拆小一次让它只改一个逻辑点然后通过 Git diff 逐块确认。别让 AI 一口气改太多容易翻车。4. 常见问题与排查实录4.1 codex endpoint /responses 报错到底啥情况我在同时使用 Claude Code 和 Codex 时踩过一个很费解的坑。在 Claude Code 里切换 Codex 作为执行引擎时终端突然冒出一段长报错里面有类似cc switch ... failed while handling codex endpoint /responses的字样。这个问题的本质是Claude Code 要把请求发送到 Codex 的端点服务那个请求通道没建立成功。常见原因有三种第一是终端窗口开了太久本地会话过期第二是切换配置时填的端点地址格式不对第三是本地服务端口被其他进程占用。我的排查顺序是先退出 Claude Code 重新进再检查配置里的 base URL 是不是官方默认值最后用netstat看端口占用。大部分情况重开一次就解决了。这不是偶发的玄学问题而是工具状态没同步的典型表现着急没用按顺序排查最快。4.2 模型不支持报错gpt-5.6-sol 这类提示怎么处理Codex 这个工具默认只支持官方指定的模型集合如果你在配置文件或者启动参数里写了它不认识的模型名启动时就会直接拒绝工作。我见过很多人在社区里贴错误the gpt-5.6-sol model is not supported when using codex with a...其实原因很简单要么是打错了模型名要么是想接入第三方模型但没配置对。解决办法分两步先确认你填的模型标识在官方支持的列表里如果不在直接改成官方模型如果你想用第三方服务就按第三方服务提供的兼容格式去配置入口而不是在 Codex 的默认配置里硬写一个不存在的模型名。如果是从 DeepSeek 这类服务接入 Codex还要注意它们提供的接口是不是兼容 OpenAI 格式不是的话就要在请求层做转换。这块配置文档更新得很快装完以后多看看官方仓库的 readme比盲搜报错信息靠谱。4.3 Windows 安装 Git 时提示未完成怎么处理Windows 环境装 Git 出问题绝大多数不是操作问题而是权限和冲突问题。如果你看到安装进度条走了一半提示失败首先要做的事是退出所有终端和 IDE因为正在运行的进程可能锁住了 Git 的某些文件。接下来用管理员身份重新运行安装包我遇到过的安装未完成案例超过一半都是安装目录没有写权限。另外某些安全软件会把 Git 的身份校验组件误拦掉安装时如果发现一直卡在 SSH 相关步骤可以暂时关闭实时防护装完再打开。还有一个常见误解以为装完 Git 就一定有 Git Bash 的右键菜单。实际上这取决于安装时有没有勾选对应选项。如果没勾重新运行安装包在 Select Components 页面把 Git Bash Here 补上即可。4.4 中文文件名显示成转义符core.quotepath 的真面目写代码的人难免碰到中文文件名的资源文件但在 Windows 上跑git status的时候中文路径经常会显示成一大串\346\265\213\350\257\225这样的转义十六进制完全没法读。这不是你的文件坏了是 Git 默认为了兼容老系统把非 ASCII 字符做了转义。解决办法是用参数临时关闭转义git -c core.quotepathfalse status你甚至可以把常用参数组合起来在工作时直接调用。比如我经常用的一条git -c diff.mnemonicprefixfalse -c core.quotepathfalse --no-optional-locks status这条命令的核心作用是关闭中文转义关闭可选的 lock 行为让 status 显示更稳定。你不想每次都敲这么长的话可以把它配置成 Git 别名比如git st。在 AI 工具替你执行命令的时候这条命令也会避免很多误判——至少 Claude Code 看到中文文件名时不会一脸懵。4.5 Claude Code 卸载与重装有时候工具出了奇怪的问题重装比排查更高效。Claude Code 的卸载很简单在终端执行npm uninstall -g anthropic-ai/claude-codeCodex 同理npm uninstall -g openai/codex卸载后如果想清掉残留的配置再手动删除用户目录下的相关配置文件夹。重装之前最好先把终端完全关掉再开一个新的避免 npm 缓存或者文件占用导致装到半截失败。如果你之前是用客户端方式安装的卸载则要去系统的应用管理里找到对应应用删除后再重新下载。关于 Cluade Code 的 Skills 功能我只给一个建议如果官方仓库更新了 skills 安装方式别总用老方法硬装。这个功能的文件结构和安装机制改版过几次遇到安装后不生效的问题先看一眼官方文档比在终端里瞎试效率高得多。5. 最后再分享一点我个人长期使用的习惯折腾了这么久我的最终结论其实特别朴素AI 工具越强大版本管理就越要认真。我自己现在每个 AI 任务都会走一条固定流水线开分支、派任务、跑git diff、确认后提交、合并分支。Claude Code 负责需要解释和决策的复杂改动Codex 负责批量机械重构Git 在中间当安全网和记录仪。还有一个小细节值得提AI 工具的配置文件和 skills 是可以做二次开发的。比如我给 Claude Code 配过专门的提交信息生成器让它根据 diff 自动生成规范化的 commit message用了一段时间下来项目提交历史的整洁度肉眼可见地提升了。这属于进阶玩法等你把基础工作流跑通了再回头研究会更有收获。工具永远是辅助真正让代码变可靠的还是你的工作习惯。