1.1万字 Codex保姆级教程:小白从安装到跑通项目

最近我发现Claude+DeepSeek还是差点意思,就转到codex体验一下顶级模型。但是,习惯了终端中使用Claude code之后,打开codex之后,我竟然不知道怎么用!

相信很多朋友跟我一样,第一次打开 Codex,第一反应不是“哇,好强”,而是:

这东西到底从哪开始用?

它看起来像一个聊天软件,但又能读文件、改项目、开浏览器、装插件、跑命令、接 MCP。软件界面的左边是一堆入口,中间是对话,右边还会弹出文件、网页、预览、代码变化。

如果你是小白,很容易犯一个错误:

什么都没配置好,就直接让它干活。

最后不是文件乱飞,就是不知道产物放哪(我整理乱糟糟的文件,头都大了!大家一定注意一些);不是插件装了一堆不会用,就是项目里没有任何规则,Codex 每次都要重新理解你。

所以这篇教程,只讲新手第一次真正上手时最需要配置的东西。

我们只解决一个问题:

一个 Windows 小白,怎么把 Codex 从“能聊天”,配置到“真的能做项目”。

看完这篇,你至少应该能完成三件事:

  1. 知道 Codex 可以在哪些地方用。
  2. 在 Windows 上建立一个适合 Codex 工作的项目文件夹。
  3. 配好基础规则、插件、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 等。具体入口和按钮名称会更新,你以自己当前看到的界面为准。

小白先看这张表就够了:

使用方式
解释
适合谁
小白建议
Codex App
装在电脑上的 Codex 工作台
想管理本地项目的人
主推,从这里开始
Codex Web / Cloud
在网页或云端委托任务
想让任务离开本地持续跑的人
后面再学
Codex CLI
命令行里的 Codex
会终端的人
小白先不用
IDE / VS Code 扩展
在代码编辑器里用 Codex
写代码、改网页、改项目的人
有项目后再用
GitHub 里的 Codex
在代码仓库里委托任务
管 GitHub 仓库的人
后期再学

这篇文章只重点讲一条路线:

Windows 上用 Codex App,把项目真正跑起来。

为什么不一上来讲 CLI、GitHub、云端?

因为小白最先要解决的不是“入口不够多”,而是“我到底该把文件放哪、规则怎么写、权限怎么给、结果怎么看”。

把本地 App 这条路跑通,后面去 VS Code、Cloud、GitHub 都会顺很多。

三、Windows 上怎么安装 Codex App

安装这件事本身不复杂,最重要的是别乱下载。

建议只从 OpenAI 官方入口下载:

https://openai.com/codex/

基本流程是:

  1. 打开官方入口。
  2. 下载 Windows 版 Codex App。
  3. 按提示安装。
  4. 打开 Codex。
  5. 用 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

执行完之后,你应该能在资源管理器里看到这个项目文件夹。

你不一定每个目录一开始都用得上,但先知道它们干什么。

文件/目录
大白话解释
README.md
给人看的项目说明
AGENTS.md
给 Codex 看的工作规则
CONTEXT.md
给 Codex 看的业务背景
docs/
长期说明、方案、运行手册
src/
正式代码
scripts/
采集、清洗、维护脚本
data/raw/
原始数据,不要乱改
data/processed/
处理后的中间结果
data/export/
最终导出成果
assets/
图片、模板、素材
logs/
运行日志
tmp/
临时文件

如果你不是程序员,也不用怕 src、scripts 这些词。

它们只是帮你把项目分区。

真正关键的是三个文件:

README.md
AGENTS.md
CONTEXT.md

这三个文件写好,Codex 就不会每次都像第一次见你。

七、README.md 怎么写:让未来的你也能看懂

README.md 是给人看的。

不是写给 AI 炫技的,是写给未来的你。

一个最简单的 README 可以这样写:

# 项目名称

这个项目用于:

## 快速开始

1. 把原始素材放到…
— 以上为试看内容(约 40%),开通会员后阅读全文 —