【2026最新版】Codex官网下载+安装+登录+使用一篇搞定(Win/Mac/Linux全支持)

Codex安装包:Codex(Windows、macOS、Linux 三个平台都有)

Codex 全称 Codex CLI,是 OpenAI 推出的一款 AI 编程智能体(AI Agent)。跟只给建议的 AI 不同,Codex 能读取本地项目里的文件、生成和修改代码、在终端里执行命令,你用自然语言把需求说清楚,具体怎么改、怎么跑,交给它推进就行。

Codex 本身可以免费下载安装,但调用模型是按用量计费的。Codex 有三种形态,桌面版、命令行版(CLI)和 IDE 插件,分别对应不同的使用习惯。不管装哪一版,核心能力都一样,区别只在操作方式。

Codex 支持 Windows 10/11、macOS 和 Linux 三个平台,本文把 Codex 的下载、安装、登录配置和三种形态的用法一步步讲清楚,图文步骤照着做,上手就能用起来。

Codex下载

Codex下载地址:Codex安装包(Windows、macOS、Linux 三个平台都有)

Codex安装

1)桌面版安装

Mac 用户双击 dmg 安装包,把 Codex 图标拖进"应用程序"文件夹,再从启动台打开。

Windows 用户解压 zip 免安装版(OpenAI.Codex_26.602.4764.0_x64免安装版.zip),在解压后的文件夹里找到下图的文件,以管理员身份运行它:


Codex 就启动了:


当然,也可以选择 Msix 安装包,双击启动它:


接下来安装程序会自动运行,等待安装完成即可,不需要手动点很多"下一步"。安装完成后在开始菜单搜索 Codex 就能打开。如果找不到,重启一下电脑再试试。

2)IDE 插件安装

在 VS Code 或 Cursor 的插件市场搜索"Codex",找到 OpenAI 官方发布的插件,点击安装即可。安装后在 IDE 右侧会多出一个 Codex 面板,登录账号就能直接使用了。

、

3)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 并安装到系统路径,装好后在终端输入 codex 即可启动。

Codex登录(2种方式)

三种形态的 Codex 首次启动都需要登录才能使用。如果只是轻度体验,用 OpenAI 账号即可,也可以用 GitHub 或 Google 账号登录。

Codex 还支持通过 API Key 来认证(申请通道:platform.openai.com/api-keys):


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

Codex基础使用

1)桌面版使用

打开 Codex 桌面应用后,左侧是对话列表,中间是对话区域。点击界面上的"添加项目"或"打开文件夹",选择你的项目目录,Codex 就能读取项目结构和文件内容。


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

2)CLI 使用

进入你的项目目录,执行 codex 命令启动 CLI 模式。它会进入交互式对话界面,你可以像聊天一样描述需求。比如输入"帮我分析这个项目的结构",Codex 会读取项目文件并给出分析;输入"这个函数有个 bug,帮我修复一下",它会定位问题并给出修改。

3)IDE 插件使用

在 VS Code 的右上角找到 Codex 面板,或者在编辑器中选中代码后右键选择"Codex:解释这段代码"或"Codex:优化这段代码"。插件适合在写代码的过程中快速获得帮助,不用切换到其他窗口。

Codex新手注意事项

1)桌面版、CLI、插件三种形态的核心 AI 能力是一样的,区别只在操作方式上。新手建议从桌面版开始,可视化界面更友好,能清楚看到 Codex 每一步做了什么修改。

2)首次启动需要登录账号才能使用。除了账号登录,Codex 也支持通过 API Key 认证,在登录界面选择其他登录方式,输入 Key 后直接使用。

总结

Codex 是一款 AI 编程智能体,能直接读取、修改你的项目文件,并在终端里执行命令,像一个能自己动手的 AI 程序员。它有桌面版、CLI、IDE 插件三种形态,覆盖不同的使用习惯,免费下载,调用模型按用量计费,Windows、macOS、Linux 都能用。