Win11上WSL2运行Codex卡顿需四步排查：①安装VC++运行库并重启；②重置WSL2为NAT+DNS隧道模式；③项目迁移至WSL原生路径（非/mnt/c/）；④清理.codex目录下膨胀的SQLite日志与状态库。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
Win11系统上通过WSL2运行Codex时出现启动慢、响应迟滞、终端界面卡顿、VS Code中长期显示“Thinking…”等现象，不是模型退化或网络服务端问题，而是本地环境配置与资源分配失衡导致的底层运行阻塞，需从运行库、WSL网络模式、文件系统路径、状态库膨胀四个维度逐层排查。
确认并修复VC++运行库缺失
打开任务管理器（Ctrl+Shift+Esc），观察Codex启动瞬间是否高频调用powershell.exe和cmd.exe——若持续超60秒且无Codex主进程创建，大概率是VC++运行库未安装，导致Rust/Node原生组件根本无法加载。
访问微软官方页面下载vc_redist.x64.exe，双击运行→点“安装”→等待完成。
【安装后必须重启电脑】，否则系统DLL缓存仍指向空缺路径，Codex点击图标后依旧静默退出，不报错也不弹窗。
重置WSL2网络模式为NAT并启用DNS隧道
当前卡顿若伴随curl https://github.com报“Could not resolve host”，或wsl终端中cat /etc/resolv.conf返回空或错误IP，说明WSL DNS配置已被破坏，而Codex CLI依赖稳定域名解析发起token exchange请求。
方法一：强制恢复默认安全网络栈
在Windows中打开记事本，输入以下内容并保存为C:\Users\%USERNAME%\.wslconfig：
[wsl2]
networkingMode=NAT
dnsTunneling=true
autoProxy=false
保存后以管理员身份运行PowerShell，执行：wsl --shutdown → 关闭所有WSL终端 → 重新打开Ubuntu终端，输入cat /etc/resolv.conf，确认输出含nameserver 172.x.x.1（即Windows主机网关）。
方法二：若你曾手动修改过/etc/resolv.conf或启用mirrored模式，请先删除该文件，再执行上述.wslconfig写入步骤——【WSL不允许同时存在手动resolv.conf和dnsTunneling=true】，否则DNS彻底失效。
迁移项目至WSL原生路径并禁用9P跨系统访问
VS Code中Codex卡在“Thinking…”但wsl终端能ping通Google，说明网络通路已建立，问题出在文件系统层：Codex插件尝试扫描项目目录时，若路径位于/mnt/c/Users/xxx/project，会触发9P协议频繁跨VM读取，I/O堆积导致UI线程挂起。
第一步：确认当前路径是否踩坑
通过本地 Codex 或 OpenClaw OAuth 凭证直接调用 ChatGPT/Codex Responses 的 image_generation 工具来生成或编辑光栅图像，然后保存
在WSL终端中执行：df -T .，若输出中Type列为9p，立即停止操作，当前路径不可用于Codex开发。
第二步：创建原生工作区
执行：mkdir -p ~/projects/codex-demo && cd ~/projects/codex-demo，然后在此路径下克隆或初始化项目。
第三步：VS Code中重新连接WSL，用Remote-WSL打开~/projects/codex-demo，而非任何/mnt/开头路径。
这一步做完，Codex插件的文件监听开销下降80%以上，不再因扫描Windows NTFS元数据而卡死。
清理Codex本地状态库避免SQLite写入阻塞
关闭Codex桌面端与所有WSL终端，按Win+R输入%USERPROFILE%\.codex回车，进入该目录。
重点检查：logs_2.sqlite（正常应＜20MB）、state_5.sqlite（必须能被DB Browser for SQLite正常打开）、codex-tui.log（单文件＞1GB即触发启动扫描风暴）。
方法一：改名隔离法（零风险）
将上述三个文件分别重命名为：logs_2.sqlite.old、state_5.sqlite.old、codex-tui.log.old。
方法二：归档旧会话减压
进入sessions/目录，将30天内未访问且未置顶的子目录，全部剪切到桌面新建的codex-sessions-archive文件夹中。
完成后启动Codex，它将自动重建轻量级状态库，首次启动时间从分钟级回落至3秒内。
