AI 编程神器 OpenAI CodeX 完整教程:基本概念、安装配置、MCP、CLI+IDE运行、开发案例,看这一篇就够了

我爱免费

作者：微信文章
这几天谷歌 Gemini3.0 大杀四方，

但它的人气来主要来自于 Nano-Banana2。

在 AI 编程方面，谷歌始终被 OpenAI 按在地上摩擦

谷歌自己做的评测报告中，GPT5.1 的“代码调试”评分也高于 Gemini3.0，

全网集中火力用了两周后，专业领域逐渐达成共识：

Gemini3.0 前端界面设计不错，但复杂项目不能胜任

而 GPT5.1，指令遵循更强，运行更稳，适合复杂项目的规划和开发

上次我们介绍了 OpenAI 出品的 AI 编程神器 CodeX，

近期 CodeX 也升级到了 5.1 版

我试用了一下，更加丝滑了

下面这个本地运行 Nano-banana 的小程序，就是我用 Codex 半小时搞定的，完全实现了做图自由



CodeX 刚上线的时候，我们浅尝辄止介绍过两期：

《AI 编程新王诞生！OpenAI 祭出 GPT5-Codex，拳打 Claude，脚踢 Cursor》

《用 AI 协作写游戏：在 CLI 下用 Codex + Gemini 实现 Python 贪吃蛇》

今天，我再系统地和大家分享一下CodeX 的完整教程

包括基础概念、注册安装、运行方式，MCP 配置等进阶功能，最后还结合 Vs code 和 openruter，完成一个项目的开发。

开发+写，爆肝4小时！

今天的内容非常干货，适合新手，不但能掌握 CodeX 的基本操作，还能作为 AI 编程的入门手册。建议大家收藏、关注、转发。
一、Codex 是什么

CodeX 是一个 AI 编程工具，类似的软件还有 Claude Code，Cursor。

它们如今在程序员心中的地位嘛，见下图：



AI 编程，又称之为 Vibe Coding（氛围编程）。主要指人类协调、指挥 AI 工具，完成程序开发。人类负责定目标、拟规划、提要求，AI 负责代码编写。你甚至能让一个 AI 写程序，另一个 AI 审。

问了一个资深程序员朋友，他说：用了 GPT5-Codex 后，大部分代码都给 Codex 写了，基本上都全对，很少有错的，主要是能搞定大型目，一次可以让 Codex 读几十个文件，几千行代码，然后去理解整个项目做修改，Cursor, Cloude Code 都被甩在后面了。

有了 AI 加持，人越来越向全栈工程师发展，

有位阿里出来的大佬玉伯甚至说“AI 让人可以很多事情可以独自完成，不用协作了”！



Codex 的官方介绍

OpenAI 对 CodeX 的介绍

https://openai.com/zh-Hans-CN/index/introducing-codex/

OpenAI 甚至还出了一本如何使用它的应用手册



下载地址：https://cdn.openai.com/pdf/6a2631dc-783e-479b-b1a4-af0cfbd38630/how-openai-uses-codex.pdf

我帮大家做了个脑图，有兴趣的朋友可以看原文


二、CodeX 的运行方式

CodeX 有四种运行方式：CLI(命令行）、IDE、SDK、云端

方式 1：先说 CLI(命令行）运行

安装

CLI 运行需要 javascrip 环境

所以要安装一个 javascrip 环境运行工具 node.js

到https://nodejs.org下载最新安装包即可



如果你不是最新版，有可能还需要安装 nmp（node.js 自带的管理工具包），所以建议直接再装一次最新的 node.js

node.js 安装后，进入命令行（按 win+R，再输入 cmd 回车；或者在任一文件夹窗口输入 cmd 回车）

输入安装命令 npm install -g @openai/codex



CodeX 的 CLI 模式就安装完成了

启动

命令行下输入CodeX，就进入 codeX 了

进入后会跳出一个网页窗口，要求你验证 GPT plus 会员

开通 GPT Plus 会员

首先注册一个免费的 GPT，科学后到 chat.openai.com 注册

GPT 注册目前不需要验证手机，用 2925 邮箱（ www.2925.com）或者 QQ 邮箱就可以搞定。

但是免费 GPT 用户不能使用 CodeX，需要升级到 PLUS 会员。

坏消息是要收费，国内可以代充，大概 180 元/月。充值方式详见《全程自助！五分钟搞定 ChatGPT Plus 官网充值续费》

好消息是有了 Plus 会员，基本可以畅用 codex 的 5.1 高级模型。

另外，codex 可以用国内免费模型，不过一来配置麻烦，二来意义不大。要用就用好的。Plus 账号是一个月一个月开，随开随停，就算下个月不续费了，账号、信息也不会丢。

想把 AI 作为生产力工具或者想体验一下的小伙伴，强烈建议开通 1、2 个月的 PLUS 试试。

不信看我下面的操作。尤其是 VScode 下的协作，保你大开眼界。

验证通过后，就可以在命令行和 codex 对话了。



上图选 2，进入下图：



输入/model 可以切换模型。其他是常见的 codex 命令，如下：



教大家一个小诀窍，全程开着 GPT，前期运行报错或者不理解的地方，就抓图给 AI，让它答疑解惑。

编写程序

开了 codeX 后，输入命令就可以执行了

使用的时候要一直全域科学，因为它要去调用 OpenAI 官网的大模型

输入：做一个 HTMl，编写一个贪吃蛇游戏，可以直接运行



马上搞定，直接做好了这个网页



文件位置

注意：你在哪里运行 cmd，codex 就会把程序放到哪个文件夹

MCP

MCP 学名叫模型上下文协议，其实就是一个标准化工具箱

你可以通过 MCP 来调用很多其他人编好的功能组件



在 MCL 下，输入/mcp，可以看已经安装的 MCP 工具



下面说说如何安装

以https://github.com/upstash/context7为例

进入上述网址后找到 codex 安装代码



复制代码后到本机打开 codex 的配置文件

有一个叫 .codex 的文件夹，里面有个 config.toml，这就是 codex 配置文件



用文本编辑器打开，粘贴刚才的代码



保存退出，重启一次 codex（按 ctle+C 退出）

你再到 codex 命令行输入/mcp,就可以看见这个 MCP 了

再比如 code 操作 Excel 表的 MCP 如下

https://github.com/haris-musa/excel-mcp-server

安装方法如前（有些 MCP 接入代码不能直接拷贝，报错就把代码贴给 GPT，让它改）



在命令行输入：做一个exce1表，模拟30个小学生的期中考试成绩



工作过程



工作成果



agent.md 文件

codex 还有一个重要文件，叫 AGENTS.md

你可以理解为它就是一个编程项目的说明文件

每次你启动编程的时候，AI 都会先读一次这个文件

AGENTS.md = 专门用来告诉 Codex“你希望它怎么帮你写代码”的说明书。 AGENTS.md 让 AI 更能理解整个编程项目，作为编程的上下文

它不是普通的文档，而是Codex 的“行为配置文件” → 你的项目的“规则手册”。AGENTS.md = 告诉 Codex：

你是谁？你这个项目要做什么？代码风格是什么？文件结构怎么组织？命名规范是什么？要不要写注释？你对它的要求是什么？

有两个方法生成 AGENTS.md

第一，自动生成

当你在 codex 里运行 /init 时，它会自动生成 AGENTS.md。

第二，手动写

可以让 AI 分析项目，然后复制内容到 AGENTS.md 中

具体怎么写我们在 IDE 运行方式再介绍。

看了上面的操作，是不是觉得很麻烦？

是的，因为大部分人都是用 IDE 来调用 Codex

方式 2：codex+ IDE

什么是 IDE，就是大家用的 VS code，pycharm

下面以 VS code 为例

安装

先装 VS code，然后在 VS code 中安装 codex 插件即可

VS code，微软出品的免费桌面编程软件

网址 https://code.visualstudio.com



下载安装即可，有新版本，它会自动更新

界面如下：



注意我用红框框起来的，就是 code 插件，刚装的 vs code 没有这个插件

安装方式如下，选侧边栏的插件按钮，搜索 codex，安装后重启 vscode



就看到 oepnAI 的图标了，这就是 codex



它也需要先验证 GPT plus，然后会自动同步你在命令行的一些提示

先看最下面，这里基本就是核心配置了



① AI 对话界面：你可以在这里输入指令，询问 AI 问题，让它写代码

② 是否让 AI 看对话上下文

③ 选择本地还是服务器运行写好的程序

④ 定义 AI 权限



这个很重要，chat 模式，AI 只能和你聊；agent，可以做一些事情，但是每个编辑动作都要你确认 ；Agent（full accese）可以像人一样编写删除文件。

一般是先聊，chat 确定 AGENTS.md 内容，然后再用 Agent（full accese）让 AI 生成 AGENTS.md

⑤ 选模型



⑥ 选推理模式

越高越慢



后面我们用编写一个本地运行 banana 的网页来具体介绍

方式 3：SDK

小白用得少就不介绍了

方式 4：云端运行

国内很多公司严谨上传代码到云端，特别是 giehub

也不介绍了，要知道如何配置可以看前面的文章《AI 编程新王诞生！OpenAI 祭出 GPT5-Codex，拳打 Claude，脚踢 Cursor》

我们后面介绍code开发网站的时候，再介绍，可以实现github一键部署
三、案例：VS code +CodeX 制作一个图片制作小程序

这两天 nano-banana pro 很火，我们就用 VS code +CodeX 制作一个 nano-banana pro 做图片的小程序

做好的下产品界面如下



实现功能很简单，输入提示词，调用 nano-banana pro 做图片



第一步，编写项目规范

先和 AI 沟通，项目开发规范。就是我们前面说的 AGENTS.md

还记得前面我们介绍的 OpenAI 公司写的如何使用 CODEX 么？

有个地方是这样的:先从 ask 模式，开始，制定计划



这个 ask，现在已经升级为 “chat”模式了

进入 ask 模式，先和 AI 聊

我说：Hi 工程师，我们需要一个网页工具，主要用 Gemini Nano 模型来生成图片。同时要支持用户自己输入他们的 OpenRouter 的 API Key。这样用户输入提示词就能生成并下载图片



就像项目经理、产能经理和程序员聊天一样



聊得差不多了，切换到“Agent（full accese）”模式。让它写这个 agengt.md。codex会直接创建一个agengt.md文件到你的项目文件夹。



打开看看



不满意可以让 AI 改，它会自动更新

注意：每个项目都要有一个agengt.md作为开发规范。

比如下面是我的项目文件夹。按照数据分析、网站开发、办公进行了分类，每个文件夹下面，都有一个子 agengt.md。内容也不同



网页编程

然后就要求codex开始编写这个网页

它会直接在文件里生成 html 文件，然后我来运行，有报错就告知它



这个时候，你化身测试员。你可以把报错的代码、页面截图，第三方接口的开发文档发给它，让它完善



完全把它当做一个真正的程序员，类似于你和同事在微信聊天，他开发，你评测，有任何问题都反馈给它。反复几轮就得到一个可以运行的版本了

是这样的



这里我调用的是全球最大 AI 中间商的 nano-banana APIkey

网址：https://openrouter.ai



可以通过微信或支付宝充值，充值后就可以用。用的时候不需要科学



codex 知道 openrouter 的接口，唯一要小心的是 一些新模型名称可能 gpt 不知道

在刚开发的网页中输入这些接口、api key，其实 codex 除了秘钥都写好了



核心功能运行好了后，我又让 codex 加了做图的功能、自定义其他第三方 API 的功能、选择画面比例、隐藏设置、美化界面等等

我们先跑起来，然后让 AI 改细节。这里有个技巧，我喜欢要求 AI 后面的更新自动另存一个版本。边指挥AI，我还边开了个网络会议。

大概改了 8 个版本，达到了要求



看看这个版本：



我输入提示词：图 1 美女和图 2 的帅哥并排坐。

以后给大家讲课，旁边就有人红袖添香了。



想用的话到这个地址下载。API key 需要你们自己准备

通过网盘分享的文件：index-v1.08- 稳定版.html 链接: https://pan.baidu.com/s/1q-lP_9inrzuA0r1DcF8dlQ?pwd=b1ap 提取码: b1ap

类似 flux2，马上出的 GPT 的 imange 都可以集成进去

OK。总结下，用codex开发，真的异常丝滑，感觉我更像是一个项目经理、一个产品经理、一个用户，而不是开发人员。这才是真正的vibe coding 氛围编程。

今天的分享就是这样。文章有点长，如果你都看到这里了，记得给我点赞+关注+分享哦

文章集锦：

《Sora 再升级，满足你所有中二梦想》

《看了小鹏的机器人，感觉“西部世界主题乐园”可以立项了！》

《GPT-5 入门到精通：2025 年版保姆级图文+视频教程》

《一手实测 GPT 群聊功能，OpenAI 又给同行们指明方向！》

《GPT 写论文保姆级教程（AI 辅助选题 → 写作 → 查重）》

《Nano-banana 完整使用指南：教程、案例、白嫖网站，看这一篇就够了！》