Codex 是 OpenAI 推出的开源 AI 编程智能体,跑在本地终端和桌面客户端里,能读懂整个代码仓库,一句自然语言就能让它改代码、执行命令、跑测试、修 Bug,支持 Windows、macOS、Linux 三大平台。本文把 Codex下载、安装、登录、汉化、基础使用一次讲全,并整理了国内用户最常踩的坑,跟着做 10 分钟就能跑起来。
2026年阿里云双十一活动入口:
| 2026年阿里云双十一活动入口 | 核心功能 | 适配人群 |
| 阿里云双十一活动主会场入口 https://t.aliyun.com/U/hNZNGM | 阿里云轻量应用服务器、阿里云ECS云服务器、阿里云GPU云服务器、阿里云百炼大模型服务平台特惠机型一键选购 | 新客首购、免费试用、秒杀抢购 |
| 阿里云千问AI会场入口 https://t.aliyun.com/U/oJcPMY | 150+模型折扣、Token Plan、千问办公、Qoder、AI礼包 | 个人开发者、中小企业 |
| 万网会场入口 https://t.aliyun.com/U/3cSx9W | AI建站、域名、备案、组合购,11月2日至11月30日 | 个人开发者、中小企业 |
| 云服务器活动主会场入口 https://t.aliyun.com/U/tj0Y6d | 阿里云大模型服务平台、阿里云轻量应用服务器、阿里云ECS云服务器、阿里云GPU云服务器特惠机型一键选购 | 新客首购、免费试用、秒杀抢购 |
| 综合权益中心入口 https://t.aliyun.com/U/Qu7Kql | AI权益+云产品权益双轨并行,Token Plan、千问办公、万小智AI建站等一网打尽 | 新老用户均可,尤其适合AI应用探索者 |
| 99计划专场入口 https://t.aliyun.com/U/qISm14 | 99元e实例与199元u1实例新购续费同价,锁价至2030年 | 个人开发者、中小企业长期持有 |
云服务器ECS专属活动入口 https://t.aliyun.com/U/YeFGPX |
Agent友好云服务器:算力、模型、应用一次配齐 | 个人开发者、中小企业 |
| 云资源产品直降活动入口 https://t.aliyun.com/U/5Kr5JI | 从模型到应用,全链提效,助力开发者与企业创新加速 | 个人开发者、中小企业 |
| 免费试用主会场入口 https://t.aliyun.com/U/91c17L | 160+款云产品免费试用 | 个人开发者、中小企业 |
| 百炼 Token Plan 活动入口 https://t.aliyun.com/U/PjblPi | 千问 AI 双 11 Token Plan 低至5折 | 个人开发者、中小企业 |
| 大模型服务平台百炼活动入口 https://t.aliyun.com/U/2Nuy7H | 千问 AI 双 11 Token Plan 低至5折 | 个人开发者、中小企业 |
一、Codex 下载(附全平台安装包清单)
先给地址。国内用户直连 OpenAI 官网的门槛比较高,微软商店又经常"无法下载此应用",所以我把三平台、全架构的安装包整理成了一个大礼包,点开转存就能用:
里面包含桌面版、命令行版两种形态,共 10 个安装包,对应不同平台和架构:
| 安装包文件 | 平台 | 怎么选 |
| Codex_26.1023.6621.0_x64【免安装版】【适合大多数电脑】.zip | Windows x64 桌面版 | 解压即用,不写注册表,大多数电脑闭眼选这个 |
| Codex_26.1023.6621.0_x64【适合大多数电脑】.Msix | Windows x64 桌面版 | 双击走正规安装流程,会进系统应用列表,方便日后卸载 |
| Codex_26.1023.6621.0_arm64【免安装版】【仅适合ARM架构电脑】.zip | Windows arm64 桌面版 | ARM 架构笔记本专用,解压运行 |
| Codex_26.1023.6621.0_arm64【仅适合ARM架构电脑】.Msix | Windows arm64 桌面版 | ARM 电脑的双击安装版 |
| codex-x86_64-pc-windows-msvc.exe | Windows x64 命令行版 | 放进固定目录配好 PATH,在终端里跑 |
| codex-x86_64-pc-windows-msvc.exe.zip | Windows x64 命令行版 | 上面那个 exe 的压缩包形态 |
| codex-aarch64-pc-windows-msvc.exe | Windows arm64 命令行版 | ARM 电脑的终端版 |
| Codex-mac-x64.dmg | macOS Intel 桌面版 | 老款 Intel 芯片 Mac 用这个 |
| Codex-mac-arm64.dmg | macOS Apple 芯片桌面版 | M 系列芯片 Mac 用这个 |
| Codex-linux-arm64-26.506.21252.zip | Linux arm64 桌面版 | 解压运行,版本号比 Windows/Mac 包稍旧 |
选包三句话:
- 大多数 Windows 用户:直接下 x64 免安装 zip,解压就能跑;
- Mac 用户:M 系列芯片选 arm64.dmg,2019 年前的老 Mac 选 x64.dmg;
- 只想在终端里敲命令的开发者:下 exe 文件配 PATH,或者直接看下面第二节的 npm 方式。
二、Codex 安装
2.1 桌面版安装(Windows / macOS)
Windows 免安装版(推荐): 把 zip 解压到一个纯英文路径的文件夹,进入后找到主程序,右键"以管理员身份运行"。首次启动会初始化配置,等几秒界面就出来了。
Windows Msix 安装版: 双击 .Msix 文件,安装器会自动跑完,不需要一路点"下一步"。装完后在开始菜单搜索 Codex 就能打开。
macOS: 双击 dmg 挂载,把 Codex 图标拖进"应用程序"文件夹,再从启动台打开。如果提示"无法验证开发者",去系统设置 → 隐私与安全性里点"仍要打开"。
2.2 CLI 命令行安装(开发者向)
CLI 版没有图形界面,轻量快速,适合习惯终端操作的开发者。三种装法按顺序试:
① 直接运行 exe: 双击 codex-x86_64-pc-windows-msvc.exe 就能启动。首次运行会要求登录,终端里会给出一个授权链接,浏览器里登录 OpenAI 账号后自动回跳。
② 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): 装了 Homebrew 的话一行搞定:
brew install --cask codex
2.3 IDE 插件安装
在 VS Code 或 Cursor 的插件市场搜索 "Codex",认准 OpenAI 官方发布的那个,点安装。装完后 IDE 右侧会多出一个 Codex 面板,登录账号就能在写代码的过程中随叫随到,不用切窗口。
📷 截图占位 3:VS Code 插件市场里的 Codex + 右侧面板效果
三、Codex 登录(两种方式)
桌面版、CLI、插件首次启动都要登录,二选一:
方式一:账号登录(推荐新手)。 支持直接用 OpenAI 账号,也可以用 GitHub 或 Google 账号快捷登录,点一下授权就完事。
方式二:API Key 登录(推荐已有 Key 的开发者)。 到 platform.openai.com/api-keys 申请一个 Key,在登录界面选择"其他登录方式"输入 Key,按实际用量计费,适合不想开订阅、只想轻度使用的场景。
📷 截图占位 4:登录界面(账号入口 + API Key 入口各一张)
四、Codex 汉化
主界面默认英文,可以手动切中文(实测只能覆盖部分界面):
- 左下角点 Settings 进入设置页;
- 把 Language 改成 简体中文。
改完主界面立刻生效,但部分弹窗和 CLI 交互仍然是英文,这是官方翻译还没铺满,不影响使用。
📷 截图占位 5:Settings → Language 切换中文的前后对比
五、Codex 基础使用
5.1 桌面版
打开后左侧是会话列表,中间是对话区。点 Choose project 选择你的项目目录,Codex 会读取整个项目的结构和文件内容。之后直接提问就行,比如"这个项目是做什么的""帮我找到入口文件""这个报错是什么意思"。需要改代码时,它会自己定位相关文件、生成修改方案、应用改动,再把结果列出来给你确认。
5.2 CLI
进入项目目录,敲 codex 启动交互式对话。描述需求即可,比如"帮我分析这个项目的结构""这个函数有个 bug,帮我修一下",它会读文件、定位问题、给出修改,全程在终端里完成。
5.3 IDE 插件
在 VS Code 右上角打开 Codex 面板,或者选中一段代码后右键,用"Codex:解释这段代码""Codex:优化这段代码"。插件形态最适合边写边问,上下文就是你当前选中的代码。
六、新手常见问题与避坑
Q1:微软商店提示"无法下载此应用"或初始化失败怎么办?
别死磕商店,直接用文首下载地址里的免安装 zip,解压就能跑;或者下 exe 版加进 PATH。这也是国内用户最省事的路线。
Q2:npm 安装到一半卡住、报网络超时?
先换淘宝镜像源(命令见 2.2 节)。还不行的话,大概率是安装脚本要回 GitHub 拉二进制文件被卡住了,给终端配上代理环境变量(HTTPS_PROXY)再装一次。
Q3:x64 和 arm64 到底选哪个?
Windows 用户打开任务管理器 → 性能页,看 CPU 一栏写的是 AMD64/x64 还是 ARM64。ARM 笔记本(比如骁龙本)装 x64 包会跑不起来,别装错。
Q4:首次启动特别慢,是不是卡死了?
不是。第一次启动要加载配置、探测 Git 仓库、拉起本地服务,慢是正常的,第二次起就快了。
Q5:Codex 会直接改我的文件吗?
会,它是真的会动手写文件、执行命令。动手前务必把项目提交到 Git,出了问题随时能回滚。
Q6:汉化完还有英文?
官方只做了部分汉化,弹窗、CLI 交互仍是英文,属于正常现象,后面版本会逐步补齐。
Q7:桌面版、CLI、插件怎么选?
三种形态背后的 AI 能力完全一样,区别只在操作方式。新手从桌面版开始,能清楚看到每一步改了什么;老手按习惯选 CLI 或插件即可。
七、总结
- 下载走文首的大礼包地址,Win/Mac/Linux 全平台安装包一次拿全,免安装 zip 是最稳的路线;
- 桌面版解压即用,CLI 三种装法(npm 最通用),IDE 插件认准 OpenAI 官方;
- 登录二选一:账号登录省事,API Key 按量计费;
- 汉化在 Settings → Language 里切换,目前只有部分界面覆盖;
- Codex 会真实修改文件,动手前先 Git 提交;
- 微软商店下载失败、npm 超时是最常见的两类坑,本文第六节都有对应解法。
更多 AI 编程工具的安装包整理和避坑教程,会第一时间更新在公众号「XXX」(改成你的公众号),后台回复「codex」也能随时拿到本文的下载地址。
往期推荐(改成你的往期文章):
- 《XXX》
- 《XXX》
- 《XXX》
写在最后: 如果这篇教程帮你把 Codex 跑起来了,点个赞收藏防走失;装的时候卡在哪一步,欢迎评论区贴报错,看到都会回。