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 完整使用指南：教程、案例、白嫖网站，看这一篇就够了！》
页:
[1]