在 Win11 上装完 MSYS2 的 mingw-w64 工具链，pacman -S mingw-w64-x86_64-gcc 也跑完了，环境变量里加了 C:\msys64\mingw64\bin，重开终端敲 gcc --version 还是 command not found。VS Code 的 C/C++ Extension Pack 装了，调试却起不来，launch.json 里的 miDebuggerPath 指向的 gdb.exe 仿佛不存在。这种时候先把 TaoToken 的 Codex 接上：打开 https://taotoken.net/?utm_source=taotoken_aicg_blog_end 注册并创建 Key，Base URL 填 https://taotoken.net/api，让 Codex 读你本地的 pacman 记录、PATH 和 .vscode 下的 tasks.json、launch.json，按现象逐项比对 gcc、g++、gdb 的路径与任务名。下面按原文的安装顺序，把每一步最容易卡住的地方拆开。
1. Win11 下 MSYS2 装 mingw-w64：gcc 找不到先看这三处
1.1 pacman -S mingw-w64-x86_64-gcc 到底装到了哪个目录
MSYS2 的包管理和普通 Windows 安装程序不一样。你敲 pacman -S mingw-w64-x86_64-gcc，它会把 gcc 放进 C:\msys64\mingw64\bin，而不是 C:\msys64\usr\bin。很多人习惯把 MSYS2 的 usr\bin 加进 PATH，结果 gcc 怎么都找不到。先确认安装源：打开 MSYS2 MINGW64 终端，而不是 MSYS2 MSYS 终端，再跑一次 pacman -S mingw-w64-x86_64-gcc。如果提示 already installed，说明包在，但路径可能没加对。可以用 pacman -Ql mingw-w64-x86_64-gcc | grep bin/gcc 看包装到哪，列表里的路径就是真实位置。这一步不需要 Codex，自己看一眼就能排除“装错环境”的嫌疑。注意 MSYS2 还有 UCRT64、CLANG64 等环境，包名和安装目录都不一样；原文用的是 mingw64，所以 PATH 要指向 C:\msys64\mingw64\bin，别和 ucrt64\bin 混着加。
第一次更新建议先跑 pacman -Suy。这个过程中窗口可能提示关闭所有 MSYS2 相关进程，否则文件被占用，更新会卡住。更新完再装 base-devel 和 mingw-w64-x86_64-toolchain。toolchain 是个组包，会拉一堆编译工具，如果只想最小化，装 mingw-w64-x86_64-gcc 和 mingw-w64-x86_64-gdb 就够。注意 g++ 通常随 gcc 包一起进来，但验证时还是要单独跑 g++ --version，别只看 gcc。装完所有包，必须重开终端，不然 PATH 还是旧进程里的值。
1.2 C:\msys64\mingw64\bin 加进 PATH 后必须重开终端
把路径加进环境变量，顺序也重要。Win11 的“系统属性 → 高级 → 环境变量”里，Path 条目要新增一行 C:\msys64\mingw64\bin。如果你原来把 C:\msys64\usr\bin 放在前面，而 usr\bin 里也有一个同名的 gcc（通常是 MSYS2 自带的工具链），就可能先命中错的那个。加完之后，所有已经打开的终端、PowerShell、VS Code 都要关掉重开。PATH 是在进程启动时读取的，老窗口不会自动刷新。验证方法很直接：新开一个 PowerShell，敲 where.exe gcc。如果输出第一行不是 C:\msys64\mingw64\bin\gcc.exe，就说明 PATH 顺序或者路径本身有问题。把这个 where.exe 结果留着，后面贴给 Codex 时很有用。
这里有个容易忽略的细节：如果你在 VS Code 里打开的是 WSL 终端，或者在 MSYS2 终端里跑 where.exe，看到的路径可能和 Windows 原生 PowerShell 不一样。排障时先用独立的 PowerShell 或 CMD，不要用 VS Code 集成终端。集成终端可能继承了旧环境，也可能工作目录不同，容易把简单问题搞复杂。等 PowerShell 里三项都通过，再回 VS Code 验证任务配置。
1.3 用 where gcc 和 gcc --version 做最小验证
不要在 VS Code 的集成终端里下结论，先开独立的 PowerShell 或 CMD。依次跑：
where.exe gcc where.exe g++ where.exe gdb gcc --version g++ --version gdb --version如果 where.exe 能找到，但 gcc --version 报错，很可能是文件损坏或架构不对。如果 where.exe 什么都找不到，就回到 PATH。注意 PowerShell 里 where 是别名，最好写 where.exe。MSYS2 MINGW64 终端里也可以跑 which gcc，结果可能和 Windows PATH 不一致，因为 MSYS2 终端有自己的路径映射。以 PowerShell 的 where.exe 为准。三项都通过后，再进 VS Code 配任务。
如果 gdb --version 输出的是另一套工具链的 gdb，比如某 IDE 自带的，或者旧版 MinGW 留下的，调试时就会出现断点对不上、变量看不到的情况。最稳妥的办法是让 gcc、g++、gdb 全部来自 C:\msys64\mingw64\bin。可以在 PowerShell 里 where.exe gcc、where.exe g++、where.exe gdb 三条输出并排看一眼，前三行是否一致。不一致就把其他路径从 PATH 里挪到后面，或者直接删掉。
2. 让 Codex 走 TaoToken 读你的 .vscode 配置
2.1 在 https://taotoken.net/?utm_source=taotoken_aicg_blog_end 创建 Key，Base URL 填 https://taotoken.net/api
Codex 负责读文件、对照路径，TaoToken 负责给它一条可用的模型通道。先打开 TaoToken，注册登录后进入控制台创建 API Key。Key 是占位符，实际拿到后替换成 YOUR_API_KEY。接着在 Codex 的配置里把 Base URL 写成 https://taotoken.net/api，注意末尾不要加 /v1，也不要把官网地址填进去。模型 ID 不要自己编，去同一个站点的模型广场看当前可用列表，把对应的 ID 复制出来。这一步只解决“Codex 能不能用”的问题，不解决 gcc 路径；路径仍然靠本地命令和配置文件核对。
创建 Key 的时候，建议按用途分开：一个 Key 专门给 Codex 读本地配置，另一个留给别的工具。这样后面看用量时更容易判断是哪一步消耗多。Key 复制后只显示一次，存到密码管理器里，不要直接写进 tasks.json 或代码仓库。Base URL 填错最常见的两种写法是加了 /v1，或者把官网落地页粘进配置；前者会让请求路径多一段，后者根本不是 API 地址。记住：官网用于注册、创建 Key、看模型广场，Base URL 用于工具配置。
2.2 ~/.codex/config.toml 里写 model_provider 和 base_url
Windows 上 Codex 的配置文件一般在 %USERPROFILE%.codex\config.toml。没有就新建。写入自定义 provider：
model = "YOUR_MODEL_ID" model_provider = "taotoken" [model_providers.taotoken] name = "TaoToken" base_url = "https://taotoken.net/api" env_key = "TAOTOKEN_API_KEY"然后在系统环境变量里新增 TAOTOKEN_API_KEY，值填 YOUR_API_KEY。保存后重开终端，让 Codex 读取新配置。这里不要写 ANTHROPIC_BASE_URL 或 ANTHROPIC_AUTH_TOKEN，那是 Claude Code 的变量，套到 Codex 上会直接不生效。如果你同时用 Claude Code，可以分开配置文件，别把两套变量混在一个终端里。
模型 ID 这一项别照抄旧文章里的日期后缀。模型广场里列表会更新，以你打开 https://taotoken.net/?utm_source=taotoken_aicg_blog_end 时看到的为准。配置写完后，先在 Codex 里发一句“读一下当前目录的 .vscode/tasks.json”，确认它能正常返回内容。如果这一步就报错，先查 Key 和 Base URL，别急着去改 gcc 路径。
2.3 给 Codex 的提示词：把 pacman 命令、PATH、tasks.json 一起贴进去
Codex 不会自动知道你的环境，提示词要把现场信息带全。可以这样写： 我按原文在 Win11 上装了 MSYS2，命令是 pacman -S mingw-w64-x86_64-gcc、pacman -Suy、pacman -S base-devel，PATH 里加了 C:\msys64\mingw64\bin。现在 PowerShell 里 where.exe gcc 输出是……，gcc --version 输出是……。.vscode/tasks.json 内容如下：……。.vscode/launch.json 内容如下：……。请逐项检查 gcc、g++、gdb 的路径，tasks.json 的 label，launch.json 的 preLaunchTask 和 miDebuggerPath，指出不一致的地方。 把本地执行结果贴回去，而不是让 Codex 直接连你的机器跑命令。诊断命令由你在本地执行，Codex 只做比对和解释。
提示词里最好带上“不要改安装步骤，只做路径与配置核对”。这样 Codex 不会建议你重新卸载 MSYS2，也不会让你换一套完全不同的工具链。排障阶段最怕把环境越改越乱，先让 Codex 做只读分析，确认哪一行路径或任务名对不上，再动手改一个地方，重开终端验证一次。
3. tasks.json 与 launch.json 逐项核对：miDebuggerPath 和 preLaunchTask
3.1 tasks.json 的 label 是编译任务的身份证
VS Code 里先装 C/C++ Extension Pack，然后打开你的 C/C++ 项目文件夹，在 .vscode 下创建 tasks.json。这个文件负责编译，launch.json 负责启动调试，两者靠任务名绑定。一个能用的 tasks.json 可以长这样：
{ "version": "2.0.0", "tasks": [ { "label": "build with gcc", "type": "shell", "command": "C:\\msys64\\mingw64\\bin\\gcc.exe", "args": [ "-g", "${file}", "-o", "${fileDirname}\\${fileBasenameNoExtension}.exe" ], "group": { "kind": "build", "isDefault": true }, "problemMatcher": ["$gcc"] } ] }label 写成 build with gcc，后面 launch.json 的 preLaunchTask 就必须一模一样。command 可以直接写 gcc，前提是 PATH 已经生效；如果 PATH 总是不稳，写绝对路径 C:\msys64\mingw64\bin\gcc.exe 更保险。注意 JSON 里反斜杠要转义，写成双反斜杠。任务名里有空格没关系，但大小写和空格数量必须完全一致。
另外，args 里的 -g 不能省。没有 -g，gdb 找不到调试符号，断点能停下但看不到变量值。输出目录用 ${fileDirname}，生成的可执行文件会和源文件在同一个目录。如果你把源文件放在中文路径或带空格的目录下，尽量用 VS Code 变量，不要手写绝对路径，否则编译命令会被拆成多段。
3.2 launch.json 的 preLaunchTask 必须一字不差
launch.json 的 miDebuggerPath 和 preLaunchTask 是排障重点。一个对应的配置：
{ "version": "0.2.0", "configurations": [ { "name": "Debug C with gdb", "type": "cppdbg", "request": "launch", "program": "${fileDirname}\\${fileBasenameNoExtension}.exe", "args": [], "stopAtEntry": false, "cwd": "${fileDirname}", "environment": [], "externalConsole": false, "MIMode": "gdb", "miDebuggerPath": "C:\\msys64\\mingw64\\bin\\gdb.exe", "setupCommands": [ { "description": "Enable pretty-printing for gdb", "text": "-enable-pretty-printing", "ignoreFailures": true } ], "preLaunchTask": "build with gcc" } ] }preLaunchTask 如果写成 Build with gcc 或 build-with-gcc，VS Code 会找不到任务，调试还没开始就报错。miDebuggerPath 指向 C:\msys64\mingw64\bin\gdb.exe，不要指向 C:\msys64\usr\bin\gdb.exe，也不要指向其他 IDE 自带的 gdb。gdb 和 gcc 最好来自同一个工具链目录，架构保持一致。
还有一个隐藏点：launch.json 里的 program 路径要和 tasks.json 的输出路径完全对应。tasks.json 输出到 ${fileDirname}\${fileBasenameNoExtension}.exe，launch.json 的 program 也必须是同一个。如果一边改了输出目录，另一边没改，调试就会报 program does not exist。改完两个文件后，关闭 VS Code 再重开，让配置重新加载。
3.3 miDebuggerPath 指向 gdb.exe 的真实位置
先手动确认 gdb 在哪：
where.exe gdb如果输出不是 C:\msys64\mingw64\bin\gdb.exe，就按实际输出改 launch.json。有人装的是 mingw-w64-x86_64-gdb，路径在 mingw64\bin；有人只装了 gcc 没装 gdb，where.exe 会报 INFO: Could not find files。那就回到 MSYS2 MINGW64 终端补：
pacman -S mingw-w64-x86_64-gdb装完重开终端，再 where.exe gdb 确认。把 where.exe gcc、where.exe g++、where.exe gdb 三条输出和两个 JSON 文件一起发给 Codex，它能很快指出哪一行路径和实际不符。注意 Codex 只能看文本、比对，不能替你运行 gdb；运行和贴回输出的动作仍然在你本地完成。
如果你在 PATH 里看到多个 gdb.exe，按顺序取第一个。Windows 的 where.exe 默认按 PATH 顺序输出，第一个就是实际会执行的。把第一个和 launch.json 里的 miDebuggerPath 对齐，比盲改配置快得多。
4. VS Code 调试起不来时的报错对照
4.1 报错 program ... does not exist：先看可执行文件有没有生成
调试时弹 “program 'xxx.exe' does not exist”，多数不是 gdb 的错，而是编译任务没生成 exe。检查 tasks.json 的 args 里有没有 -g，输出目录是不是 ${fileDirname}。如果源文件路径里有中文或空格，尽量用 VS Code 变量，不要手写绝对路径。先在终端手动跑一次：
C:\msys64\mingw64\bin\gcc.exe -g .\main.c -o .\main.exe如果手动能生成，VS Code 里不能，就是任务配置问题。把 tasks.json、launch.json 和这条手动命令的结果贴给 Codex，让它对照 ${file} 与 ${fileBasenameNoExtension} 的展开结果。注意手动编译由你在本地执行，Codex 只解释差异。
还有一种情况：源文件还没保存。VS Code 的 ${file} 指向磁盘上的文件，未保存的修改不会编译进去。调试前按 Ctrl+S，再跑一次。这个低级问题在排障时经常被忽略，但 Codex 看配置也看不出来，只能靠你本地确认。
4.2 报错 Unable to start debugging：gdb 路径与架构不匹配
“Unable to start debugging. Unexpected GDB output” 或者 “miDebuggerPath is invalid”，先看 miDebuggerPath 是否真实存在。Win11 的资源管理器里打开 C:\msys64\mingw64\bin，确认 gdb.exe 在不在。如果用的是 32 位 mingw32 的 gdb 去调 64 位 gcc 编出来的 exe，也会起不来。统一用 mingw64 这一套：gcc、g++、gdb 都来自 C:\msys64\mingw64\bin。如果之前 PATH 里混入了其他工具链，先在 PowerShell 里 where.exe gcc 和 where.exe gdb 看前三行，把不一致的路径从 PATH 里移掉。
如果 gdb.exe 存在但报错依旧，试试在 PowerShell 里直接运行：
C:\msys64\mingw64\bin\gdb.exe --version能输出版本号，说明 gdb 自身没问题，问题在 VS Code 配置或架构匹配。把 gdb --version 的输出贴给 Codex，让它对照 miDebuggerPath 和 MIMode 字段。MIMode 保持 gdb，不要改成 lldb 或 vsdbg。
4.3 报错 preLaunchTask ... terminated with exit code：任务名或编译器路径错
“preLaunchTask 'build with gcc' terminated with exit code 1” 说明任务跑了但编译失败，常见原因是 command 里写的 gcc 不是你要的那个，或者源文件语法错误。先看 VS Code 终端面板里的完整编译输出。如果提示 gcc: command not found，说明任务运行环境没继承 PATH；把 tasks.json 的 command 改成绝对路径 C:\msys64\mingw64\bin\gcc.exe。如果提示找不到 preLaunchTask，那就是 label 对不上。这两类错误都可以把终端输出和两个 JSON 文件一起发给 Codex，让它逐行比对。
还有一种 exit code 1 是编译器本身返回的，比如代码里有语法错误。这种情况 Codex 能帮你读报错行，但编译动作仍然由本地 gcc 执行。先把 VS Code 终端里的第一行错误复制出来，再连同 tasks.json 一起发给 Codex，让它区分是路径问题还是代码问题。
5. 验证通过后：去模型对话和控制台对一次调用
5.1 用同一把 Key 在模型对话里发测试消息
gcc、g++、gdb 都能输出版本号后，VS Code 里按 F5 也能停在断点，这套 C/C++ 环境就算通了。顺手验证一下 Codex 的通道：在 TaoToken 模型对话 里用同一把 Key 发一条测试消息，确认模型 ID 和 Base URL 没写错。如果对话正常，再回到 Codex 里让它读一次 tasks.json，看它能不能准确说出 miDebuggerPath 和 preLaunchTask 的对应关系。这一步能同时确认两件事：本地 C/C++ 环境可用，Codex 的配置也真的生效了。
如果模型对话里报 401，先回 ~/.codex/config.toml 看 env_key 指向的环境变量是不是 TAOTOKEN_API_KEY，再确认环境变量值里没有多余空格。如果报 404，检查 Base URL 是不是多加了 /v1。这两个错在排障时最常见，但和 gcc 路径无关，别混在一起改。
5.2 看用量、换模型、下一步
长期用 Codex 查环境问题，Key 的消耗会慢慢累积。打开 https://taotoken.net/?utm_source=taotoken_aicg_blog_end 的控制台，能看到这次测试调用记了多少用量；如果打算把 Codex 用在日常编码上，可以顺便看一眼 Coding Plan 的套餐是否够用。需要新 Key 时，在 控制台 API Keys 创建，仍然用 YOUR_API_KEY 占位。模型广场里模型 ID 有更新时，记得同步修改 ~/.codex/config.toml 的 model 字段。
gcc --version 通过之后，这套 MSYS2 + mingw-w64 + VS Code 的 C/C++ 环境就稳定了。下次再遇到 command not found，先跑 where.exe gcc，再跑 gcc --version，然后把两条输出和 .vscode 下两个 JSON 文件一起丢给 Codex，按路径、任务名、调试器三个点逐项对。排障顺序固定下来，比每次重装环境省时间。
