Codex零基础全指南

Codex 是什么

Codex 是 OpenAI 推出的全能 AI Agent工作台。和传统AI最大的不同是它会自己动手干活，读你电脑里的文件、操作软件、把任务做完，而不只是给建议。

一句话记住：会自己动手的 AI 助手。

四种形态，新手用桌面端

Codex有4种产品形态

形态	说明
CLI（命令行）	接入终端 / 已有工作流
桌面 App（推荐）	图形交互界面，功能最全：Computer Use、生图、批注都在它上面
IDE 插件	在VS Code等代码编辑器里用
云端 + 手机	手机遥控电脑上的 Codex / 云端跑任务

新手直接用桌面端，本指南全程以桌面端演示。

快速入门的2个心法

这是两个能迁移到任何 AI 工具学习的心法：

• 敢上手：打开陌生界面别怕。先找对话框聊两句，先按看得懂的按钮，按着按着就会了。
• AI First：遇到任何问题，第一时间问 AI——它比你更懂它自己，能帮你找到大部分问题的解法。

安装 + 基础配置

安装

1. 打开Codex官网下载（符合你操作系统 MacOS/Windows版本）

登录 & 模型接入

1. 最优方案
   1. 用 ChatGPT 账号登录（免费账号也能用，只是额度少）
2. 备选方案（如果无法搞定GPT账号 or 无法搞定充值）
   1. 方案1：通过Apple Store土耳其区购买礼品卡充值
      1. 自己动手👇
         PDFCodex苹果土区充值指南下载

         PDF 加载中…

      2. 也可以🍑宝 or 闲🐟 找相关服务
   2. 方案2：接入国内Model
      1. 接入方式同Claude Code接入国内Model
         1. CC Switch 把国内大模型接进 Claude Code【小白手把手安装步骤】
      2. ⚠️ 注意
         1. 接入国内模型有天然缺陷，比如Codex非常硬核的能力：Computer Use是完全用不了的，Image 2.0生图能力也不可能用得了，一些插件或MCP的效果也会打折扣

基础配置

1. Codex行动权限
   1. 选「替我审批」。这个设定下，Codex会自动review一切行为，安全的行为放行，不安全的行为会及时拦截或找你确认是否授权
   
2. 行为指南
   1. 跟OpenClaw、Hermes一样，Codex有一个文件叫AGENTS.md
      1. AGENTS.md可以理解为给Codex的一份行为指南，你来规定它干活的原则、思路、边界
      2. 它可以放在全局生效；也可以放在某个项目文件夹下，仅对这个项目生效
   2. “抄作业”版本
      1. Andrej Karpathy专治大模型懒惰、傲慢、不诚实的几条AGENT行动原则，直接复制全文让Codex添加到全局AGENTS.md即可生效
      复制

      # AGENTS.md
      
      减少 LLM 常见编码错误的行为准则。按需与项目专属规则合并。
      
      **取舍：** 这套准则偏向"谨慎"而非"求快"。琐碎任务自行判断。
      
      ## 1. 先想后写（Think Before Coding）
      
      **别假设。别藏着困惑。把权衡摆出来。**
      
      动手前：
      - 明确说出你的假设。不确定就问。
      - 有多种理解时，全摆出来——别默默选一个。
      - 有更简单的做法就说出来。该反对时反对。
      - 有不清楚的，停下。指出哪里不清楚。问。
      
      ## 2. 简单优先（Simplicity First）
      
      **用最少的代码解决问题。不做任何投机性的东西。**
      
      - 不加没要求的功能。
      - 不为只用一次的代码做抽象。
      - 不做没人要的"灵活性""可配置性"。
      - 不为不可能发生的场景写错误处理。
      - 如果写了 200 行而其实 50 行能搞定，重写。
      
      问自己："资深工程师会觉得这过度复杂吗？"会，就简化。
      
      ## 3. 外科手术式改动（Surgical Changes）
      
      **只碰你必须碰的。只清理你自己制造的烂摊子。**
      
      改动已有代码时：
      - 别"顺手改进"旁边的代码、注释或格式。
      - 别重构没坏的东西。
      - 沿用现有风格，哪怕你会用别的写法。
      - 发现无关的死代码，提一句——别删。
      
      当你的改动制造了"孤儿"：
      - 删掉因你的改动而不再被使用的 import / 变量 / 函数。
      - 别删原本就存在的死代码，除非有要求。
      
      检验标准：每一行改动都能直接追溯到用户的需求。
      
      ## 4. 目标驱动执行（Goal-Driven Execution）
      
      **定义成功标准。循环直到验证通过。**
      
      把任务转化为可验证的目标：
      - "加校验" → "为非法输入写测试，然后让它们通过"
      - "修 bug" → "写一个能复现它的测试，然后让它通过"
      - "重构 X" → "确保重构前后测试都通过"
      
      多步任务，先说一个简短计划：
      ```
      1. [步骤] → 验证：[检查]
      2. [步骤] → 验证：[检查]
      3. [步骤] → 验证：[检查]
      ```
      
      强的成功标准让它能独立循环。弱的标准（"能跑就行"）会逼你不断澄清。
      
      ---
      
      **这套准则起效的标志：** diff 里不必要的改动变少、因过度复杂导致的重写变少、澄清问题发生在动手之前而非犯错之后。

      展开完整代码

Codex能力全景

插件Plugins

1. Codex有非常丰富的插件市场：覆盖产品、设计、内容创作、开发、测试、办公等很多领域
2. 使用插件的方式也很简单，你只需要安装，之后在对话里面通过@插件名称，调用这个插件
   1. 示例：用Gmail插件帮我清理营销邮件
   
3. 创建/管理插件
   1. 通过自然语言创建插件
      1. 比如：创建1个插件review所有会话，生成工作流优化的insight报告

      Step 1

      

      Step 2

      

      Step 3

      
   2. 通过交互页面管理插件
      1. 你可以删除、禁用/启用某个插件

      Step 1

      

      Step 2

      

自动化

1. Codex自带自动化任务功能
   1. 类似于OpenClaw、Hermes的Cron定时任务，在Codex上你可以很轻松创建一个自动化任务，定义任务内容、任务目标、任务时间。Codex会自动触发并完成任务
      1. 创建入口
      2. 自然语言创建
      3. 在自动户模块，可管理自动化任务面板
      4. 自动化任务运行结果展示

生图

1. Codex能直接调用ChatGPT Image 2.0的模型能力，生成图片
   1. 基础用法：修图/生图/提高图片分辨率，都直接用自然语言跟Codex说即可
   2. 进阶玩法：多图创作，做连环画/分镜套图等

Computer Use

1. Codex通过Computer Use的能力，能像人类一样去操作电脑里的任意App
   1. 安装Computer Use插件（本质是个MCP）
   2. 和调用其他插件一样，用@插件名称 或 自然语言描述，启动Computer Use

手机遥控

1. 通过ChatGPT App可以远程连接电脑Codex，你可以在离开电脑的时候继续指挥Codex干活
   1. 通过Codex桌面端 - Codex移动端模块，扫码连接你的ChatGPT App（iOS和安卓都支持）