news 2026/7/12 18:30:26

Codex CLI Windows 从 0 到 1 实战手册：安装、模型切换、提示词库与 Demo（国内模型）

作者头像

张小明

前端开发工程师

1.2k 24
文章封面图
Codex CLI Windows 从 0 到 1 实战手册：安装、模型切换、提示词库与 Demo（国内模型）

一、适合谁

这份教程适合三类人：

  1. 第一次使用 Codex CLI 做项目的新手。

  2. 想用 Codex 辅助写代码、修 Bug、重构项目的人。

  3. 想在 OpenAI / DeepSeek 等模型之间灵活切换的人（使用国内大模型）。

二、Windows 环境安装

1. 安装 Node.js 和 Python

打开 PowerShell，先检查是否已安装：

node -v npm -v python --version pip --version

如果没有安装，可以使用 winget：

winget 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 --version

2. 配置 npm 国内镜像

国内网络环境建议配置 npm 镜像：

npm config set registry https://registry.npmmirror.com npm config get registry

恢复官方源：

npm config set registry https://registry.npmjs.org

3. 安装 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 Relay

1. 安装 codex-relay

python -m pip install --upgrade pip pip install codex-relay

2. 配置 deepseek（主要写代码、修 Bug）

setx DEEPSEEK_API_KEY "sk-xxxx"

重新打开 PowerShell，检查：

echo $env:DEEPSEEK_API_KEY

如果能输出 key，说明生效。

启动relay

单独打开一个 PowerShell 窗口，运行：

$env:CODEX_RELAY_UPSTREAM="https://api.deepseek.com/v1" $env:CODEX_RELAY_API_KEY=$env:DEEPSEEK_API_KEY $env:CODEX_RELAY_PORT="4446" codex-relay

配置Codex

notepad $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-pro"

3.配置 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_UPSTREAM="https://dashscope.aliyuncs.com/compatible-mode/v1" $env:CODEX_RELAY_API_KEY=$env:DASHSCOPE_API_KEY $env:CODEX_RELAY_PORT="4447" codex-relay

配置Codex

notepad $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"

四、开始使用Codex

cd 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直接修bug（Qwen）

我运行项目时出现以下报错： 【粘贴报错内容】 请你直接修复，但要遵守： 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. 最小实现方案 等我确认后再修改。
版权声明: 本文来自互联网用户投稿，该文观点仅代表作者本人，不代表本站立场。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。如若内容造成侵权/违法违规/事实不符，请联系邮箱：809451989@qq.com进行投诉反馈，一经查实，立即删除！
网站建设 2026/7/12 9:54:47

超轻滑漂竿哪个公司好

痛点深度剖析我们团队在实践中发现，超轻滑漂竿领域存在诸多痛点。行业同质化严重，超 75%厂商照搬公模外观，无自研工艺，陷入低价竞争，正品利润被压缩至 6%以内（用户痛点知识库）。多数品牌无核心导…

作者头像 李华
网站建设 2026/7/11 15:13:50

Python Web个人学习记录04

Python Web Day04 ORM:用于面向对象编程语言和关系型数据库之间建立映射 pip install "sqlalchemy[asyncio]" aiomysqlORM建表 ORM创建数据库异步引擎 建立数据库 CREATE DATABASE FastAPI_first CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;链接数据库 from …

作者头像 李华
网站建设 2026/7/10 16:00:27

WorkshopDL终极指南：如何免费下载1000+游戏的Steam创意工坊模组

WorkshopDL终极指南：如何免费下载1000游戏的Steam创意工坊模组 【免费下载链接】WorkshopDL WorkshopDL - The Best Steam Workshop Downloader 项目地址: https://gitcode.com/gh_mirrors/wo/WorkshopDL 还在为Steam创意工坊的模组下载而烦恼吗？…

作者头像 李华
网站建设 2026/7/11 14:55:14

简述：青蛙腹（长期久坐最典型)

简述：青蛙腹（长期久坐最典型)长期久坐最典型就是内脏脂肪堆积 腹横肌松弛 青蛙腹（下腹突出），非常贴合你的情况。 下面给你量身定制一套「久坐男士消蛙腹专属方案」，不用高强度，好坚持。 一、先…

作者头像 李华
网站建设 2026/7/11 2:44:10

量子化学计算：从传统方法到量子启发算法

1. 量子化学计算的现状与挑战量子化学计算的核心目标是求解薛定谔方程，以预测分子的电子结构和性质。传统方法如Hartree-Fock（HF）和耦合簇（CC）理论虽然能达到化学精度，但随着体系增大，计算复杂度…

作者头像 李华
网站建设 2026/7/10 3:06:20

不用配置环境！OpenClaw 2.7.9 Win11 一键安装故障合集

🔍前言 OpenClaw（圈内昵称小龙虾）是当下热度很高的开源 AI 智能体项目，GitHub 累计收获 28 万以上星标。和常规对话类 AI 不同，它能够读懂自然语言并自动执行电脑本地操作，被很多职场人称作数字员工。本文…

作者头像 李华