CODEX 全网最详细的 Codex 入门教程
白天模式 · 2026-04 GPT-5.5 更新

Codex 入门教程

更新时间:2026-04-27 | 作者:MaynorAI

内容简介:这版首页补充 GPT-5.5 最新官方信息,重点覆盖 Codex 的定位、获取方式、核心概念、功能配置、MCP、记忆系统、代码管理和使用流程,帮助你快速建立对 Thread、Plan、Skills 等机制的整体理解。

重点

如何获取 Codex

官方订阅

需要自备魔法,路径更接近官方体验。

第三方中转

不需要自备魔法,Codex 100刀额度适合快速跑通。

客户端下载

先安装 Codex Desktop App,再按上面的方式登录或配置。

GPT-5.5 OpenAI 最新旗舰模型,Codex 的新主线选择
2 层结构 工作区文件夹 + Thread 任务线,降低上下文污染
Plan + Skills 先规划、再开发,复杂项目更稳
01 获取方式

先知道它是什么,再决定怎么接入

这里整理了官网订阅、cc-switch 方案和桌面端安装路径,按用途拆开说明。

Codex 是什么

它是 OpenAI 的编程 Agent 产品,和 Claude Code 一样不是单纯聊天,而是围绕项目目录、线程、执行能力来做任务推进;最新 GPT-5.5 进一步增强了推理、代码修改和验证闭环。

Codex = 编程 Agent GPT-5.5 = 最新旗舰模型 更强工程执行感 更接近通用 Agent
Codex 模型介绍配图

模型介绍配图

Codex 首页界面

Codex 首页界面

GPT-5.5 最新变化

OpenAI 在 2026-04-23 发布 GPT-5.5,并将它定位为最新旗舰和最强 Agentic Coding 模型。Codex 侧重点看三件事:

  • Plus / Pro / Business / Enterprise 可在 ChatGPT 和 Codex 使用
  • Codex 还覆盖 Edu / Go,支持 400K tokens 上下文
  • Fast mode 速度约 1.5 倍,但 token 成本约 2.5 倍

方式一:官方订阅

codex 20刀充值链接,需要自备魔法,更接近官方体验。

下载应用按钮

下载应用按钮

Mac 安装包界面

Mac 安装包界面

方式二:第三方中转与 cc-switch

Codex 100刀额度和配置中转都不需要自备魔法,属于第三方中转方案。

步骤 说明 链接
1 下载安装 GitHub
2 配置第三方中转 API(不需要自备魔法) 中转额度
3 详细配置教程 Gitee 文档
02 入口地图

不要只盯着一个入口,先看任务适合放在哪里

Codex 更像一组入口协同的工作系统。不同任务放到合适入口里,效率会差很多。

入口 更适合什么 典型任务
桌面 App 本地多任务工作台 管理项目、开 Thread、用 Skills、跑自动化任务
CLI 贴近终端和本地仓库 修 bug、跑命令、补测试、解释项目结构
Cloud / Web 后台长任务和仓库协作 连接 GitHub、分析仓库、生成 PR
IDE 编辑器上下文里的局部修改 解释代码、改当前文件、做局部审查
ChatGPT 手机端 离开电脑后继续跟进 看进度、回复问题、审批操作、调整方向
MCP / 插件 连接外部工具和数据源 浏览器、Notion、Figma、飞书、GitHub、文件系统

怎么选

  • 频繁看命令输出:CLI
  • 多任务和 Skills:桌面 App
  • 长任务和 PR:Cloud / Web

手机端定位

手机端不是远程桌面,更像随身工作台:适合查看进度、回复澄清、审批操作;最终 diff review 仍建议回到电脑上做。

新手顺序

先用桌面 App 跑通小任务,再理解 CLI 和 AGENTS.md,最后再接 MCP、自动化和云端长任务。

03 核心概念

理解 Threads,才算真正会用 Codex

重点不是安装命令,而是这套工作组织方式:文件夹是工作区,Thread 是具体任务线。

两层结构

层级 名称 作用
第一层 文件夹 / 工作区 承载项目目录、资料和代码
第二层 Thread 围绕单一目标推进的任务对话线

为什么这样设计

  • 不同任务拆进不同 Thread,减少上下文串味
  • 文件和过程分离,查找路径更清晰
  • 中断后容易续写,不容易整锅乱掉
  • 适合一个项目里并行推进多个目标

黄金法则:同一个文件夹只做一个大方向,同一个 Thread 只推进一件具体的事。

Threads 首页界面

Threads 首页界面

添加项目文件夹入口

添加项目文件夹入口

添加项目后开 Thread

添加项目后开 Thread

04 项目管理

先把文件夹分清,再谈后续效率

建议先做好目录分层,例如学习资料、真实项目、沙盒和通用工具分开。

推荐结构

dev/ ├── Learning/ ├── notes/ ├── Projects/ ├── sandbox/ └── tools/

管理原则

  • 不要什么对话都乱开新 Thread
  • 真实开发项目集中放在 Projects
  • 工作区负责文件,Thread 负责目标推进
  • 前期分类做好,后面才不会越用越乱
推荐文件夹结构

推荐文件夹结构

Projects 示例

Projects 示例

飞书机器人案例

飞书机器人案例

05 功能配置

图形化能力,是 Codex 很适合新手的优势

Codex 不只是命令执行,还把定时任务、Skills、全局规则和权限配置做成了图形化入口。

定时任务

可定时巡检服务器、自动修错并通过机器人发送摘要。

Skills

支持图形化管理技能,比纯命令行方式更容易理解与维护。

Skill Creator

可直接通过自然语言创建技能,对新手非常友好。

Personalization

相当于图形界面的 `AGENTS.md`,可设置全局规则与工作偏好。

MCP

给 Codex 接浏览器、数据库、GitHub、文件系统等外部工具和数据源。

记忆系统

沉淀长期偏好、输出格式和项目规则,让协作风格更稳定。

云端运行

适合本地不方便长时间运行、或希望异步推进的任务。

电脑自动化

可用于操作浏览器、检查页面、填表和处理重复动作,但要注意权限边界。

General 推荐

  • 保持电脑开机:打开
  • Follow-up behavior:`steer`

权限建议

  • 低风险任务可用 `Full access` 提升效率
  • 高风险任务保留人工确认

推理深度

  • 日常开发:`High`
  • 难活 / 硬活 / 大活:`Extra High`
定时任务界面

定时任务界面

定时任务效果

定时任务效果

Skills 界面

Skills 界面

New Skill 按钮

New Skill 按钮

Skill Creator 输入界面

Skill Creator 输入界面

General 设置

General 设置

Personalization 设置

Personalization 设置

Full access 权限设置

Full access 权限设置

06 使用方法

推荐工作流:先跑通小任务,再 Plan,再检查 diff

这一段按真实使用习惯组织,不再沿用旧页面的 CLI 教程写法。

STEP 0

第一次任务

先做一个小而可验证的任务:添加项目文件夹、新建 Thread、描述目标、确认计划、执行后预览结果。

打开 App -> 添加项目文件夹 -> 新建 Thread -> 描述小目标 -> 检查结果
STEP 1

Plan Mode

大型项目起始阶段先进入 `/plan`,只做规划,不急着写代码。等实现计划稳定后,再确认执行。

大型项目 -> 先规划 -> 形成规范与实现计划 -> 再正式开发
STEP 2

Status 与推理档位

用 `/status` 看当期用量;常规任务用 High,需要更稳时再拉到 Extra High。

/status Low / Medium / High / Extra High
STEP 3

语音 / 文字描述需求

复杂任务里可以直接“用嘴描述需求”,把要求讲清楚比堆 prompt 更重要。

STEP 4

前端要单独盯

前端效果要第一时间看;效果不好就重做,而不是将就。

STEP 5

代码管理

让 Codex 改代码前先说文件和计划;改完看 diff、跑最小检查,确认无误再提交。

先说改哪些文件 -> 看 git diff -> 跑最小检查 -> 再 commit
Plan Mode 图标

Plan Mode 图标

Plan Mode 案例

Plan Mode 案例

计划产出结果

计划产出结果

进入开发状态

进入开发状态

推理深度界面

推理深度界面

语音输入开发方式

语音输入开发方式

07 方法模板

会派任务、会写规则,Codex 才能长期稳定干活

从 CodexGuide 里最值得补的不是中转方式,而是这套任务方法、AGENTS.md 和安全边界。

任务六要素

  • 目标:一句话说明结果
  • 背景:给出现象和上下文
  • 范围:限定模块或文件
  • 约束:写明禁止事项
  • 验证:给出命令或检查方式
  • 交付:要求总结改动和风险

AGENTS.md

把项目规则写进仓库根目录,让 Codex 每次进项目都知道命令、风格、边界和验证方式。

# AGENTS.md ## 项目概览 ## 常用命令 ## 代码规范 ## 安全边界 ## 交付要求

安全边界

低风险任务自动化,高风险任务人工确认。删除、部署、数据库、支付、认证、密钥和生产资源都不要无脑放行。

先说明命令和影响文件 不读取 .env / token / 密钥 不执行删除 / 部署 / 迁移 除非用户明确确认
真实场景 Codex 可以怎么用 验证重点
PPT / 演示文稿 生成结构、页面文案和初版素材 结构、视觉统一、导出效果
Obsidian / 知识库 整理文章、建立索引、生成选题池 文件路径、链接、来源准确性
浏览器自动化 检查网页、填写测试表单、截图验证 页面状态、点击路径、是否误提交
Figma / Notion / 飞书 读取设计稿、知识库或协作数据 权限范围、字段映射、写回位置
GitHub Actions CI 分析失败日志、定位原因、提出最小修复 失败复现、测试通过、PR 描述清楚
08 命令速览

常用斜杠命令与并行开发习惯

`/plan`

进入规划模式,适合从 0 到 1 的大任务。

`/status`

查看用量和剩余额度,判断当前周期资源情况。

多 Thread 并行

可以同时推进多个 Thread,提高并行开发效率。

斜杠命令界面

斜杠命令界面

Status 用量界面

Status 用量界面

多 Thread 并行开发

多 Thread 并行开发

前端能力问题示意

前端能力问题示意

09 总结

会用 AI 写代码,会变成像会用 Excel 一样基础

对程序员来说,Codex 是提效工具;对非程序员来说,它更像是把原本跨不过去的门槛直接铲平。真正关键的不是会不会写 prompt,而是会不会组织任务、约束目标、检查结果。

10 快速参考卡

把常用设置做成一张速查卡

项目 推荐值 / 结论 说明
核心模型 GPT-5.5 OpenAI 最新旗舰模型;GPT-5.3-codex 属于历史主打认知
Follow-up behavior steer 便于开发过程中持续微调任务方向
权限 低风险 Full access,高风险人工确认 兼顾持续执行效率和安全边界
日常推理档位 Medium 先按默认档位跑,速度与成本更稳
复杂任务档位 High / Extra High 用于难活、硬活、大活,注意成本和速度
常用命令 `/plan`、`/status` 一个管规划,一个看资源使用
代码管理 先看 diff,再提交 小任务小提交,避免无关改动混在一起
进阶能力 MCP / 记忆 / 云端 / 自动化 先掌握基础工作流,再逐步接入高级能力