1.1万字 Codex保姆级教程:小白从安装到跑通项目
最近我发现Claude+DeepSeek还是差点意思,就转到codex体验一下顶级模型。但是,习惯了终端中使用Claude code之后,打开codex之后,我竟然不知道怎么用!
相信很多朋友跟我一样,第一次打开 Codex,第一反应不是“哇,好强”,而是:
这东西到底从哪开始用?
它看起来像一个聊天软件,但又能读文件、改项目、开浏览器、装插件、跑命令、接 MCP。软件界面的左边是一堆入口,中间是对话,右边还会弹出文件、网页、预览、代码变化。
如果你是小白,很容易犯一个错误:
什么都没配置好,就直接让它干活。
最后不是文件乱飞,就是不知道产物放哪(我整理乱糟糟的文件,头都大了!大家一定注意一些);不是插件装了一堆不会用,就是项目里没有任何规则,Codex 每次都要重新理解你。
所以这篇教程,只讲新手第一次真正上手时最需要配置的东西。
我们只解决一个问题:
一个 Windows 小白,怎么把 Codex 从“能聊天”,配置到“真的能做项目”。
看完这篇,你至少应该能完成三件事:
知道 Codex 可以在哪些地方用。 在 Windows 上建立一个适合 Codex 工作的项目文件夹。 配好基础规则、插件、Skills,并跑通一个真实项目。
先说结论:新手第一次用 Codex,最该先配置的不是模型,而是项目文件夹。
一、先别急着提问:Codex 不是普通聊天框
如果你只把 Codex 当成 ChatGPT 的另一个入口,那它确实就是一个聊天框。
但 Codex 真正厉害的地方,不是“回答问题”,而是“直接进入项目文件,扮演你的工作助手帮你做事”。
它可以做这些事:
读取你指定的本地文件。 修改项目里的文档和代码。 运行终端命令。 打开网页查资料。 通过插件处理文档、表格、PPT。 用 Skills 按固定流程完成任务。 通过 MCP 连接外部工具。 在 IDE 或云端继续处理项目。
这也是为什么新手会懵。
普通聊天工具不会随便碰你的本地文件,但 Codex 会。普通聊天工具通常只给你答案,但 Codex 可能会真的帮你新建文件、改文件、生成项目、跑脚本。
能力越强,越需要边界。
所以小白要先建立一个最重要的意识:
不要一上来就问“Codex 能做什么”,先问“我准备让它在哪个项目里做事”。
项目位置选错了,后面全乱。
二、Codex 到底能在哪些地方用
截至 2026-05-16,OpenAI 官方资料里提到,Codex 可以在多个入口使用,比如 App、CLI、Web/Cloud、IDE extension 等。具体入口和按钮名称会更新,你以自己当前看到的界面为准。
小白先看这张表就够了:
这篇文章只重点讲一条路线:
Windows 上用 Codex App,把项目真正跑起来。
为什么不一上来讲 CLI、GitHub、云端?
因为小白最先要解决的不是“入口不够多”,而是“我到底该把文件放哪、规则怎么写、权限怎么给、结果怎么看”。
把本地 App 这条路跑通,后面去 VS Code、Cloud、GitHub 都会顺很多。
三、Windows 上怎么安装 Codex App
安装这件事本身不复杂,最重要的是别乱下载。
建议只从 OpenAI 官方入口下载:
https://openai.com/codex/
基本流程是:
打开官方入口。 下载 Windows 版 Codex App。 按提示安装。 打开 Codex。 用 ChatGPT / OpenAI 账号登录。
如果你已经习惯用 Windows 终端,也可以用官方文档提到的 winget 方式安装。先打开 PowerShell,再执行:
winget install Codex -s msstore
如果你后面要让 Codex 改网页、跑脚本、处理代码项目,建议顺手装几个常用工具。OpenAI Windows 文档也提到,Git、Node.js、Python 这类开发工具会让 Codex 做项目更顺。
可以先装这三个:
winget install --id Git.Git
winget install --id OpenJS.NodeJS.LTS
winget install --id Python.Python.3.14
装完以后,重启 Codex App 或重新打开终端,再让 Codex 检查:
git --version
node --version
python --version
如果你只是体验,优先用账号登录,不要一上来研究 API Key。
免费账号能不能用,要看当时官方开放策略和额度。长期使用,通常还是建议至少准备 Plus 或更高套餐。因为 Codex 一旦进入项目、读文件、改文件、跑长任务,消耗会比普通聊天更明显。
小白成功标志:
你已经能打开 Codex App。 你已经登录账号。 你能新建一个普通对话。 你能看到项目或类似项目入口。
到这里,先别急着让它改文件。
先做设置。
四、第一次打开后,先做 5 个基础设置
Codex 的设置会随着版本变化,但小白可以先关注 5 类设置。
你不需要把每个按钮都研究透。先把最影响使用体验和安全边界的地方搞清楚。
1. 语言和回答风格:先让它按小白方式说话
如果 Codex 支持个性化、自定义说明、偏好设置之类的入口,可以先写一段固定说明。
你可以直接复制这一段:
请默认用中文回答。
如果涉及代码或命令,请先用大白话解释目的,再给具体操作。
如果要修改文件、运行命令、访问外部账号,请先告诉我风险。
教程类内容请写成小白能照着做的步骤,并标注每一步的成功标志。
如果我的需求信息不完整,请先问我缺什么,不要直接编。
这段话的作用很大。
它不是让 Codex 变强,而是让 Codex 更适合你。
小白最怕的不是 AI 不会做,而是它一上来就抛术语、跑命令、改文件,你完全不知道发生了什么。
2. 权限:不要一上来开放整个硬盘
Codex 会请求权限,比如读文件、改文件、运行命令、访问网页、连接账号。
新手最容易犯的错误是:看到确认按钮就点。
不要这样。
第一次使用,建议只给当前项目文件夹权限。
比如你要做网页工具项目,就只让 Codex 访问这个项目目录:
D:\codex_projects_by_jack\网页工具项目
不要一上来给:
C:\
D:\
整个用户目录
下载目录
个人文件夹
桌面全部文件
如果看不懂权限请求,就直接问 Codex:
请用小白能懂的话解释:你现在请求的权限会访问什么?为什么这个任务需要它?有没有更低风险的做法?
3. 发送方式:避免写长需求时误发送
如果设置里有“Enter 发送”或“组合键发送”之类的选项,建议新手选择不容易误触的方式。
因为你后面写项目需求时,经常会写很长:
项目目标。 输出格式。 不要做什么。 目录结构。 验证方式。
如果写一半按回车就发出去了,Codex 可能会拿着半截需求开始干活。(我吃了很多次亏才想起来要设置一下)
4. 模型和推理强度:先默认,复杂任务再提高
小白不需要一上来研究每个模型。
建议:
普通问答:默认即可。 长文写作:用更强模型或更高推理。 代码修改、复杂项目:用更强模型或更高推理。 简单格式整理:不用开太高。
一句话:
小任务别浪费额度,大任务别省过头。
5. 自动化先别急
自动化听起来很诱人:
每天自动总结。 每周自动检查。 定时抓资料。 到点继续写文章。
但新手别急。
先把手动流程跑通,再自动化。
如果你手动都没说清楚“输入是什么、输出到哪里、失败怎么办”,自动化只会把混乱定时重复一遍。
五、真正开始前,先建一个项目根目录
这一步是全文最重要的地方。
小白用 Codex,第一件事不是装插件,而是建立项目根目录。
你可以建一个这样的文件夹:
D:\codex_projects_by_jack
或者更简单:
D:\codex_projects
这个目录以后专门放 Codex 项目。
不要把项目直接放在:
桌面。 下载目录。 聊天软件接收文件夹。 笔记库内部。 同步盘里随手建的杂乱目录。 系统盘乱七八糟的位置。
为什么?
因为 Codex 会读文件、写文件、生成中间数据、跑脚本。
例如,如果你把项目塞进日常笔记库,它可能把一堆日志、配置、代码、缓存都放进去。笔记库就被污染了。
如果你把项目放桌面,时间久了你会分不清哪些是成品、哪些是临时文件。
如果你把项目散在下载目录,三个月后你自己都找不到。
所以先建一个干净的项目根目录。
如果你会打开 PowerShell,可以直接复制这条命令:
New-Item -ItemType Directory -Path "D:\codex_projects_by_jack" -Force
这条命令的意思是:在 D 盘创建一个叫 codex_projects_by_jack 的文件夹;如果它已经存在,就不重复创建,也不会报错。
小白成功标志:
D:\codex_projects_by_jack
下面只放项目,不放随手下载的东西。
六、第一个项目文件夹应该长什么样
有了项目根目录,每个新项目再建一个独立文件夹。
比如:
D:\codex_projects_by_jack\项目1
D:\codex_projects_by_jack\项目2
D:\codex_projects_by_jack\项目3
新项目推荐结构:
我的第一个Codex项目/
README.md
AgentS.md
CONTEXT.md
docs/
src/
scripts/
data/
raw/
processed/
export/
assets/
logs/
tmp/
如果你想一次性建好这些文件夹,可以在 PowerShell 里执行:
$project = "D:\codex_projects_by_jack\我的第一个Codex项目"
New-Item -ItemType Directory -Path $project -Force
New-Item -ItemType Directory -Path "$project\docs","$project\src","$project\scripts","$project\data\raw","$project\data\processed","$project\data\export","$project\assets","$project\logs","$project\tmp" -Force
New-Item -ItemType File -Path "$project\README.md","$project\AGENTS.md","$project\CONTEXT.md" -Force
执行完之后,你应该能在资源管理器里看到这个项目文件夹。
你不一定每个目录一开始都用得上,但先知道它们干什么。
如果你不是程序员,也不用怕 src、scripts 这些词。
它们只是帮你把项目分区。
真正关键的是三个文件:
README.md
AGENTS.md
CONTEXT.md
这三个文件写好,Codex 就不会每次都像第一次见你。
七、README.md 怎么写:让未来的你也能看懂
README.md 是给人看的。
不是写给 AI 炫技的,是写给未来的你。
一个最简单的 README 可以这样写:
# 项目名称
这个项目用于:
## 快速开始
1. 把原始素材放到…