1. Codex 说改完了Git 却一片空白是怎么回事你让 Codex 改一个登录校验逻辑它回复「已完成修改共更新 3 个文件」你切回终端敲下git status屏幕上却只有一行nothing to commit, working tree clean。这种「AI 说改了、Git 说没改」的割裂感几乎每个把 Codex 接进真实项目的人都会撞上一次。先把结论放前面绝大多数情况下代码真的被改了只是你查看 Git 状态的位置和 Codex 实际工作的仓库、分支或工作区不是同一个。Codex 这类编码 Agent 在运行时可能自动切分支、自动git add、自动git commit甚至用 Git Worktree 给每个任务开独立目录。它干活的位置和你眼睛盯着的位置一旦错位就会出现「改动凭空消失」的错觉。这篇聚焦三条排查主线分支、工作区、提交状态。我会给出可直接复制的git status/git branch/git diff检查命令、一份settings.json骨架以及用 TaoToken 统一 Key 接入 AI 工具后的验证动作。适合正在用 Codex、Cursor、Claude Code 等工具改真实项目却被 Git 状态搞晕的开发者。读完你能在 2 分钟内定位「代码到底在哪」。2. 先统一入口用 TaoToken 管好 Key 再谈排查排查 Git 之前有个前置动作值得先做把 AI 工具的接入入口统一。原因很实际——当你同时用 Codex、Claude Code、Cursor 好几个工具时每个工具各配一套 Key、各连一个地址出问题时你连「是哪个工具改的、改到哪」都说不清。入口统一之后工具行为可预期排查才有基准。TaoToken 在这里扮演的是统一接入层一个 Key 覆盖多个模型与编码工具地址和密钥集中管理。官网入口是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 基址是 https://taotoken.net/api 这个不加 UTM。你需要在控制台生成 Key再把它填进各工具的配置里。具体路径我列一下方便你按需跳转生成和管理密钥https://taotoken.net/console/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi_keysutm_campaignrewrite接入文档各工具配置写法https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite模型对话验证https://taotoken.net?utm_sourcetaotoken_aicg_blog_endutm_contentmodel_chatutm_campaignrewrite长期编码 / Agent 场景https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding_planutm_campaignrewriteClaude Code 接入说明https://taotoken.net/doc/claudecode-anthropic?utm_sourcetaotoken_aicg_blog_endutm_contentclaudecodeutm_campaignrewrite注意Key 属于敏感凭据不要写进会提交到 Git 的文件里。下面给的settings.json骨架用环境变量占位就是为了避免 Key 跟着代码一起进仓库——这一点和本篇的 Git 排查主题其实是同一件事别让不该进版本库的东西混进去。3. 可复制配置settings.json 骨架与三条检查命令3.1 settings.json 骨架不同工具的配置文件位置不一样但结构大同小异。下面这份骨架把接入地址和 Key 分离Key 走环境变量{ ai: { provider: taotoken, baseUrl: https://taotoken.net/api, apiKeyEnv: TAOTOKEN_API_KEY, model: your-model-name }, agent: { autoCommit: false, autoBranch: false, worktree: false } }这里agent段是排查的关键。autoCommit、autoBranch、worktree三个开关直接决定了 Codex 会不会背着你切分支、提交、开独立工作区。如果你经常遇到「Git 看不到变化」先把autoCommit和autoBranch设为false让 Agent 只改文件、不碰 Git 状态排查范围立刻缩小一半。设置环境变量Linux / macOSexport TAOTOKEN_API_KEY你的KeyWindows PowerShell$env:TAOTOKEN_API_KEY你的Key3.2 三条核心检查命令第一条确认仓库根目录。很多人电脑里同时有/project/app、/project/app-copy、/project/app-testCodex 在app-test改你在app里查当然看不到。pwd git rev-parse --show-toplevelpwd告诉你当前在哪git rev-parse --show-toplevel告诉你这个目录属于哪个 Git 仓库的根。两个输出对不上问题就找到了。第二条确认分支。Codex 自动建分支后改动全在新分支上你盯着main自然一片干净。git branch --show-current git branch -a--show-current只输出当前分支名-a列出本地和远程所有分支方便你找 Codex 可能创建的那个。第三条分状态看 diff。这是最容易踩的坑git diff默认只看未暂存的变化。文件一旦git add就得换命令。git status git diff # 工作区未暂存的变化 git diff --cached # 已暂存、未提交的变化 git log --oneline -5 # 最近 5 次提交 git show # 最近一次提交改了什么把这几条按顺序跑一遍代码在哪个状态基本就清楚了。4. 验证请求从仓库到提交的完整排查链光有命令不够得知道每条命令对应哪种「假象」。下面按排查顺序走一遍每条都说明它解决什么问题。第一步仓库对不对。git rev-parse --show-toplevel如果输出是/project/app-test而你以为在/project/app那 Codex 的改动一直都在只是不在你看的地方。第二步分支对不对。git branch --show-current假设输出fix/user-login而你之前一直在main上找那切过去就能看到改动git checkout fix/user-login git status第三步Worktree 有没有掺和。一些 AI 工作流用 Git Worktree 给每个任务开独立目录它们同属一个仓库但对应不同分支git worktree list输出会列出每个工作区的路径和对应分支。Codex 可能在/project/app-agent-1干活你却在/project/app找。第四步工作区状态。git status如果显示nothing to commit, working tree clean别急着下结论「没改」。往下走。第五步暂存区。git diff --cachedCodex 执行过git add的话改动全在这里git diff是看不到的。第六步提交历史。git log --oneline -5 git show如果 Codex 已经git commitgit status干净是正常的改动进了提交。git show能让你看到最近一次提交具体动了哪些文件、哪些行。验证接入是否生效。配好 Key 后先做一次最小验证确认工具确实通过 TaoToken 在跑curl https://taotoken.net/api/v1/models \ -H Authorization: Bearer $TAOTOKEN_API_KEY能返回模型列表说明 Key 和地址都通了。这一步和 Git 排查的关系在于确认工具行为可预期你才能相信「Codex 说改了」这句话本身是可信的剩下的就纯粹是 Git 状态定位问题。5. 本篇常见错排查现象一git status干净但编辑器里能看到新代码。大概率是文件已git add进暂存区。跑git diff --cached确认。如果暂存区也空检查是不是看错了同名文件——大型项目里src/config.ts、legacy/config.ts、tests/config.ts同时存在很常见Codex 说改了config.ts你打开的可能是另一个。用完整路径确认git diff -- src/config.ts现象二当前分支没变化切分支后才发现代码在别处。Codex 自动建了分支。用git branch -a找出来git checkout过去即可。想避免就在settings.json里把autoBranch设为false。现象三Worktree 导致找不到改动位置。git worktree list列出所有工作区进到 Codex 实际工作的那个目录再看git status。现象四任务过程中看到改动最终却没了。Agent 可能试了方案 A、测试失败、回退、再试方案 B最后把不需要的改动恢复了。这种情况看最终结果而不是中间操作如果git status干净且没有新提交说明中间改动已被回退属于正常行为。现象五git diff输出为空就以为没改。记住git diff只看未暂存变化。已暂存用--cached已提交用git show。三个命令对应三种状态别混用。现象六Key 或配置写进了仓库文件。如果settings.json里硬编码了 Key 并被git add它会出现在git diff --cached里。立刻改成环境变量引用并把该文件加进.gitignore。6. 让 Codex 主动汇报 Git 状态从源头省掉排查排查再熟也不如一开始就不出错。最省事的做法是在任务指令里加一段要求让 Codex 收尾时主动交代 Git 状态任务完成后请告诉我 1. 当前工作目录pwd 输出 2. 当前 Git 分支 3. 修改了哪些文件完整路径 4. 是否已执行 git add 5. 是否已提交若已提交给出 commit 信息这样你第一眼就知道代码在哪、处于什么 Git 状态比一句「已完成修改」清楚太多。配合前面settings.json里关掉autoCommit和autoBranchAgent 的行为就完全在你掌控之内。如果你打算长期用 Codex 这类工具做编码和 Agent 任务把接入入口统一到 TaoToken 的 Coding Plan 会更省心一个 Key 管多个工具行为可预期排查有基准https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding_planutm_campaignrewrite 。接入配置的完整写法在文档里https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 。最后留一个我自己的习惯每次让 Agent 改完代码先跑git rev-parse --show-toplevel和git branch --show-current这两条确认位置和分支再决定用git diff、git diff --cached还是git show。三步之内定位比让 Codex 重改一遍快得多也安全得多——重改一遍反而可能把已经正确的提交搞乱。