前言很多 Windows 用户第一次接触 Codex最容易卡住的不是“它能不能写代码”而是到底应该怎么装CLI、WSL、IDE 扩展怎么选安装后为什么命令识别不了为什么 VS Code 里和终端里不是同一个环境为什么 Codex 能读代码却不能正常跑项目卸载时哪些配置需要清理这些问题如果一开始没想清楚后面很容易越配越乱。Codex 本质上是 AI 编程代理。它不只是回答代码问题还可以在你授权的项目目录里读取文件、修改代码、运行命令、解释报错、补测试和整理变更。也正因为它能力比较强所以 Windows 用户更要先处理好环境和权限边界。这篇文章不做命令堆砌而是按实际使用流程把 Windows 上安装、配置、使用和卸载 Codex 的关键点梳理一遍。一、Windows 上使用 Codex 有几种方式Windows 用户常见有四种入口。使用方式适合人群特点Codex CLI熟悉终端的开发者适合读项目、改代码、跑测试WSL2 CLILinux 工具链项目更接近 Linux 开发环境Codex Windows app想要图形界面的用户操作直观适合管理多个任务IDE 扩展VS Code / Cursor / JetBrains 用户和日常编辑器工作流结合更紧如果你是新手建议优先从 IDE 扩展或 Windows app 开始。如果你是开发者平时习惯命令行可以直接用 CLI。如果你的项目依赖 Linux 环境比如 Node、Python、Go、Shell、Docker 相关项目建议优先考虑 WSL2。不要一开始把所有方式都装一遍。先选一个最符合自己工作流的入口跑通再考虑其他方式。二、安装前先检查基础环境在安装 Codex 前建议先确认 Windows 开发环境。打开 PowerShell 或 Windows Terminal执行git --version如果你打算使用 Node 项目可以继续检查node --version npm --version如果你打算使用 Python 项目可以检查python --version pip --version这些不是所有情况下都必须但很多项目本身需要这些运行环境。Codex 可以帮你写代码、修 Bug、跑命令但它不能替你凭空补齐本地项目缺少的依赖。如果项目本身跑不起来Codex 也只能根据日志帮你排查。三、方式一Windows 原生安装 Codex CLI如果你的项目就在 Windows 本地目录比如D:\code\my-project并且你平时习惯使用 PowerShell 或 Windows Terminal可以直接安装 Codex CLI。官方 Windows 安装方式可以使用 PowerShell 脚本powershell -ExecutionPolicy ByPass -c irm https://chatgpt.com/codex/install.ps1 | iex安装完成后重新打开终端验证codex --version如果能看到版本号说明安装成功。然后进入项目目录cd D:\code\my-project codex第一次运行时按提示完成登录。这里建议新手第一条指令不要让它改代码而是先让它只读项目请先阅读当前项目不要修改任何文件。 请输出 1. 项目主要功能 2. 技术栈 3. 目录结构 4. 启动方式 5. 测试方式 6. 你建议我优先阅读的文件。先让 Codex 理解项目再让它执行具体任务会安全很多。四、方式二在 WSL2 中使用 Codex如果你的项目更接近 Linux 环境建议使用 WSL2。比如前端工程Node 后端Python 服务Go 项目Shell 脚本Docker 相关项目Linux 运维工具。安装 WSL2wsl --install安装完成后重启电脑进入 Ubuntu 环境。在 WSL 中检查基础工具git --version node --version python3 --version如果缺少基础工具可以先安装sudo apt update sudo apt install -y git curl然后在 WSL 中安装 Codex CLIcurl -fsSL https://chatgpt.com/codex/install.sh | sh验证codex --versionWSL 用户要特别注意项目路径。不建议长期在/mnt/c/Users/...下面运行大型项目因为可能遇到性能、权限、文件监听等问题。更推荐把项目放在 WSL 用户目录下mkdir -p ~/code cd ~/code git clone your-repo-url cd your-repo codex这样 Codex 读写文件、执行测试和处理依赖会更稳定。五、方式三使用 Codex Windows app如果你不喜欢一直在终端里操作可以使用 Codex Windows app。这种方式适合想要图形界面的人希望管理多个 Codex 任务的人不想频繁输入命令的人需要更直观看到任务状态和变更的人。安装时建议从官方入口下载不建议使用不明来源的离线安装包。安装完成后第一次打开按提示登录账号。使用 app 时也要注意权限边界。不要一上来就让它处理整个项目。可以先让它做只读分析再做小范围修改。六、方式四IDE 扩展如果你平时主要在 VS Code、Cursor、Windsurf 或 JetBrains 系列 IDE 里写代码IDE 扩展会更顺手。以 VS Code 为例打开 VS Code进入扩展市场搜索 Codex安装扩展重启 VS Code按提示登录账号打开项目开始使用。IDE 扩展适合做这些任务解释当前文件总结项目结构检查代码问题补单元测试生成小范围修改审查 diff根据报错日志排查问题。第一次使用时同样建议先只读请阅读当前打开的项目。 不要修改任何文件。 请总结项目结构、核心模块和启动方式。等确认它理解项目后再让它动手改代码。七、CLI、WSL、App、IDE 怎么选可以按下面这个表判断你的情况推荐方式习惯 PowerShellWindows 原生 CLI项目依赖 Linux 命令WSL2 CLI前端 / 后端项目在 WSL 中WSL2 VS Code Remote想要图形化任务管理Codex Windows app日常写代码主要靠 VS CodeIDE 扩展使用 Cursor / WindsurfIDE 扩展使用 JetBrains IDE对应 IDE 集成新手只想体验App 或 IDE 扩展重要项目开发CLI / IDE Git 人工 Review我的建议是新手优先 IDE 或 app。开发者优先 CLI。Linux 工具链项目优先 WSL。重要项目一定配合 Git 和测试。八、配置文件在哪里Codex 的配置通常在用户目录下。常见路径是~/.codex/config.toml如果你在 Windows 原生环境使用 Codex对应的是 Windows 用户目录下的.codex文件夹。如果你在 WSL 中使用 Codex对应的是 Linux 用户目录下的.codex文件夹。这两个不是同一个位置。所以很多人会遇到我明明登录过为什么 WSL 里还要重新登录我明明配置过为什么 Windows 里读不到我明明改了配置为什么 VS Code 里没生效多数时候是因为你混用了 Windows 原生环境和 WSL 环境。刚开始使用时不建议改太多配置。先保持默认设置把登录、读取项目、小范围修改跑通再去调整审批策略、沙箱权限、模型和项目规则。九、项目规则比安装命令更重要Codex 不是只看你当前一句提示词它还需要理解项目边界。建议在项目里准备一份规则说明告诉 Codex项目怎么启动怎么运行测试哪些目录不能改能不能新增依赖修改前是否需要说明方案数据库、权限、支付相关代码是否必须确认。示例项目规则 1. 本项目使用 TypeScript。 2. 修改代码后需要运行 npm test。 3. 不允许修改 dist、build、node_modules 目录。 4. 不要新增第三方依赖除非先说明原因。 5. 涉及数据库、权限、支付相关代码时必须先询问用户。 6. 每次修改后请说明改动文件和原因。这类规则很实用。AI 编程助手越强越需要边界。十、第一次使用 Codex建议这样开始很多人第一次用 Codex会直接输入帮我优化整个项目。这句话风险很高。因为任务太大边界太模糊。更推荐按下面流程来。1. 只读项目请阅读当前项目不要修改任何文件。 请输出 1. 项目主要功能 2. 技术栈 3. 目录结构 4. 启动方式 5. 测试方式 6. 你建议我优先了解的文件。2. 解释单个文件请解释 src/services/userService.ts 这个文件的作用。 不要修改代码只说明它负责什么以及和其他模块的关系。3. 找问题但不修改请检查这个文件是否存在明显的 Bug、边界条件遗漏或异常处理问题。 暂时不要修改代码只列出问题。4. 只修一个点请只修复上面第 2 个问题。 要求 1. 不修改无关文件 2. 不新增第三方依赖 3. 保持现有代码风格 4. 修改后说明变更点 5. 给出测试建议。5. 看 diff 再决定修改完成后不要直接接受。重点检查改了哪些文件有没有改无关代码有没有新增依赖有没有删除重要逻辑有没有修改配置文件测试是否能跑通。十一、Windows 常见问题排查1.codex不是内部或外部命令可能原因安装没有成功终端没有重启环境变量没有刷新安装路径没有加入 PATH。可以检查where codex codex --version如果找不到命令重新打开终端或重新安装。2. PowerShell 执行脚本被拦截可以使用powershell -ExecutionPolicy ByPass -c irm https://chatgpt.com/codex/install.ps1 | iex如果是公司电脑可能受到 IT 策略限制需要管理员权限。3. WSL 中找不到项目如果项目在 Windows 盘里WSL 中通常可以通过/mnt/c/访问。但更推荐把项目放到 WSL 用户目录~/code/my-project这样性能和权限问题更少。4. VS Code 打开的不是 WSL 环境如果你项目在 WSL 中VS Code 左下角应该显示 WSL 状态。可以使用WSL: Reopen Folder in WSL确保编辑器和终端处在同一个环境里。5. Codex 修改太多文件说明任务边界太宽。可以明确限制只允许修改以下文件 src/utils/date.ts src/utils/date.test.ts 不要修改其他文件。 如果必须修改请先说明原因并等待确认。十二、卸载 Codex1. 卸载 CLI先查看命令位置where codex如果是 npm 安装可以尝试npm uninstall -g openai/codex如果是官方安装脚本安装按官方说明或安装目录提示清理。卸载后验证codex --version如果提示找不到命令说明 CLI 基本移除。2. 卸载 IDE 扩展以 VS Code 为例打开扩展面板搜索 Codex点击卸载重启 VS Code。Cursor、Windsurf、JetBrains 也要分别在对应扩展管理页面卸载。3. 清理配置文件Windows 原生环境可以检查dir $env:USERPROFILE\.codex如果确认不再使用可以删除Remove-Item -Recurse -Force $env:USERPROFILE\.codexWSL 中可以检查ls ~/.codex删除rm -rf ~/.codex删除配置前请确认里面没有要保留的项目规则和登录配置。十三、使用 Codex 的安全建议1. 先做 Git 检查点让 Codex 修改代码前先看工作区git status如果当前改动重要先提交git add . git commit -m backup before codex task2. 不要一上来给最大权限Codex 可以读写文件、运行命令。这很方便也有风险。新手建议先只读再小范围修改。3. 危险命令必须人工确认看到下面这类命令要谨慎rm -rf del /s /q rmdir /s /q DROP TABLE chmod -R curl ... | sh涉及删除、覆盖、数据库、权限、生产环境的操作不要让 AI 自动执行。4. 不要暴露敏感信息不要直接给 Codex真实 API Key生产数据库密码用户隐私数据公司内部敏感文档未脱敏日志支付和鉴权信息。5. 不要无脑接受修改Codex 写的代码也要 Review。重点看是否改了无关文件是否新增依赖是否删除重要逻辑是否影响权限是否有测试覆盖。十四、常用提示词模板1. 项目理解请阅读当前项目不要修改任何文件。 请输出 1. 项目主要功能 2. 技术栈 3. 目录结构 4. 启动方式 5. 测试方式 6. 我应该优先阅读哪些文件。2. Windows 环境排查我在 Windows 上运行项目时报错。 请根据下面日志帮我分析 1. 可能原因 2. 是否和路径、权限、环境变量有关 3. 推荐排查顺序 4. 是否建议放到 WSL 中运行。 暂时不要修改代码。3. 小范围修改请只修改以下文件 【文件路径】 目标 【具体任务】 要求 1. 不修改无关文件 2. 不新增第三方依赖 3. 保持现有代码风格 4. 修改后说明变更点 5. 给出测试建议。4. 代码审查请审查这次修改。 重点关注 1. 是否引入 Bug 2. 是否影响现有功能 3. 是否有边界条件遗漏 4. 是否需要补测试 5. 是否存在 Windows / Linux 路径兼容问题。 只输出审查意见不要直接修改。总结Windows 上使用 Codex安装只是第一步。真正决定体验的是你选择 CLI、WSL、app 还是 IDE你的项目放在哪个环境配置文件是否清楚权限边界是否明确是否先读项目再修改是否检查 diff 和跑测试。如果是新手建议先用 IDE 扩展或 Windows app。如果是开发者可以优先 CLI。如果项目依赖 Linux 工具链建议使用 WSL2。如果是重要项目一定要配合 Git、测试和人工 Review。Codex 的价值不是让你无脑交出项目而是帮你更快理解代码、更快定位问题、更快完成小范围修改。最后一句话Windows 上用 Codex别只会复制安装命令。真正重要的是选对环境、控制权限、看懂变更。点此进入ChatGPTplus/Pro开通渠道有质保有发票参考来源Codex国内怎么开通没有海外卡能不能用2026 年国内用户开通 ChatGPT Plus低价渠道少了以后稳定性反而更重要ChatGPT Plus 和 Pro 怎么选普通用户别再乱花钱了2026年国内用户开通 ChatGPT Plus真正要注意的不是付款而是这几件事没有海外信用卡怎么开通 ChatGPT Plus国内用户先看这几种方式