夜雨聆风
更新时间：2026年6月适用版本：Codex 桌面App / CLI / IDE扩展 / Web云端
前言
如果你已经用上了 WorkBuddy 处理办公事务，那写代码这件事，也该有个 AI 搭档了。
Codex 是 OpenAI 推出的 AI 生产力智能体。它和 ChatGPT 的区别在于：ChatGPT 是"聊天顾问"——你问它答；Codex 是"动手干活的工程师"——你描述需求，它直接读取你的代码、修改文件、运行命令、调试报错，直到把任务做完。
Codex 能帮你：
• 从零写代码："帮我写一个将 CSV 转成 JSON 的小工具"
• 改老代码："这段函数性能太差，优化一下"
• 找 Bug："运行报错，定位问题并修复"
• 读陌生代码库："解释这个项目里 main.py 的架构逻辑"
• 自动化任务："给这个仓库加单元测试，覆盖率不低于80%"
截至 2026 年 6 月，Codex 每周活跃用户已突破 500 万。值得注意的是——虽然开发者仍是主力，但非技术用户已占约 20%，且增速是开发者的 3 倍以上。分析师、营销人员、产品设计师、运营都在用 Codex 处理数据、生成报告、自动化工作流。
Codex 有四种使用形态，对应不同场景：
| 桌面App | |||
| CLI（命令行） | |||
| IDE扩展 | |||
| Web云端 |
新手建议：先从桌面App入手，图形界面最直观。等熟悉后再根据需要搭配 CLI 或 IDE 扩展。
2026年6月重大更新：Codex 不只是写代码了
如果你对 Codex 的印象还停留在"AI 编程助手"，那它已经变了。
6 月 2 日，OpenAI 发布了 Codex 史上最大规模更新，三个核心变化：
1. 角色插件（Role-Specific Plugins）
推出了 6 个岗位专属插件：数据分析、创意生产、销售、产品设计、股权投资、投资银行。每个插件内置了该岗位常用的工具、技能和指令组合，合计覆盖 62 个应用 + 110 个技能。
这意味着 Codex 不再只是在代码仓库里干活——它可以连接 Snowflake 分析数据、打开 Figma 改设计稿、进入 Salesforce 准备客户会议、调用 Tableau 生成报表。对非开发者而言，这是质的飞跃。
2. Sites：一句话生成可分享的网站
通过 Sites 功能，你能让 Codex 创建交互式托管网站，生成 URL 分享给团队。适合做仪表盘、项目看板、活动页面、财务分析工具等内部轻量级应用。而且内容可以持续更新——不是一次性生成就扔了。
3. Annotations：对生成内容进行局部修改
你可以在 Codex 生成的网站、文档、表格中选中某个具体区域，让它只改这一部分。比如选中导航栏调字体、高亮报告中的某个观点补充来源、标记图表修改标签。这在真实工作的反复修改场景中价值巨大——真正耗时的地方，往往不是第一版，而是改来改去。
简单来说，Codex 正在从"帮你写代码"进化成"帮你干活"。
一、下载前准备
1. 系统要求
Codex 对硬件要求不高，主流电脑都能流畅运行。AI 计算主要在云端完成，本地只负责代码编辑和命令执行。
WSL 2 是什么？Windows 子系统 for Linux，让 Windows 用户获得接近 Linux 的开发体验。Codex CLI 在 WSL 2 下运行更稳定，强烈建议 Windows 用户先启用 WSL 2。
2. 账号准备
Codex 不是完全免费工具，需要付费 OpenAI 账号才能使用：
| ChatGPT Plus | ||
| ChatGPT Pro | ||
| ChatGPT Team/Enterprise/Edu | ||
| 免费账号 | ||
| API Key |
新手建议：如果你已有 ChatGPT Plus 账号，直接用账号登录最省事。没有账号的话，先去 OpenAI 官网注册并升级 Plus。
二、桌面App安装（推荐新手，约3分钟）
桌面App是 Codex 最友好的形态，有图形界面、项目管理、Git 集成、自动化任务面板，适合所有用户——尤其是非程序员和喜欢可视化操作的人。
步骤1：访问官网获取安装包
打开浏览器，访问官方页面：
https://developers.openai.com/codex/app/
Windows 用户：页面会引导你通过 Microsoft Store 安装，也可直接运行命令：
winget install Codex -s msstoreMac 用户：从页面下载对应芯片的安装包：
• Apple Silicon（M1/M2/M3/M4）：选 "Download for Apple Silicon"
• Intel 芯片：选 "Download for Intel"
安全提示：只从 OpenAI 官方渠道或 Microsoft Store 获取。Codex 涉及代码执行权限，拒绝任何第三方网站提供的安装包。
步骤2：运行安装程序
Windows 版：
方式一：打开 Microsoft Store，搜索"Codex"，点击"获取 / 安装"，等待自动完成。
方式二：在 PowerShell 中运行 winget install Codex -s msstore。
macOS 版：
1. 双击 .dmg 下载文件
2. 将 Codex 图标拖拽到"应用程序"文件夹
3. 首次打开时，若提示"无法验证开发者"，前往 系统设置 → 隐私与安全性 点击"仍要打开"
步骤3：启动并登录
1. 从开始菜单（Windows）或启动台（Mac）启动 Codex
2. 首次启动会加载必要组件，等待约 10-20 秒
3. 进入登录界面，选择 "Sign in with ChatGPT"
4. 浏览器会跳转 OpenAI 登录页，输入 ChatGPT 账号密码完成授权
5. 授权完成后自动返回 Codex 主界面
步骤4：选择项目文件夹
登录成功后，Codex 会要求你选择一个项目文件夹（Project Folder）。这是 Codex 的"工作区"——它会读取、修改、执行这个文件夹内的代码。
建议操作：
1. 提前在电脑上建好项目目录，例如 ~/codex-projects（Mac）或 D:\codex-projects（Windows）
2. 每个项目单独建一个子文件夹，例如 ~/codex-projects/web-scraper
3. 在 Codex 中选择对应项目文件夹
安全提醒：不要选择整个硬盘或系统根目录作为项目文件夹。遵循"最小权限原则"，只让 Codex 访问当前需要操作的项目目录。
至此，桌面App安装完成。
三、CLI（命令行）安装（开发者首选，约5分钟）
CLI 是 Codex 最灵活的形态，适合习惯终端操作的开发者。你可以在 VS Code 内置终端、iTerm2、Windows Terminal 中直接调用 Codex，与代码编辑器无缝衔接。
步骤1：检查 Node.js 版本
Codex CLI 基于 Node.js 构建，需要 v20 或更高版本。打开终端运行：
node --version如果输出低于 v20.0.0，先升级 Node.js：
Mac/Linux：
# 使用 nvm 安装（推荐） nvm install 22 nvm use 22Windows：
1. 访问 https://nodejs.org/ 下载 LTS 版本安装包
2. 按向导安装，勾选"Add to PATH"
3. 安装完成后重启终端，再次运行 node --version 确认
步骤2：安装 Codex CLI
npm 全局安装（推荐，跨平台通用）
npm install -g @openai/codex如果权限不足，可改用本地前缀目录：
mkdir -p ~/.npm-global npm config set prefix ~/.npm-global npm install -g @openai/codex export PATH="$HOME/.npm-global/bin:$PATH"步骤3：验证安装
codex --version如果显示版本号，说明安装成功。
步骤4：首次运行与登录
在项目目录下打开终端，运行：
codex首次运行会提示登录：
1. 选择 "Sign in with ChatGPT"（推荐）或 "Use API Key"
2. 按提示完成浏览器授权或输入 API Key
3. 登录成功后进入交互式会话界面
使用技巧：建议在项目根目录下运行 codex，这样它会自动读取当前目录的代码库作为上下文，提问更精准。
四、IDE 扩展安装（约2分钟）
如果你日常用 VS Code、Cursor 或 Windsurf 写代码，直接装插件最方便——边写边问，不用切换窗口。
支持的 IDE
| Visual Studio Code | OpenAI Codex |
| Cursor | OpenAI Codex |
| Windsurf | OpenAI Codex |
| VS Code Insiders |
安装步骤（以 VS Code 为例）
1. 打开 VS Code，点击左侧扩展图标（或按 Ctrl+Shift+X / Cmd+Shift+X）
2. 搜索 "OpenAI Codex"
3. 点击安装，等待约 10 秒
4. 安装完成后左侧边栏出现 Codex 图标
5. 点击图标，选择登录方式（ChatGPT 账号或 API Key）
常用命令
Codex: New Chat | Ctrl+NCmd+N | |
Codex: Add File to Thread | ||
Codex: Implement Todo |
五、Web 云端版（零安装，1分钟上手）
如果你只是想临时体验一下，或者电脑环境受限，直接用浏览器版：
1. 打开 https://developers.openai.com/codex
2. 登录 ChatGPT 账号
3. 连接你的 GitHub 仓库（可选）
4. 直接输入需求开始对话
特点：
• 无需安装任何软件
• 支持与 GitHub 协作，可直接创建 Pull Request
• 实时查看执行日志和代码变更
• 无法操作本地文件（只能处理 GitHub 上的代码）
适合场景：临时救急、出差在外用他人电脑、先体验再决定是否本地安装。
六、四种形态对比与选择建议
我的建议- 如果你是非程序员或喜欢图形界面：选桌面App - 如果你是程序员，日常用终端：选 CLI + IDE 扩展组合 - 如果你只是想试试：先玩 Web 云端，喜欢了再装本地版
七、安全配置（必做！保护你的代码）
Codex 能读代码、改文件、执行命令，权限很大。首次使用前，务必做好四项安全配置，防止误操作。
1. 项目隔离：一项目一文件夹
原则：绝不把系统盘、桌面、文档根目录作为项目文件夹。
正确做法：
~/codex-projects/ ├── web-scraper/ ← 项目A：爬虫工具 ├── data-analysis/ ← 项目B：数据分析脚本 └── api-server/ ← 项目C：后端服务每次启动 Codex 只加载当前项目文件夹，避免它接触到其他项目的敏感代码或配置文件。
2. 审批策略：让 Codex"先请示再动手"
Codex 执行高危操作（如删除文件、修改核心代码、执行系统命令）前，默认会询问你是否确认。你可以在配置中调整这个策略。
桌面App：设置面板 → 安全与权限 → 审批策略
CLI：编辑 ~/.codex/config.toml：
# 最稳妥：每次操作都问你 approval_policy = "on-request" # 中等：只读操作自动执行，写入操作需确认 approval_policy = "auto-edit" # 最激进：全自动，不询问（不推荐新手） approval_policy = "full-auto"新手强烈建议：保持 on-request模式，至少用一周熟悉 Codex 的行为模式后再考虑放宽。
3. 沙箱模式：限制文件读写范围
# 只允许修改项目文件夹内的文件 sandbox_mode = "workspace-write" # 如果想额外开放某个工具链目录（如全局npm包） writable_roots = ["/usr/local/lib/node_modules"]4. 创建 AGENTS.md（项目说明书）
在项目根目录创建一个 AGENTS.md 文件，告诉 Codex 这个项目的背景信息、技术栈、编码规范。相当于给 AI 工程师发一份"项目入职手册"。
示例（Python 爬虫项目）：
# 项目：Web Scraper ## 技术栈 - Python 3.11 - requests + BeautifulSoup4 - 输出格式：JSON ## 编码规范 - 使用 black 格式化代码 - 函数注释用 Google Style docstring - 异常处理必须打印友好错误信息 ## 注意事项 - 请求间隔不少于2秒，避免被封IP - User-Agent 必须模拟真实浏览器 - 敏感数据（API Key）写入 .env 文件，不硬编码Codex 会自动读取这个文件，后续任务执行更符合你的预期。
八、首次使用：跑通第一个项目
安装完成、安全配置做好后，来做一个真实的小项目，建立使用信心。
场景：创建一个 CSV 转 JSON 的小工具
桌面App 操作步骤：
1. 打开 Codex，确保已选择项目文件夹（如 ~/codex-projects/csv-tool）
2. 在对话框输入：
"帮我写一个 Python 脚本，功能是把当前目录下的 data.csv 转换成 output.json，要求保持表头作为 JSON 的 key，并处理中文编码"
3. Codex 会：
• 读取项目文件夹（目前是空的）
• 创建 convert.py 文件
• 写入完整代码
• 询问你是否执行测试
4. 你回答"执行测试"，Codex 会自动创建测试用的 data.csv，运行脚本，验证输出
5. 完成后，你会在文件夹里看到 convert.py、data.csv、output.json 三个文件
CLI 操作步骤：
# 1. 进入项目目录 cd ~/codex-projects/csv-tool # 2. 启动 Codex codex # 3. 直接输入自然语言需求 > 写一个 Python 脚本，把 data.csv 转成 output.json，表头作为 key，处理中文编码 # 4. Codex 生成代码后，会问你是否执行 # 输入 y 确认 # 5. 完成后输入 /exit 退出对比感受：桌面App更适合观察 Codex 的完整思考过程和文件变更历史；CLI 更适合快速迭代、边写边测。
九、常见问题 FAQ
Q1：Codex 和 ChatGPT 有什么区别？
ChatGPT 是聊天工具，主要回答问题；Codex 是生产力智能体，能直接操作你的代码文件、连接第三方工具、执行命令、完成复杂任务。两者账号互通，但使用场景不同。
Q2：免费用户能用 Codex 吗？
不能。Codex 需要 ChatGPT Plus（$20/月）或更高套餐。Plus 用户有基础免费额度，Pro 用户额度更充足。也可通过 API Key 按量付费。
Q3：安装 CLI 时卡在 npm 下载怎么办？
国内网络访问 npm 官方源可能较慢。建议切换淘宝镜像： ```bash npm config set registry https://registry.npmmirror.com npm install -g @openai/codex ```
Q4：Windows 用户必须用 WSL 2 吗？
不是必须，但强烈推荐。Codex CLI 在原生 Windows PowerShell 下运行可能遇到路径、权限等问题，WSL 2 能提供更稳定的 Linux 环境。
Q5：Codex 会覆盖我的代码吗？
默认情况下，Codex 每次修改文件前都会询问确认（approval_policy = on-request）。建议配合 Git 使用，每次让 Codex 工作前先 git commit，这样即使改坏了也能回退。
Q6：API Key 和 ChatGPT 账号登录有什么区别？
账号登录：使用你订阅套餐内的额度，功能完整（如多线程、自动化）。 API Key：按 token 消耗计费，更灵活，但部分功能受限。 新手建议先用账号登录。
Q7：Codex 支持哪些编程语言？
主流语言都支持：Python、JavaScript/TypeScript、Java、Go、Rust、C/C++、Ruby、PHP 等。其中 Python 和 JavaScript 的优化最好，执行成功率最高。
Q8：Codex 和 GitHub Copilot 有什么区别？
Copilot 是"代码补全工具"——你写代码时它给提示；Codex 是"AI工程师"——你描述需求，它自己写、改、测、调。两者可以搭配使用：Copilot 辅助日常编码，Codex 处理复杂任务和自动化。
Q9：AGENTS.md 是必须的吗？
不是必须，但强烈建议。没有它 Codex 也能工作，但有了它，Codex 会更了解你的项目背景，减少"瞎猜"和反复确认的次数，提升效率。
Q10：桌面App 和 CLI 的数据互通吗？
互通。两者共用同一个账号配置和项目历史。你在桌面App里创建的项目，CLI 中也能看到；CLI 里执行的修改，桌面App里也会同步显示。
Q11：非程序员能用 Codex 吗？
能，而且比例在快速增长。截至 2026 年 6 月，约 20% 的 Codex 用户是非开发者。你不需要会编程，用自然语言描述需求就行。搭配角色插件（数据分析、创意生产等），不需要写一行代码也能完成工作。
十、Codex 新手自检清单
安装完成后，对照以下清单逐项确认，确保配置到位：
• 从 OpenAI 官方渠道安装 Codex（拒绝第三方安装包）
• 清楚四种形态的核心区别（桌面App/CLI/IDE/Web）
• 建立独立的项目根目录（如 ~/codex-projects），每个项目单独文件夹
• 已创建 AGENTS.md 文件，描述项目技术栈和规范
• 审批策略设为 on-request（新手保护期）
• 仅授权 Codex 访问当前项目文件夹（不开放整个硬盘）
• 已明确要求 Codex："需求不全时先追问，不擅自编造内容"
• 每次 AI 修改文件后，先让它解释"改了什么、为什么改"，再确认生效
• 项目已初始化 Git，每次让 Codex 工作前先提交当前版本
全部勾选后，你已经不是"只会打开 Codex 聊天"的新手了。
结语
从下载到跑通第一个项目，全程不超过 10 分钟。三个关键步骤回顾：
1. 安装客户端：桌面App 或 CLI 任选其一，官网下载、账号登录
2. 安全配置：项目隔离、审批策略、沙箱模式、AGENTS.md
3. 跑通首项目：用自然语言描述一个具体需求，观察 Codex 如何拆解、执行、交付
Codex 再强，也只是你手中的锤子。能不能盖出好房子，取决于你愿不愿意先学会画图纸。
现在，打开 Codex，开始你的第一个项目吧。
更多资源
• Codex App 下载页：https://developers.openai.com/codex/app/
• Codex 快速入门：https://developers.openai.com/codex/quickstart
• Codex 官方文档：https://developers.openai.com/codex
• Codex Changelog：https://developers.openai.com/codex/changelog
