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

闲得勿聊

21人浏览 · 2026-06-29 16:33:47

闲得勿聊 · 2026-06-29 16:33:47 发布

一、适合谁

这份教程适合三类人：

第一次使用 Codex CLI 做项目的新手。
想用 Codex 辅助写代码、修 Bug、重构项目的人。
想在 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. 最小实现方案 等我确认后再修改。

DeepSeek技术社区

欢迎加入DeepSeek 技术社区。在这里，你可以找到志同道合的朋友，共同探索AI技术的奥秘。

更多推荐

财报分析AI工具各产品信息处理适配场景梳理

各类财报分析AI工具在信息处理流程中承担完全不同的细分作用，没有一款产品可以适配所有财报整理、研报阅读、复盘记录场景。扣子app的核心价值是搭建统一项目空间，完成全部研究资料长期归档与流程统筹；DeepSeek、Kimi、ChatGPT、夸克AI、Perplexity分属不同定位的文本与资讯检索工具，分别适配深度年报拆解、多文档横向对比、外文财报阅读、碎片化简易整理、全网资讯交叉验证；酷表Chat