首页 Codex 2026 下载与安装全指南:桌面版、CLI、IDE 插件三种方式详解

Codex 2026 下载与安装全指南:桌面版、CLI、IDE 插件三种方式详解

更新于 2026-10-08

Codex 是什么?AI 编程智能体能做什么

Codex 是 OpenAI 推出的一款 AI 编程智能体,也被称为 Codex CLI。与常见的 AI 代码补全工具不同,补全工具只能提供建议,而 Codex 能够真正动手操作——它可以读取你本地项目中的文件、生成和修改代码,并直接在终端里执行命令。你可以把它理解为一个随叫随到的 AI 程序员搭档,只要用自然语言描述想要实现的功能,剩下的工作由它来完成。

Codex 安装包下载方式

Codex 安装包下载地址:Codex安装包(源自 Github 官网,放心使用) 夸克网盘下载

Codex 三种安装方式详细步骤

1)桌面版(GUI)安装

Mac 用户双击 dmg 安装包,将 Codex 图标拖入”应用程序”文件夹,然后从启动台打开。

Windows 用户推荐使用 zip 免安装版(OpenAI.Codex_26.602.4764.0_x64免安装版.zip),解压后找到对应文件,以管理员身份运行:

Codex 启动后的界面如下:

也可以选择 Msix 安装包,双击运行:

安装程序会自动执行,无需手动点击多个”下一步”,等待完成即可。安装结束后,在开始菜单搜索 Codex 就能打开。如果找不到,可尝试重启电脑。

2)CLI 命令行版安装(适合开发者)

CLI 版面向习惯终端操作的开发者,无需图形界面,轻量高效,以下介绍三种安装方式。

方式一:直接运行可执行文件

双击 codex-x86_64-pc-windows-msvc.exe 启动:

首次运行需要登录 OpenAI 账号,CLI 会在终端中提供一个链接,在浏览器中打开并登录授权即可。

方式二:通过 npm 安装

如果你的电脑已安装 Node.js,打开终端(Windows 用户使用命令提示符或 PowerShell,Mac/Linux 用户打开终端),执行:

npm install -g @openai/codex

-g 表示全局安装,安装完成后在任何目录打开终端输入 codex 即可运行。若遇到权限错误(Mac/Linux 常见),在命令前加 sudo:

sudo npm install -g @openai/codex

国内用户下载 npm 包可能较慢,建议使用淘宝镜像源加速:

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

安装完成后运行 codex --version 验证,显示版本号即表示安装成功。

方式三:通过 Homebrew 安装(仅限 macOS)

Mac 用户若已安装 Homebrew,一条命令即可完成:

brew install --cask codex

Homebrew 会自动下载并安装到系统路径,完成后在终端输入 codex 即可启动。

3)IDE 插件安装

在 VS Code 或 Cursor 的扩展市场搜索”Codex”,选择 OpenAI 官方发布的插件并点击安装。安装后 IDE 右侧会出现 Codex 面板,登录账号即可使用。

Codex 登录的两种方式

三种形态的 Codex 首次启动都需要登录。轻度体验可直接使用 OpenAI 账号,也可以用 GitHub 或 Google 账号登录,但需要准备一个能接收验证码的国外手机号。

此外,Codex 支持通过 API Key 认证(申请入口:platform.openai.com/api-keys,登录后申请):

获得 OpenAI API Key 后,在登录界面选择其他登录方式,输入 Key 即可直接使用,按实际用量计费:

Codex 日常使用操作指引

桌面版基础使用

打开 Codex 桌面应用后,界面风格与 ChatGPT 类似,左侧为对话列表,中间为对话区域。区别在于 Codex 可以关联本地项目——点击”添加项目”或”打开文件夹”选择项目目录,Codex 就能读取项目结构和文件内容。

之后你可以直接提问”这个项目是做什么的”、“帮我找到入口文件”、“这个报错是什么意思”,它会结合项目上下文回答。需要改代码时,它能直接生成修改方案并应用到你本地的项目文件中。

CLI 版基础使用

进入项目目录后执行 codex 命令启动 CLI 模式,进入交互式对话界面,像聊天一样描述需求。例如输入”帮我分析这个项目的结构”,Codex 会读取项目文件并给出分析;输入”这个函数有个 bug,帮我修复一下”,它会定位问题并给出修改。CLI 的优势在于完全在终端中操作,开发体验流畅。

IDE 插件基础使用

安装插件并登录后,在 VS Code 右上角找到 Codex 面板,或在编辑器中选中代码右键选择”Codex:解释这段代码”或”Codex:优化这段代码”。

插件适合在写代码过程中快速获得帮助,无需切换到其他窗口。

新手注意事项

1)桌面版、CLI、插件三种形态的核心 AI 能力相同,区别仅在操作方式上,新手建议从桌面版开始。

2)Codex 的服务端不在国内,使用过程中需要保持网络畅通。如果访问 OpenAI 服务不稳定,可以更换网络环境尝试。

3)让 Codex 修改代码前,建议先用 Git 提交一次(git commit)。AI 改代码偶尔会改出不符合预期的地方,有了提交记录就能随时通过 git checkout 回退,这是最稳妥的使用习惯。

常见问题

问:Codex 桌面版和 CLI 版在能力上有什么差别吗?

答:桌面版、CLI、插件三种形态的核心 AI 能力是一样的,区别只在于操作方式不同。

问:登录 Codex 时提示需要国外手机号验证,还有其他登录方式吗?

答:Codex 支持通过 API Key 认证,在登录界面选择其他登录方式,输入 Key 即可直接使用,按实际用量计费。

问:Codex 修改代码后如果效果不理想,能回退吗?

答:建议在让 Codex 修改代码前先用 Git 提交一次,如果改动不符合预期,可以随时通过 git checkout 回退到之前的状态。