忍不了！Claude Code 又封号？果断换 Codex 了

AI训练营10期，6月底开班，欢迎咨询

作为一名Claude Code的忠实用户，前些日子，我们做了一门针对小白（非技术人员）的 AI Coding 课件，毫无疑问直接选择了 Claude Code啊！

但是接下来问题就来了，这个东西对小白来说门槛较高，仅仅是安装就会劝退不少人，其次就是老是有同学问我账号问题，也是比较烦的，所以我强烈推荐大家去使用 Codex...

这里先简单普及下Codex是什么？

Codex，是 OpenAI 对标 Anthropic 的 Claude code 产品，基于自家模型封装的上层Agent应用。

简单理解就是：你把一个项目目录交给它，然后用自然语言告诉它你想做什么，它会自己阅读代码、修改文件、运行命令、修复报错，最后把结果交给你确认。

再说，为什么我推荐Codex？核心还是 CC 这东西太不听话！

用过 Claude Code 的同学应该都知道它搭配 Claude 自家模型，能力极强，但是 Claude 模型价格是真贵，使用门槛也是极高，对中国用户非常不友好，即使你绕过了这些限制，保不准哪天账号又被疯了！

而 Codex 真是业界良心，使用门槛低，价格便宜，搭配的模型能力跟 Claude 4.6差不多，关键是订阅了 Chat GPT Plus/Pro 的用户可以免费使用Codex的。

现在Codex中可以使用最新的 GPT-5.3-Codex、GPT-5.4、GPT-5.5 等模型，速度快、编码能力强，体验拉满，最近我把主力编程工具 Claude Code 也切换到了 Codex 中来。

PS：去你的 Claude Code，早晚被自己玩死！

下面我整理了一份Codex保姆级的安装使用教程，帮助大家快速上手，少踩坑。

Codex的几种产品形态？

Codex 目前主要有几种使用方式：

如果你是新手，我建议优先选择桌面端 App。

因为桌面端 App 的交互最直观，可以打开项目、创建会话、预览页面，还可以直接在页面上点选元素做标注，非常适合刚开始接触 AI Coding 的同学。

如果你平时已经在 VS Code、Cursor、Windsurf 里写代码，那就直接装编辑器插件，工作流最顺。

如果你是程序员，并且是终端爱好者，那 CLI 是最灵活的方式。

当然，这几种方式并没有优劣之分，因为它们的底层能力都是基于 Codex CLI，只是交互形式不一样。哪种方式最容易上手，就先用哪种。

确定了使用模式，下面我看看每种模式如何安装使用。

如何安装Codex?

Codex的安装过程非常简单，下面CLI、桌面端APP、插件三种形态任选其一安装即可。

环境依赖

在安装 Codex 之前，我们得先准备三个东西：

1. ChatGPT 账号（需要魔法）
2. Node.js
3. Git

如果你只使用桌面端 App，理论上不需要自己手动装 Node 和 Git。

但如果你要用 CLI，或者后面要让 Codex 帮你跑项目、安装依赖、提交代码，那 Node 和 Git 基本是必备的。

如果你不确定是否已经安装了，可以打开终端窗口，然后依次输入如下命令，在按回车键。

node --version
git --version

如果已经装了，就会像下面一样显示版本号。

如果没有安装，就会提示命令不存在，那就按照如下地址先把依赖安装上：

Node.js 下载地址：https://nodejs.org/zh-cn/download

Git 下载地址：https://git-scm.com/install/windows

安装完成后，在重新执行前面的命令检查是否安装成功。

安装CLI

前面的基础环境装好后，Codex CLI安装非常简单了，打开终端命令行，输入如下命令，记得按回车键。

npm install -g @openai/codex

如果执行上面的安装命令报网络错误，可以尝试切换npm镜像：

npm install -g @openai/codex --registry=https://registry.npmmirror.com/

安装结束后，验证安装是否成功：

codex --version

看到版本号输出，就说明安装成功了。

安装桌面端APP

下载地址：https://chatgpt.com/zh-Hans-CN/download/

桌面端APP的安装非常简单，根据你的电脑操作系统选择对应的版本安装即可。安装完成之后，打开 App，使用 ChatGPT 账号登录

安装插件

Codex支持在VS code、Cursor、Windsurf、JetBrains等编辑器以插件的形式使用，下面以VS code为例，在插件应用市场中搜索Codex，点击安装即可。

安装完成后，登录 ChatGPT 账号，就可以在编辑器右侧打开 Codex 面板了。

如何使用Codex?

说完安装，下面我们继续看如何使用Codex。

在桌面端使用

打开桌面软件Codex，登录进来之后，看到如下界面，非常简洁。

如果我们要开始一个项目，首先点击左侧菜单栏的Project，打开项目目录，这里以ai-coding-website为例子。

在项目名称右侧，点击编辑图标，会新建一个线程或者会话。

注意，此时主界面输入框左下方的目录名称，变为了当前项目的名称，然后我们就可以在输入框中输入我们的需求

使用html+tailwindcss，创建一个仅支持账号、密码登录的登录界面

按下回车键，Codex就会根据我们的要求，在当前项目目录下开始干活了。

如果我们还有其它独立的任务需求要做，可以在当前项目下再开一个新会话，输入我们的新需求，按下回车。

使用html+tailwindcss，创建一个支持输入账号、密码的注册界面

此时，两个会话会同时进行任务开发。

开发完成之后，可以直接在Codex内置的浏览器中预览效果。

如果对页面上某个元素不满意，可以点击浏览器右上角的加号图标，切换到标注模式。

我们可以通过鼠标选择页面上的元素，添加修改备注，然后发送给Codex继续调整。

这种模式非常适合新手，因为你不清楚代码在哪个文件里，只需要告诉它：这里不对，要怎么改。非常方便的让我们更精细的控制界面元素的调整。

前面我们添加了一个项目，并开了两个任务同时执行。

除此之外，我们还可以打开多个项目，在多个项目下创建会话任务，让Codex同时进行，并且这些任务之间是互不干扰的。

在Codex的逻辑里，左边这栏分为两层：

第一层是文件夹或工作区

你可以把它理解成一个个项目目录，或者一个个主题盒子，比如项目A、项目B、项目C，它负责把你的文件放得井井有条。

第二层是线程或会话

你点开某个文件夹，会看到里面一条条对话，那些对话记录才叫线程，每一条线程就是一个独立的任务。

所以整体关系是这样，一个文件夹里可以有很多个线程，每条线程都是在同一个工作区里，围绕一个明确目标推进的一次协作过程。

编辑器中使用

如果你平时使用 VS Code、Cursor 或 Windsurf，那么编辑器插件会更顺手，这里以VS Code为例。

首先打开VS Code编辑器，然后点击打开文件夹按钮。

选择项目目录，点击打开

此时进入如下页面，打开右侧侧边栏，选中Codex标签栏，在输入框中输入需求，就可以让Codex干活了。

新键会话可以点击右上角的编辑按钮，此时会在当前项目工作空间下新建一个会话任务。

编辑器插件的好处是：可以一边看代码，一边跟 Codex 沟通。

比如你可以直接让它解释当前文件：

请解释当前打开的这个文件主要做什么，用大白话说明，不要修改文件。

也可以让它基于当前文件做修改：

请基于当前文件修改这个组件，把表单提交前的校验逻辑补完整。保持现有代码风格，不要重构无关代码。

对于程序员来说，编辑器插件的体验会比桌面端更贴近日常开发。

CLI中使用

在我们项目文件夹下打开终端命令行，输入codex ，此时会让我们确认是否授信Codex访问当前目录下文件资源，回车确认即可。

首次进来，会让我们选择登录方式，推荐选择Sign in with ChatGPT方式，它自动会打开浏览器，用ChatGPT账号登录授权即可。

完成登录登录后，我们就可以在输入框输入需求开始使用了。

如果想要多个任务同时执行，可以打开多个终端窗口，然后进入到Codex会话。

常用命令和快捷键

下面我看看Codex  CLI中大家日常开发会高频率用到的命令，如果只使用桌面端APP、VS Code插件，可以先跳过这部分内容。

CLI命令

下面这些命令，是在终端工具中使用的，需要注意，它们和后面的会话内置命令不是一回事。

另外还有一个比较危险的参数：

codex --dangerously-bypass-approvals-and-sandbox

这个参数会跳过确认提示和沙盒限制。只有在你非常确定当前项目可信、操作风险可控，并且你知道自己在干什么时，才考虑使用。否则 Codex 如果执行了删除文件、批量改动、安装依赖等操作，你可能很难第一时间发现问题。

会话内置命令

会话内是指我们在终端输入codex命令后，进入到如下界面。

比如我在输入区域开始输入/ ，会自动显示所有的命令。可以通过上下键切换命令，按下Tab 键可以选中使用。

键盘快捷键

如何查看使用额度

无论我们开通的是哪种等级的套餐，都会存在额度的限制，我们可以通过下面的方式查看剩余额度。

如果是在CLI中使用Codex，输入指令 /status 即可查看当前额度使用情况：

如果是在Codex App、编辑器中使用，同样可以输入/status指令查看剩余额度

如何切换模型、思考深度

Codex中我们可以根据需求选择模型型号、思考深度、响应速度。

其中，模型决定基础能力和适用场景；思考深度决定推理深度和思考时间，支持四个等级：Low、Medium、Hight、Extra Hight；响应速度决定响应优先级和执行速度，支持两种模式：Standard、Fast。

在 Codex App 中，可以直接通过可视化界面切换模型、思考深度和响应速度，操作非常直观方便。

而在CLI中，需要使用两个命令来完成，其中/model 来控制模型和思考深度，/fast 切换响应速度。

执行/model ，首先会让选择模型

模型确认后，会继续让我们选择思考深度

执行/fast 用于切换快速模式，默认情况下，Fast模式是关闭的，第一次执行会开启，再执行一次就会关闭。

大多数场景，使用默认设置即可，思考深度为Medium、速度为Standard。而其它场景，则根据任务复杂度选择推理深度等级，下面是不同等级适用场景参考：

定义AGENTS.md

前面我们已经学会了Codex的基本使用了，让它干活完全没有问题。但是我们每个人都有自己的一套工作习惯和规则，那如何把这些规则让Codex记住，并且每次干活都尊守这些规则呢？

下面我们来看Codex 规则体系是如何设计的，整体分为全局和项目级。

其实它们作用都是一致的：让AI记住我们的个人偏好或者项目规则，比如代码风格、命名规范、输出格式、技术选型、团队约定等，从而在多轮交互中始终保持稳定。

那这些规则是怎么生效的呢？

简单理解，在每次会话启动时，Codex会自动读取对应的规则文件，并把内容加载到上下文窗口中，作为系统提示词的一部分，在整个会话期间持续生效。

了解完这些基本信息之后，我们在看这些规则中应该写什么，先看全局的AGENTS.md，这里给一个例子。

## 关于我
[身份、背景、技术水平、主要用途]
我是产品经理，有 3 年互联网产品经验，正在学习用 AI Coding 做原型和小工具。
毫无编程基础，主要靠你帮我实现想法。

## 沟通偏好
- 默认中文，代码和命令用英文
- 结论先行，不铺垫背景
- 遇到模糊需求先给最合理方案，再问是否调整
- 不要客套寒暄
- 报错时先用一句大白话告诉我出了什么问题，再给解决步骤

## 个人红线
- 不要删除我已有的页面或组件，哪怕你觉得写得不好
- 不要换技术栈

实在要执行上面的操作，必须停下来问我

## 跨项目偏好
- 前端技术栈：pnpm + vite + react + typescript
- 用 Supabase 做后端和数据库
- 组件优先用 shadcn/ui
- 样式写 Tailwind css，不写单独的 CSS 文件

## 工程习惯
- 改完跑一遍 dev 看效果，不要只改不验
- 出错了找根本原因，不要注释掉报错糊弄过去
- 大功能先 Plan Mode 出方案，我确认再动手
- 新项目第一步先帮我建好项目级 AGENTS.md

这个全局的AGENTS.md跨项目共享的，全局 AGENTS.md 确定好了，顶层的规范就有了。

接下来是下一层，项目级别的 AGENTS.md。

我总结的一套公式为：规则文件 = 背景 + 约束 + 规范 + 输出 + 偏好。

1. 项目背景，让AI知道你在做什么，你的目标是啥
2. 技术约束，明确项目使用的技术栈，防止AI自由选择
3. 代码规范，定义命名方式、类型要求、组件长度、注释规范等
4. 输出要求，约束输出内容结构和格式
5. 偏好，让AI贴合个人或者团队习惯

举一个例子，仅供参考：

# 项目背景

# 技术约束
- 前端技术栈：pnpm + vite + typescript + react19 + tailwindcss + zustand + axios
- UI组件库使用shadcn/ui，不要重复造轮子
- 后端服务使用Supabase

# 代码规范
- 使用 ES modules (import/export)，不使用 CommonJS (require)
- 函数名使用 camelCase，组件名使用 PascalCase

# 工作流
- 提交前必须运行类型检查：npm run typecheck
- 测试命令：npm run test
- 优先运行单个测试而不是整个测试套件

# 输出要求
- 我不会看代码：因此不要给代码加注释，也不要生成组件说明文档，除非我特别要求
- 完成任务时，简单总结即可，不要长篇大论
- 不要留TODO

# 偏好
- 始终使用中文回复我

在Codex中，我们也可以直接使用/init初始化项目的规则，尤其是对于已经存在的项目很适合，Codex会自动去分析当前项目的情况，把项目的技术栈+规范+架构设计更新到规则文件中，在此基础上，我们在人工检查并根据需要调整。

需要注意的是，规则文件应该尽量保持精简，建议只保留需要频繁向大模型说明的内容，总行数最好控制在100行以内。

通过上面的全局规则和项目规则，我们就可以约束Codex的做事方式，让它记住我们的规则，而不是每次都重新解释。

给Codex安装Skill

什么是Skill？

Skill 就是把我们的经验 + 流程 + 方法，打包成一个 AI 可以反复使用的专业能力模块，一个Skill大致按照如下结构进行组织：

my-skill/ 
├── SKILL.md          # 【必选】使用说明 + 元数据 
├── scripts/          # 【可选】可执行代码 
├── references/       # 【可选】参考文档 
└── assets/           # 【可选】模板、资源文件 

它有个最大特性就是渐进式披露，Agent不会一次性把整个Skill的内容加载到上下文中，每次携带只是所有Skill的元信息，大模型明确了需要使用某个具体的Skill时，才会依次加载这个Skill中的内容或者脚本执行。

Skill资源

现在各行业的Skill非常的多，对应到编程场景下，我们仍然从实际使用场景出发，需要什么才安装什么。下面我看看一些对于我们非常有用的Skill。

除此之外，大家也可以在下面的资源网上自行探索，这些网站上可以发现很多高质量的Skill。但是要注意，按需安装，不要追求多。尤其是类似功能的Skill，仅保留一个即可，如果安装多个，在执行时可能会存在冲突的情况，也会增加Agent的选择成本。

如何安装？

这里以find-skills为例子，打开find-skills 说明文档。

打开终端命令行工具，粘贴输入如下命令，按回车键

这一步会让我们确认需要把这个skill应用到哪些工具，选中Codex即可。

这一步是明确安装范围，是安装到项目还是全局，这里选择全局。

这一步直接回车确认就好，就按照推荐的Symlink方式安装

这一步继续按回车

最后安装完成

如何使用？

通过上述安装方式安装的Skill，在Codex  CLI、APP、编辑器插件中都可以使用，用法如下：

在会话中输入$符号就会自动罗列出所有已经安装的Skill，通过上下键可以切换要使用的skill。

如果显示调用某个skill，可以输入$[skill-name] 进行使用，示例如下：

Skill的安装范围

在安装Skill时，需要注意安装范围，分为用户级和项目级，用户级是指所有的项目都能使用这个Skill，项目级是指仅在这个项目中能使用，其余的项目是无法使用的。

这里的建议是：对于通用的Skill或高频使用的Skill都建议安装到全局，这样只需要安装一次，所有项目都能用；对于特定项目才会用到的Skill或者是需要团队协作的就安装到项目中。

结语

好了，以上我们介绍了Codex的安装过程、使用方法、定义AGENTS.md、安装Skill等内容，希望对大家入门Codex有帮助。

最后也非常建议，尤其是新手同学，在刚开始用 Codex的时候，不要一上来就丢一个特别大并且很模糊的需求。更推荐的方式，先拿真实的小任务练手，把目标描述清楚，边界约束和验收标准定义明白，Codex给我们的结果会更稳定。

下一次，我们会用 CodeX 带着大家做一个具体简单的案例，大家可以关注下我的公众号，更多高级的Codex用法，后续在跟大家分享：