第一次用 Codex：从注册到跑起第一个任务

你可能听过一堆名字：OpenAI、GPT、ChatGPT、Codex、API——它们到底谁是谁？注册要不要科学上网？Plus 和 Pro 差在哪？装完之后面对满屏按钮从哪下手？

这课把两篇保姆级教程合成一条"上车路线"：@xaiwind 的《超详细Codex上手教程》负责"先上车"——注册、科学上网、充值、装 CLI、命令大全；@gengdaJ 的《Codex App 从0到1完整入门教程》负责"认界面"——Mac 版 App 的每个按钮是干嘛的、设置页 11 个分区逐个讲。

以下来自 @xaiwind 的梳理。很多人第一次接触就被名字绕晕，记住这五个角色：

• OpenAI = 公司，做 AI 的那家。
• GPT = 大脑，真正干活的模型。
• ChatGPT = AI 助手，你问它答的聊天应用。
• Codex = AI 程序员 / 软件工程 Agent，能动手改代码、跑任务。
• OpenAI API = 程序调用 AI 的接口，给开发者用的。

2026 年的最新模型（@xaiwind 整理）：文本用 GPT-5.6 Luna，图片用 GPT-Image-2.5，语音用 GPT-4o-mini-tts，视频的 Sora 已于 2026-04-26 下线。

以下来自 @xaiwind 的实测。大陆网络、香港 IP 均不可直接访问，需要科学上网（Cloudflare 或 VPS 自建，保留备份渠道，别把鸡蛋放一个篮子）。

• 邮箱：推荐谷歌 / 微软 / 自定义域名邮箱，不要用国内邮箱。
• 手机号验证：可能需要海外手机号收验证码，推荐接码平台 giff 或 hero-sms。
• 养号：刚注册不要猛用，开通 Plus 也要循序渐进。

充值 Plus（@xaiwind 实测路径）：ChatGPT 和 Codex 的套餐与桌面端是融合的——充 ChatGPT Plus 就自带 Codex 额度，免费版只有有限的聊天额度。

• 安卓：Google Play 绑定国内 Visa / Master 美金信用卡。
• 苹果：美区 Apple ID + 手机支付宝把地区切到美国，找 PockytShop 买礼品卡充值。

@gengdaJ 补充了额度体感：免费版大概两个对话就用完，小白至少 Plus，重度用户直接 Pro；另附礼品卡 / gamsgo / 代充渠道。

以下来自 @xaiwind。新手直接去 chatgpt.com/codex/ 下载客户端。注意：现在的软件就叫 ChatGPT，里面包含 ChatGPT 和 Codex 两大板块；登录时会跳转到网页授权。

关键提醒：Codex 终端（CLI）和桌面端是两个相互独立的程序，配置不互通，别指望这边设好那边自动同步。

CLI 安装（三条命令，@xaiwind 实测）：

复制curl -fsSL https://chatgpt.com/codex/install.sh | sh

更新用 codex update；Windows 推荐：

复制npm install -g @openai/codex

终端工具推荐：Windows 用 Git Bash，Mac 用 iTerm 或 Herdr（原文如此）。

以下来自 @gengdaJ 基于 Mac 版 Codex App（版本 26.429.30905）的全图解实测，是列表里唯一逐页拆解设置界面的教程。

三端区别：普通 ChatGPT（问答助手）vs Codex App 本地版（能读你电脑本地文件的工作台）vs 云端 Codex（任务跑在官方服务器上，电脑关机也能继续）。判断标准：一般任务用普通对话，处理本地文件用"项目"，要远程持续跑用云端。

主界面左中右三区：左边导航栏（找入口）、中间对话区（跟它交流）、右边结果区（它"交作业"的地方：文件、来源、网页预览、图片、PDF、代码 diff、Git 变化都在这看）。

左侧 6 个入口：新对话、搜索（找历史对话/任务）、插件、自动化（定时/延后执行任务）、项目（绑定文件夹/仓库）、普通对话（纯聊天）。

名词辨析（@gengdaJ 版）：Plugin = 能力包；Connector = 接你的账号；Skill = 固定工作流说明书；MCP = 接外部工具的通道。插件示例：Browser Use、Computer Use、Spreadsheets、Presentations、GitHub、Gmail / Drive / Slack。

设置页 11 分区逐项（@gengdaJ 实测，重点摘录）：

• 常规：工作模式选"日常工作"；长文本用 Command+Enter 发送。
• 外观：主题/字体/密度；彩蛋——输入 /宠物 可唤起桌宠。
• 个性化：可以要求"用中文回答"、"少用术语"；不要在这里写 API Key / 密码等敏感信息。
• MCP 服务器：小白用内置插件就够了，先别折腾。
• 电脑操控：最强但最危险——警告：不要让它操作微信和社媒账号。
• 已归档对话：相当于无期限的回收站，删了还能找回来。

界面三模式（@xaiwind）：聊天模式（纯文本/语音问答）、Work 工作模式（通用任务：邮件汇总、图片生成、定时任务、搭网站）、Codex 模式（软件开发，默认在"项目区"，视频创作/代码相关用它）。

工作模式和 Codex 模式功能有重叠，@xaiwind 的建议：简单任务用工作模式，复杂的用 Codex。

权限弹框四档策略（@xaiwind）：默认选"询问授权"最稳妥。

• 允许一次：陌生命令 / 联网 / 装依赖 / 访问工作区以外的文件。
• 会话持续允许：可信的测试、构建、Git 查询。
• 拒绝：目标不明的、涉及密钥的、发布、删除、系统目录。
• Full Access（完全访问）：只在容器 / 临时虚拟机里用，别在主力电脑上开。

权限确认五类（@gengdaJ 补充）：文件访问（看清路径）、终端命令（不懂先让它解释）、浏览器（避开付款/删除/发布）、第三方账号（看清授权范围）、电脑操控（边界说清楚）。看不懂权限时直接问它："这个权限具体会让你做什么？有什么风险？"

小白 9 步安全上手路线（@gengdaJ）：熟悉导航 → 用普通对话问低风险问题 → 设置页只看不改 → 建一个干净的演示项目 → 让它读项目并生成 Markdown → 看右侧结果区 → 让它解释自己做了什么 → 再试插件/自动化 → 最后才碰 Git / MCP / 电脑操控。

踩坑排查（@gengdaJ）：界面转圈 = 还没跑完，耐心等；蓝色点 = 已经结束。结果不满意不要重开新对话，直接基于现有结果让它迭代；自动化跑偏，多半是因为任务描述写得太泛。

AGENTS.md 四层优先级（@xaiwind）：这是 Codex 的"项目说明书"，离文件越近优先级越高——

• 全局：~/.codex/AGENTS.md，对所有项目生效。
• 项目级：项目根目录的 AGENTS.md。
• 子目录：只对本级及下级目录生效。
• 临时覆盖：AGENTS.override.md。

用 /init 可以让 Codex 自动创建项目级 agent.md。记住：AGENTS.md 只写 Codex 自己发现不了的东西（构建命令、禁改文件、提交格式），别超过一页纸，写太多反而降低成功率。

CLI 命令速查表（@xaiwind 整理，全收录）：

启动：codex、codex --cd 目录 --add-dir 目录、codex exec "任务"（非交互、一次执行完就退）、codex resume --last、codex --worktree（独立 Git 工作树）、codex --search（实时网页搜索）、codex -i screenshot.png "任务"（附图提问）、codex -m 模型名（指定模型）。

会话内：/status、/model、/permissions、/plan（计划模式：先出方案再动手）、/diff、/review、/compact（压缩长对话释放上下文）、/exit；延伸：/side 或 /btw（临时侧边聊天）、/mention（引用文件/目录）、/skills、/mcp、/ps（后台终端任务）、/stop、/resume、/fork（派生新会话）、/new 或 /clear、/rename、/archive、/delete。

输入框：@ 引用文件、!命令 直接跑 Shell、/ 搜斜杠命令、$ 调用 Skill/插件/App、Ctrl+G 长提示词编辑器；Agent 运行时 Enter 补充指令、Tab 排队后续要求；↑/↓ 翻历史、Ctrl+R 搜历史、Esc×2 回到上一条消息派生分支、Ctrl+O 复制上次回复、Ctrl+L 清屏不丢上下文。

@xaiwind 的"全局工作指令"模板（附在原文，可直接抄）：角色定为创业助手/决策顾问——实事求是、不迎合；表达习惯：先给结论、再给理由、最后给可执行建议；编码原则：先想再写、简洁优先、精准改动、目标驱动；项目目录规范：一次性任务放 /Users/xaiwind/Documents/Codex/YYYY-MM-DD/，长期项目放 Projects/项目名，不确定就按日期建目录，不擅自移动和重命名用户文件。

Skill / MCP / 插件到底什么区别？（@xaiwind）——Skill 是"告诉 AI 怎么干"（方法），MCP 是"让 AI 有东西可干"（连接），插件是"把能力整体装进来"（打包）。三句话一次记住。