敲下git --version终端回的不是版本号而是git : 无法将git项识别为 cmdlet、函数、脚本文件或可运行程序的名称。这条报错来自原文「安装检查」一节作者当场点破是环境变量 PATH 没起效还补了一句在哪看到提示就重启哪个cursor 内置终端重开不算数必须重启 cursor 本体。这次不重讲 git 怎么安装而是把这条报错原文当成排查素材交给走TaoToken的 Codex 对照排查。动手前只做一件事打开 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_content 注册、创建YOUR_API_KEY把 Codex 的模型通道指到https://taotoken.net/api。TaoToken 全程只负责供 Key 和 Base URL它不碰 PATH也不替你执行任何 git 命令PATH 改哪一份、cursor 要不要重启由 Codex 给顺序你在本地终端一条条敲。1. git --version 回显 CommandNotFoundExceptionPATH 到底断在哪1.1 原文「安装检查」现场版本号变成一串 cmdlet 报错原文装 git 给了两条路官网下 exe 无脑 next或者 winget 一条命令装完。装完之后安排了一次「安装检查」——打开终端敲git --version。正常应该看到的东西很朴素git version 2.49.0.rc2.windows.1但不少人的结果长这样git : 无法将git项识别为 cmdlet、函数、脚本文件或可运行程序的名称。请检查名称的拼写如果包括路径请确保路径正确然后再试一次。 所在位置 行:1 字符: 1 git --version ~~~ CategoryInfo : ObjectNotFound: (git:String) [], CommandNotFoundException FullyQualifiedErrorId : CommandNotFoundExceptionCommandNotFoundException是本文要处理的主角。它跟 git 本身没关系也不是 PowerShell 坏了。PowerShell 找命令的方式是按 PATH 环境变量里列的目录一个个翻有没有叫 git 的可执行文件。全翻完没有就抛这条 ObjectNotFound。翻译成人话——系统不知道该去哪找 git。1.2 作者那句「在哪看到提示就重启哪个」在 cursor 里要重启本体原文那句提醒值得单独拎出来讲在哪看到这个提示就重启哪个cursor 内部终端重开不起效必须重启 cursor。环境变量不是实时读取的。进程启动那一刻操作系统把当时的 PATH 复制一份交给它之后这个进程就一直用那份副本。你在「系统属性 - 环境变量」里新加了一行C:\Program Files\Git\cmd已经开着的 cursor 主进程并不知道。它的内置终端是它拉起来的子进程继承的还是旧 PATH所以关掉重开内置终端没用——旧副本还在得把源头换成新的。这就是「在哪看到提示就重启哪个」的含义报错出现在 cursor 内置终端就退出 cursor 本体再打开报错出现在独立 PowerShell 窗口就关掉那个窗口重开。搞清楚这一点能省下大把来回折腾的时间。1.3 为什么别自己猜把这事交给 CodexPATH 的坑比想象中密集用户级 PATH 和系统级 PATH 是两份不同的列表图形界面改的多半是用户级安装器写进去的可能是系统级Git 官方 exe 装完通常把可执行文件放在C:\Program Files\Git\cmdwinget 装的路径未必一样32 位和 64 位版本目录还不同。逐个猜、逐个改很容易把一个本来正常的变量改坏。更稳的做法是把现场信息打包丢给 Codex让它按固定顺序列检查项。前提是 Codex 的模型通道得通这就是下一步的意义。2. 先让 Codex 的模型通道落在 TaoToken 再谈排错2.1 打开官网注册、创建 YOUR_API_KEYCodex 是 OpenAI 的编程命令行工具负责跟你对话、读仓库文件、给排查顺序但它解决不了 PATH。你要做的是给它一条稳定的模型通道走统一 API 通道即可。打开 TaoToken注册登录后进控制台创建一把 Key占位符记作YOUR_API_KEY。这把 Key 跟系统 PATH 一点关系都没有它只用于让 Codex 调模型Key 就在这个控制台里创建。2.2 ~/.codex/config.toml 里的 provider 写法Codex 读的配置文件是~/.codex/config.tomlWindows 上一般落在C:\Users\你的用户名\.codex\config.toml。用它自己的model_provider/base_url字段不要往这里塞ANTHROPIC_*那套变量——那是 Claude Code 的写法Codex 不认。model YOUR_MODEL_ID model_provider taotoken [model_providers.taotoken] name TaoToken base_url https://taotoken.net/api env_key TAOTOKEN_API_KEYbase_url末尾不加/v1也不要带任何查询参数。填错成别的域名Codex 会一直连不上跟 PATH 报错是两码事。2.3 把 Key 塞进环境变量env_key写的是环境变量名不是 Key 本身。真正那把 Key 放进用户级环境变量setx TAOTOKEN_API_KEY YOUR_API_KEYsetx写的是持久变量当前已经开着的窗口读不到新开一个 PowerShell 才生效。这一步和第 1 章讲的是同一件事——环境变量改完得让新进程去读。2.4 模型 ID 以模型广场为准model那一行填什么以 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_content 模型广场当时列出的为准别自己拼gpt-5或者随手加日期后缀。填错了典型表现是请求返回模型不存在那属于通道配置问题不是 PATH 没生效别看混。3. 把 cmdlet 报错原文整包丢给 Codex该贴哪些信息3.1 三样东西缺一不可Codex 再聪明也看不到你的屏幕信息给不全它只能回一些通用套路。要让建议具体到可执行至少贴三样第一是报错原文整段复制包括CategoryInfo和FullyQualifiedErrorId不要只写「git 用不了」。第二是当前终端所在位置也就是原文里那个PS D:\XX目录本身不重要重要的是说明这是 cursor 内置终端还是独立 PowerShell。第三是你已经做过的动作比如「内置终端关掉重开了报错一样」。拼成一段贴过去例如我在 Windows 的 cursor 内置终端PowerShell里敲 git --version回显 git : 无法将git项识别为 cmdlet、函数、脚本文件或可运行程序的名称。请检查名称的拼写如果包括路径请确保路径正确然后再试一次。 CategoryInfo : ObjectNotFound: (git:String) [], CommandNotFoundException 当前目录 PS D:\XX。我已经把 cursor 内置终端关掉重开还是同样报错。 请按两条线给我排查顺序1) Git 的 PATH 到底写进了用户级还是系统级2) 需不需要重启 cursor 本体而不是只重开内置终端。 只给我要在本地逐条执行的命令和判断标准不要替我执行。3.2 第一条线PATH 写入位置对不对Codex 大概率会先让你确认两件事git 的可执行文件在不在PATH 里有没有它对应的目录。这几条命令你在本地跑where.exe git有输出说明系统能找到它输出为空说明 PATH 里没有它。再看两份 PATH 各有什么[Environment]::GetEnvironmentVariable(Path, User) -split ; [Environment]::GetEnvironmentVariable(Path, Machine) -split ;用户级和系统级分开看是这一步的关键。很多人只改了用户级但某些启动路径下 cursor 继承的是系统级那份两份对不上就会继续报错。提示把上面两条命令的输出、where.exe git的结果一起贴回对话Codex 才能判断到底是「路径没写进去」还是「写进去了但没被读到」。3.3 第二条线要不要重启 cursor 本体如果where.exe git有输出、PATH 里也确实有 Git 目录但内置终端还是报旧错那基本就是 1.2 说的那个问题主进程揣着旧副本。排查方式很简单先把内置终端关掉重开一次如果还报错就把 cursor 整个退出——不是关窗口要在任务管理器里确认进程真的没了——再打开重新跑git --version。这一步只能你自己做Codex 没法替你去重启一个桌面应用。3.4 边界要划清Codex 只出方案命令你本地敲这一点必须说透。Codex 在这次排查里只做三件事读你贴的报错、列出检查顺序、告诉你每一步的判断标准。它不直接改你的系统 PATH也不会替你在机器上执行命令。where.exe、查两份 PATH、修改环境变量、重启 cursor都是你在本地按它给的顺序自己来。报错没跑通之前也不要让它去连别的东西——排查环境变量这件事本来就不需要任何外部连接。4. 本地逐条跑完git --version 回显版本号就算配通4.1 判断标准只有一条排障跑到最后判断标准很朴素在内置终端里敲git --version回显成git version 2.49.0.rc2.windows.1这类带版本号的输出就说明 PATH 生效、cursor 读到了新副本这条 cmdlet 报错翻篇。如果回显的还是CommandNotFoundException说明还有一条线没走完回到第 3 章按顺序再排一遍。4.2 回控制台看一眼这次调用记没记上排查过程里你和 Codex 来回了好几轮这些都会走模型通道。回到 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_content 的控制台翻一下用量记录看看这次调用有没有正常记上。记上了说明 Key 和 Base URL 都填对了一条都没有那要么是 Key 没生效——多半是setx之后没重开终端要么是base_url多写了/v1之类的后缀。4.3 还不行时的两个常见岔口一个是setx之后没重开终端环境变量没落地Codex 和 git 都读不到新值。另一个是 PATH 只改了用户级而 cursor 在某条启动路径下读到的是系统级那一份。这两个都是顺序问题不是 git 装坏了也不是 Codex 给错了方向。5. 报错翻篇之后把原文那条 git 路径走完5.1 git init从 PS D:\XX 开始记录版本切到你要备份的目录敲PS D:\XX git init看到Initialized empty Git repository或Reinitialized existing Git repository都算正常。从这一刻起这个文件夹下的代码版本就能开始记录了。5.2 git add . 和第一次 commit 的 Author identity unknown把所有当前文件纳入版本范围PS D:\XX git add .文件多的时候会刷一屏看着挺热闹。接着提交PS D:\XX git commit -m v1.0第一次提交常会遇到Author identity unknown这是让你填作者名和邮箱按提示来git config --global user.email youexample.com git config --global user.name Your Name不想全局生效就把--global去掉只在当前仓库设置。5.3 git log 与按 q 退出PS D:\XX git log里面那串 commit 哈希是后面回退要用的。如果界面卡住退不出来切到英文输入状态按q即可这是原文专门提过的一个小坑。5.4 git reset --hard回退前先看清 commitPS D:\XX git reset --hard commit-hashcommit-hash换成git log里你确认要回去的那个。这一步会覆盖工作区内容执行前务必确认没有未提交的改动。要推到远程再补git push -f同样先想清楚再敲。6. 排查闭环之后把 Codex 这条通道继续用起来6.1 先用模型对话验一把PATH 修好、Codex 也能正常回话说明 Key 和 Base URL 都对。想在网页上再确认一次模型 ID 有没有填错可以去 TaoToken 模型对话 用同一把 Key 发一条测试消息看返回是否正常。6.2 长期写代码看套餐Key 在控制台统一管如果后面打算长期让 Codex 参与排查和写代码可以到 Coding Plan 看看套餐够不够用Key 统一在 控制台 API Keys 创建和轮换。想对照 Claude Code 那边的环境变量写法参考 接入文档。这条 cmdlet 报错排查完顺手把这套通道固化下来下次再遇到别的环境问题Codex 随时能接上。