Codex 详细安装教程 2026年最新版

Codex 是 OpenAI 推出的 AI 代码智能体（Code Agent），不是简单的代码补全插件，它可以直接读取你的项目代码、修改文件、执行命令，完成从代码生成、调试到批量运维的复杂任务。

一、什么是Codex?

Codex 是一款基于云端的软件工程智能体，由 codex‑1 模型驱动——这是 OpenAI o3 的一个变体，专为软件开发进行了优化。与传统的代码补全工具不同，Codex 能够自主执行端到端的编程任务——从编写功能、修复缺陷，到运行测试、创建合并请求（pull request）——所有这些都在一个预先加载了你的代码仓库的隔离云端沙箱中完成。

它支持并行任务执行，也就是说，多个智能体可以各自独立地处理不同的任务。Codex 能够理解自然语言提示，遵循项目的既定规范（通过 AGENTS.md 文件），并可运行诸如代码检查工具（linter）、类型检查器和测试框架等命令，直到结果全部通过为止。

二、安装前准备

2.1、系统要求

支持 Windows 10/11、macOS 12+、Linux 全发行版
Windows 原生支持为实验性，推荐使用 WSL 子系统获得更稳定体验
最低内存要求 8G，推荐 16G 以上，处理大项目更流畅

2.2、依赖准备

Node.js ≥18.0，推荐 22+ LTS 版本（旧版本会出现语法兼容错误）
npm ≥10.0
可选：Git，用于项目版本控制与集成

2.3、账号准备

官方使用需要 ChatGPT Plus/Team/Enterprise 订阅账号，可直接登录使用。（参考：ChatGPT账号注册教程）

二、Codex 安装教程

3.1、IDE 插件

我们以 Cursor 安装为例

打开 Cursor 的扩展市场
搜索Codex，认准OpenAI 官方的插件
安装完成后，侧边栏会出现 OpenAI 的 Logo，点击即可打开 Codex 面板
登录你的 ChatGPT 账号，即可开始使用

3.2、CLI 安装

Mac/Linux 安装

方式一：npm 安装（推荐）

先安装 Node.js：
Ubuntu/Debian：
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo bash – sudo apt-get install -y nodejs
macOS：
# 先安装Homebrew（如果没装的话） xcode-select –install /bin/bash -c “$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)” # 安装Node brew install node
验证 Node 版本：
node -v # 应显示v22.x或更高 npm -v
安装 Codex CLI：
npm install -g @openai/codex # 国内网络慢的话，用淘宝镜像加速： # npm install -g @openai/codex –registry=https://registry.npmmirror.com

方式二：Homebrew 安装（Mac 专属）

brew install codex

Windows 安装（推荐 WSL）

Windows 原生 CLI 支持不完善，推荐使用 WSL 子系统：

开启 Windows 功能：
打开「启用或关闭 Windows 功能」，勾选Virtual Machine Platform和Windows Subsystem for Linux
安装 Ubuntu：
wsl –install -d Ubuntu-24.04
重启电脑后，进入 WSL 终端，按照上面的 Linux 步骤安装 Node 和 Codex 即可。

验证安装

安装完成后，执行：

codex --version
# 输出版本号如0.77.0即表示成功

3.3、客户端版本

访问官方下载页：https://chatgpt.com/zh-Hans-CN/codex/
下载对应系统的安装包，按照向导完成安装
登录 ChatGPT 账号即可使用，支持拖拽文件夹、可视化任务进度查看

和 ChatGPT 的界面有点像，但多了不少东西。比如右上角有个终端图标，点一下就能打开终端。底部可以切换 Local、Worktree、Cloud 三种模式。模型选择也更丰富，有专门的 Codex 模型可以选。

四、Codex 使用 Skills

Codex 使用 Skills 的逻辑就是：把你常用的工作流程固化成一个「技能」，以后一键调用。

4.1、Codex Skills 创建：三种自定义方式

方式一：直接新建

点击 Skills 页面右上角的「New Skill」，填写技能名称和描述，定义输入输出，保存就行。

方式二：对话中创建

这个更自然。你在对话里让 Codex 帮你做了一件事，做完之后直接说「把刚才的流程保存成一个 Skill」，它就会自动帮你创建。

方式三：行为固化

做完某件事之后，让 Codex 把这个行为抽象成通用技能。比如你让它写了一篇产品介绍文章，可以让它把「根据关键词检索资料并撰写文章」这个流程固化成技能。以后有新产品发布，给个关键词就能自动跑。

4.2、Codex Skill 存放路径配置

Codex 会自动扫描以下位置来加载 Skill：

范围	路径	用来干什么
仓库	项目根目录 `.agents/skills/`	团队共享，提交到 git 一起管
用户	`~/.agents/skills/`	个人通用，所有项目都能调
系统	`/etc/codex/skills`	机器级配置，管理员场景

个人用的话，把 Codex Skill 丢到 ~/.agents/skills/ 里最省事。所有项目通用，不用每个项目单独配。

团队项目里有固定工作流的，放仓库根目录的 .agents/skills/，提交到 git，团队所有人都能用同一套 Skill。

五、Codex常见问题

1、在安装过程中，最常见的问题是什么？

绝大多数新手在执行 Codex安装教程时，卡在最核心的一步往往是由于本地网络出口环境被大模型官方的安全防火墙拦截，从而频繁遭遇 Connection Timeout。建议在配置初期就接入静态网络节点，从根本上解决链路中断问题。

2、我完全不会代码，可以用 Codex 吗？
可以，但建议从“解释项目”“整理文档”“读报错”“写学习路线”开始，不要一上来让它做大范围重构。

3、Codex Skill 安装后不生效怎么办？
检查三点：文件路径是否在 Codex 的扫描目录下（~/.agents/skills/ 或项目的 .agents/skills/）、文件名是否为 SKILL.md、description 是否写得足够具体。如果路径正确但仍无法加载，尝试重启 Codex。

4、Codex 安装教程还适用于哪些开发工具？
Codex 同样适用于 Cursor、VS Code、JetBrains、Qoder 等全球主流的 AI 研发集成环境。

文章版权归作者所有，未经允许请勿转载。

THE END