必须将项目、Codex CLI和VS Code置于WSL同一Linux文件系统（如/home/用户名/workspace/），禁用/mnt/c/路径；否则因NTFS不支持inotify导致监听失败、命令静默退出；需执行codex init初始化并确保Node 22+与沙箱就绪，日常通过codex read/edit/run闭环操作，VS Code须以Remote-WSL模式打开项目。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
在WSL中用Codex CLI操作项目，必须让代码文件、CLI运行环境、VS Code编辑器三者处于同一Linux文件系统层级，否则文件读写权限错乱、路径解析失败、沙箱无法挂载项目目录。
确认项目存放位置在WSL内部
打开WSL终端，执行pwd，确保当前路径是/home/用户名/下的子目录（如~/workspace/my-app），而不是/mnt/c/Users/...这种Windows挂载路径。Codex CLI对/mnt/c下的文件有严重兼容问题：它会尝试用Linux内核机制监听文件变更，但NTFS挂载点不支持inotify事件，导致watch超时、生成内容不刷新、【codex run】命令静默退出。
如果项目还在Windows侧，立刻迁移：mkdir -p ~/workspace && cp -r /mnt/c/Users/Alice/dev/my-app ~/workspace/。
进入项目并初始化Codex工作区
执行cd ~/workspace/my-app，然后运行codex init。这一步会创建.codex/目录并写入默认配置，同时检测Node.js版本和沙箱可用性。若提示“Node version too low”，说明你没按规范装Node 22+，请回退重装nvm+Node 25；若提示“sandbox not ready”，大概率是之前用sudo装过codex，残留root属主二进制文件，需先执行sudo npm uninstall -g @openai/codex && rm -f /usr/bin/codex再重装。
初始化成功后，.codex/config.json里会自动填入当前绝对路径作为projectRoot，这是后续所有文件操作的锚点。
日常操作：读代码→改文件→跑验证
第一步：用codex read src/index.ts把文件内容喂给模型，它会自动识别TS语法并摘要逻辑；
通过本地 Codex 或 OpenClaw OAuth 凭证直接调用 ChatGPT/Codex Responses 的 image_generation 工具来生成或编辑光栅图像，然后保存
第二步：执行codex edit --file src/utils.ts --instruction "把formatDate函数改成支持ISO 8601输出"，Codex会在沙箱中修改文件并生成diff预览；
第三步：确认无误后输入y应用修改，此时文件真实写入WSL磁盘；
第四步：立即用codex run --command "npm test"在项目根目录下启动测试流程——注意--command值必须是shell可执行字符串，不能带cd前缀，因为Codex始终以projectRoot为工作目录。
VS Code联动技巧
方法一：直接在VS Code里打开WSL远程窗口（Ctrl+Shift+P → “Remote-WSL: New Window”），然后打开~/workspace/my-app文件夹。此时所有编辑操作实时同步到WSL文件系统，codex read能精准定位光标所在文件。
方法二：在VS Code终端里（不是Windows PowerShell）执行codex explain --file README.md，输出结果会自动渲染成富文本，点击「Insert as comment」可一键插入注释块。
方法三：配置快捷键绑定——在VS Code设置里搜索「codex」，启用「Codex: Run Selected Text」，选中一段JS代码按快捷键，Codex自动将其作为prompt上下文执行推理。
