GitHub 爆火！ Codex 从新手到精通全流程教学！

在 ChatGPT 桌面应用内，Codex 模式承担工程执行任务，Chat 模式承担对话交互。Chat 模式主要给出文字回答；Codex 模式可读取项目文件、修改代码、运行命令、查看 Git 变更，并调用已接入的外部工具。向 Codex 派发任务时，应满足三个条件：有材料、有边界、有结果。推荐流程为：派活 → 看路线 → 授权执行 → 亲自验收，对应 Prompt → Plan → Execute → Verify。验收环节不可省略，Codex 报告“完成”仅表示当前执行结束，不代表结果正确。

模型选择说明：Codex 支持多种模型后端。GPT-6 Astra 为原生旗舰模型，在 Terminal Bench 4.0 编码基准上得分 57.9%，Agent’s Last Exam 智能体能力得分 59.3%，支持约 105 万 Tokens 上下文窗口。DeepSeek 为可选的低成本替代方案，适用于代码编写和日常任务。两者可按任务需求切换，不互相排斥。

使用定位

Codex 更适合作为执行型工程助手，不宜仅作为聊天工具。有效任务示例：

• 修改登录页错误提示为中文。
• 检查模块是否存在重复逻辑。
• 为项目生成 README。

无效任务示例：

• “优化一下项目”。此类任务边界模糊，难以验收。

新手九步

以下九步用于建立对 Codex 执行能力的判断。核心原则：信任通过验证建立。

1. 项目概览

   请通读这个项目，并用一段话说明：项目用途、主要技术、目录划分、关键文件，以及新成员建议的阅读顺序。
   

• 目的：建立全局理解。
• 做法：打开项目目录，让 Codex 阅读后输出项目说明。

将首页顶部主按钮的背景色改为蓝色，其他样式和布局保持不变。完成后说明修改的文件和行号。

• 目的：验证 Codex 能否定位文件并正确修改。
• 做法：选择可见且影响小的改动。

下面这段代码我不太理解。请用非技术人员能理解的方式逐段解释其功能，重点说明为什么这样写，不必逐行翻译语法。

• 目的：将 Codex 作为代码阅读工具。
• 做法：选择复杂逻辑，让其逐段解释。

请从代码质量角度通读当前项目，找出重复逻辑、潜在 Bug、安全风险和性能隐患。先列清单，不要修改。

• 目的：利用审查视角发现潜在问题。
• 做法：先列问题清单，暂不修改。

    
终端报了以下错误。请先阅读相关文件，定位原因，并说明准备修改的位置。等我确认后再动手。

• 目的：体验完整修复流程。
• 做法：提供终端报错，要求先定位再修改。

请为这个项目生成 README，包含项目简介、安装步骤、启动方式、目录说明和常见问题。完成后注明哪些内容由代码推断，哪些需要我补充。

• 目的：处理低风险、高收益任务。
• 做法：生成 README、部署说明或接口文档。

请为这个模块补充单元测试，覆盖主要分支和边界情况。完成后运行测试，并贴出结果。

• 目的：让 Codex 参与工程质量工作。
• 做法：指定模块，补充单元测试。

请根据当前未提交的改动生成一条 Commit Message，格式为 type: subject，正文分点说明主要改动。

• 目的：嵌入日常开发流程。
• 做法：根据未提交改动生成 Commit Message。

请从当前空目录开始，创建一个个人博客网站。先用静态页面实现，包含首页、文章列表页和文章详情页。技术选型由你决定，但开始前先说明方案。

• 目的：了解从零搭建能力边界。
• 做法：给出明确小项目目标。

完成九步后，可判断哪些任务可放心交给 Codex，哪些需要监督，哪些暂时不适合。

接入DeepSeek

若使用频率高，API 费用是现实问题。GPT-6 Astra 的 API 标准价格为每百万输入 Tokens 10 美元、每百万输出 Tokens 50 美元。DeepSeek 在代码和日常任务上性价比较高。注意：DeepSeek 不支持多模态，不能读图。 若需处理图片、视频，或依赖 Codex 原生 Agent 能力，建议继续使用 GPT-6 Astra。主要场景为写代码、改文档、日常任务时，可考虑接入 DeepSeek。

准备三样：

1. Codex 客户端：官网下载对应系统版本。
2. DeepSeek API Key：在 DeepSeek 开放平台注册后创建，sk- 开头。
3. 转接工具：cc-switch 或 Codex++。

cc-switch 操作

1. 安装 Codex，先不登录，关闭应用。
2. 安装 cc-switch。Mac 可用 Homebrew，或从 GitHub 下载。
3. 打开 cc-switch，切换到 Codex 标签，点击右上角 +，供应商选择 DeepSeek。
4. 粘贴 DeepSeek API Key，其他保持不变。
5. 开启 “需要本地路由映射”。
6. 进入设置中的 “路由”，打开 路由总开关 和 Codex 路由开关。
7. 回到主页，点击 DeepSeek 旁的 “启用”。
8. 打开 Codex，显示 “已通过 API 密钥登录” 即表示成功。

验证：模型菜单可能不显示 DeepSeek。前往 DeepSeek 开放平台查看账单，有扣费记录即表示已使用 DeepSeek。

注意：

• API Key 仅粘贴到本地配置工具，不要截图发群、发笔记或评论区。
• DeepSeek 账户余额不能为 0。

Codex++ 操作

Codex++ 是面向 Codex App 的外部增强启动器，不修改原始安装文件，通过外部 launcher 启动 Codex 并注入增强脚本。

1. 从 GitHub 下载并安装 Codex++ 管理工具 和 Codex++ App。
2. 打开管理工具，进入 供应商管理 → 新增供应商，从预设模板选择 DeepSeek。
3. 填入 API Key，保存。
4. 点击 “使用” 旁的测试按钮，返回 HTTP 200 即表示连通。
5. 通过 Codex++ 启动 Codex，模型列表出现 DeepSeek V4 即成功。

注意：API Key 不要外发，余额保持充足。

进阶七项

以下七项用于提升 Codex 使用效率。

工作区权限

工作区

原则：只打开完成当前任务所需的最小目录。 选错目录会导致找不到文件、修改错误位置或读取无关材料。

• 只改一个独立项目：打开项目根目录。
• 只分析不修改：打开正确目录，权限设为只读。
• 任务在远端执行：选择 Cloud，不要扩大本地权限。

权限三档

Codex 包含三种内置权限档位：:read-only 保持本地命令执行只读；:workspace 允许在当前工作区根目录和系统临时目录内写入；:danger-full-access 移除本地沙箱限制，仅在有明确意图时使用。

审批弹窗需检查四件事：

• 准备执行什么命令。
• 在哪个目录执行。
• 是否需要网络。
• 对当前目标是否必要。

涉及安装依赖、上传文件、删除数据、修改账号设置、对外发布和访问凭据时，应停下确认。

环境选择

在 Codex 中启动对话时，需选择运行环境： Local 直接在当前项目目录工作；Worktree 在 Git worktree 中隔离修改；Cloud 在远端环境中运行。Local 和 Worktree 均在本地计算机上执行。

总结：单任务用 Local，并行用 Worktree，异步用 Cloud。

学习节奏

按四阶段推进，不必一次性安装所有功能。

1. 基础生存

• 选对工作区。
• 新建任务。
• 控制只读与工作区可写。
• 学会查看 Diff。 能判断 Codex 改了什么、是否越界，即完成基础。

• 加入 Plan、终端和 review。
• 复杂任务先看计划。
• 完成后自行检查，再让独立审查查看改动。

• 学习 Worktree 和多任务。
• 仅当存在两个互不依赖的任务时并行。

• 重复工作固化为 Skill。
• 需要外部系统时接入 MCP。
• 需要整套能力时安装 Plugin。
• 需要定时或跨天运行时启用 Automation 和 /goal。

验收速查

Codex 的使用效果取决于：是否提供正确材料和边界、是否及时纠偏、是否通过 Diff、终端、测试和页面判断结果。 仅凭“已经完成”不足以确认结果。

你是派活的人，也是验收的人。Codex 负责执行，你负责判断。