一、适合谁这份教程适合三类人第一次使用 Codex CLI 做项目的新手。想用 Codex 辅助写代码、修 Bug、重构项目的人。想在 OpenAI / DeepSeek 等模型之间灵活切换的人使用国内大模型。二、Windows 环境安装1. 安装 Node.js 和 Python打开 PowerShell先检查是否已安装node -v npm -v python --version pip --version如果没有安装可以使用 wingetwinget install -e --id Python.Python.3.12 --source winget winget install -e --id OpenJS.NodeJS.LTS --source winget安装后重新打开 PowerShell再检查node -v npm -v python --version pip --version如果python或pip没有识别优先检查py --version py -m pip --version2. 配置 npm 国内镜像国内网络环境建议配置 npm 镜像npm config set registry https://registry.npmmirror.com npm config get registry恢复官方源npm config set registry https://registry.npmjs.org3. 安装 Codex CLI推荐方式一使用 npm 安装。npm install -g openai/codex codex --version如果 npm 全局安装权限异常可以尝试官方 Windows 安装脚本powershell -ExecutionPolicy ByPass -c irm https://chatgpt.com/codex/install.ps1 | iex安装后验证codex --version启动codex三、集成国内DeepSeek、Qwen普通代码开发优先 DeepSeek前端截图/多模态/图片素材优先 Qwen。deepseek-v4-flash日常开发、便宜、速度快deepseek-v4-pro复杂 Bug、重构、架构分析1.配置 via Relay1. 安装 codex-relaypython -m pip install --upgrade pip pip install codex-relay2. 配置 deepseek主要写代码、修 Bugsetx DEEPSEEK_API_KEY sk-xxxx重新打开 PowerShell检查echo $env:DEEPSEEK_API_KEY如果能输出 key说明生效。启动relay单独打开一个 PowerShell 窗口运行$env:CODEX_RELAY_UPSTREAMhttps://api.deepseek.com/v1 $env:CODEX_RELAY_API_KEY$env:DEEPSEEK_API_KEY $env:CODEX_RELAY_PORT4446 codex-relay配置Codexnotepad $env:USERPROFILE\.codex\config.toml写入model deepseek-v4-flash model_provider deepseek-relay [model_providers.deepseek-relay] name DeepSeek via Relay base_url http://127.0.0.1:4446/v1 wire_api responses env_key DEEPSEEK_API_KEY复杂任务可以改成model deepseek-v4-pro3.配置 Qwen上传截图、看 UI、根据图片修前端Qwen-Coder写代码Qwen-VL看截图、分析页面问题Qwen-Image / Wan生成前端素材图setx DASHSCOPE_API_KEY sk-xxxx重新打开 PowerShell检查echo $env:DASHSCOPE_API_KEY如果能输出 key说明生效。启动relay单独打开一个 PowerShell 窗口运行$env:CODEX_RELAY_UPSTREAMhttps://dashscope.aliyuncs.com/compatible-mode/v1 $env:CODEX_RELAY_API_KEY$env:DASHSCOPE_API_KEY $env:CODEX_RELAY_PORT4447 codex-relay配置Codexnotepad $env:USERPROFILE\.codex\config.toml写入model qwen-coder-plus model_provider qwen-relay [model_providers.qwen-relay] name Qwen via Relay base_url http://127.0.0.1:4447/v1 wire_api responses env_key DASHSCOPE_API_KEY复杂任务可以改成model deepseek-v4-pro四、开始使用Codexcd D:\你的项目目录codex五、提示词模板1.从0创建项目通用版请从 0 到 1 创建一个 Todo Web Demo。 技术要求 1. Node.js Express 2. 前端使用原生 HTML/CSS/JavaScript 3. 不使用数据库Todo 数据保存在内存 4. 支持新增、完成、删除、筛选 Todo 5. 提供 REST API 6. 提供 README.md 7. 提供基础测试或自检脚本 工作方式 1. 先给出项目结构和实现计划不要立刻写代码 2. 等我确认后再创建文件 3. 每次修改前说明要改什么 4. 修改后运行 npm install 5. 运行测试或启动检查 6. 最后总结如何启动项目2.正式创建项目按刚才的计划创建项目文件。 要求 1. 创建 package.json 2. 创建 server.js 3. 创建 public/index.html 4. 创建 public/style.css 5. 创建 public/app.js 6. 创建 README.md 7. 创建一个简单测试脚本或测试文件 8. 完成后运行 npm install 9. 再运行一次测试或启动检查 请每次修改前简要说明你要改什么。3.README 优化提示词请重新整理 README.md要求适合新手阅读。 必须包含 1. 项目简介 2. 技术栈 3. 功能列表 4. 项目目录结构 5. 安装方法 6. 启动方法 7. 测试方法 8. API 接口说明 9. 常见问题 10. 后续可优化方向 要求 1. 语言清晰 2. 步骤完整 3. 命令可直接复制 4. 不要写空泛内容4.迭代优化问法请检查当前项目帮我做一次小优化。 目标 1. 给 Todo 增加“全部 / 未完成 / 已完成”筛选功能 2. 优化页面样式让它看起来像一个简洁的卡片式应用 3. 不要引入前端框架 4. 保持代码适合新手理解 5. 修改后请运行测试或启动检查 6. 最后说明你改了哪些文件以及为什么这样改5.修 Bug 标准问法Qwen我运行后出现以下报错 【粘贴报错内容】 请你 1. 先判断原因 2. 不要马上修改代码 3. 给我 2-3 个可能的修复方案 4. 推荐最稳妥的方案 5. 等我确认后再改代码6.Codex直接修bugQwen我运行项目时出现以下报错 【粘贴报错内容】 请你直接修复但要遵守 1. 先定位问题文件 2. 尽量做最小改动 3. 不要重写无关代码 4. 修改后运行测试或启动检查 5. 最后说明报错原因、修改内容和验证结果7.重构代码请帮我重构当前项目。 重构目标 1. 保持现有功能不变 2. 提高代码可读性 3. 拆分过长函数 4. 删除重复代码 5. 改善变量命名 6. 不引入新框架 7. 修改后运行测试确保功能不变 工作方式 1. 先分析当前代码问题 2. 给出重构计划 3. 再开始修改 4. 每次修改尽量小步提交 5. 最后总结重构前后变化8.添加测试请为当前项目添加基础测试。 要求 1. 测试主要 REST API 2. 覆盖新增 Todo、获取 Todo、完成 Todo、删除 Todo 3. 测试命令写入 package.json 4. 不要引入过重的测试框架 5. 测试要适合新手理解 6. 添加后运行测试并修复失败项 7. 最后说明如何执行测试9.代码审查对当前项目做一次代码审查。 请从以下角度检查 1. 代码结构 2. 命名是否清晰 3. 是否有重复代码 4. 是否有潜在 Bug 5. 是否有安全风险 6. 是否有性能问题 7. 是否适合新手维护 8. 可以优先优化的 3 个点 先不要修改代码只输出审查报告。10.UI 美化Qwen请优化当前页面 UI。 要求 1. 保持原生 HTML/CSS/JavaScript 2. 不引入前端框架 3. 页面风格简洁、现代、卡片式 4. 支持移动端 5. 按钮、输入框、列表要有清晰层次 6. 保持现有功能不变 7. 修改后运行项目检查11.根据截图修改页面Qwen我会提供一张目标页面截图。 请先不要修改代码。 请先根据截图分析 1. 页面整体布局 2. 颜色风格 3. 字体和间距 4. 组件结构 5. 当前项目需要改哪些文件 6. 最小实现方案 等我确认后再修改。