2026最新codex下载安装保姆级使用教程(下载+安装+登录+使用,含所有历史版本)

简介: Codex 是 OpenAI 推出的开源 AI 编程智能体,跑在本地终端和桌面客户端里,能读懂整个代码仓库,一句自然语言就能让它改代码、执行命令、跑测试、修 Bug,支持 Windows、macOS、Linux 三大平台。本文把 Codex下载、安装、登录、汉化、基础使用一次讲全,并整理了国内用户最常踩的坑,跟着做 10 分钟就能跑起来。

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 包稍旧

选包三句话:

  1. 大多数 Windows 用户:直接下 x64 免安装 zip,解压就能跑;
  2. Mac 用户:M 系列芯片选 arm64.dmg,2019 年前的老 Mac 选 x64.dmg;
  3. 只想在终端里敲命令的开发者:下 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 汉化

主界面默认英文,可以手动切中文(实测只能覆盖部分界面):

  1. 左下角点 Settings 进入设置页;
  2. 把 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 或插件即可。

七、总结

  1. 下载走文首的大礼包地址,Win/Mac/Linux 全平台安装包一次拿全,免安装 zip 是最稳的路线;
  2. 桌面版解压即用,CLI 三种装法(npm 最通用),IDE 插件认准 OpenAI 官方;
  3. 登录二选一:账号登录省事,API Key 按量计费;
  4. 汉化在 Settings → Language 里切换,目前只有部分界面覆盖;
  5. Codex 会真实修改文件,动手前先 Git 提交;
  6. 微软商店下载失败、npm 超时是最常见的两类坑,本文第六节都有对应解法。

更多 AI 编程工具的安装包整理和避坑教程,会第一时间更新在公众号「XXX」(改成你的公众号),后台回复「codex」也能随时拿到本文的下载地址。

往期推荐(改成你的往期文章):

  • 《XXX》
  • 《XXX》
  • 《XXX》

写在最后: 如果这篇教程帮你把 Codex 跑起来了,点个赞收藏防走失;装的时候卡在哪一步,欢迎评论区贴报错,看到都会回。

目录
相关文章
|
5天前
|
Linux Go 开发工具
手机上跑 DeepSeek 智能体:开源安卓客户端 DSH Go 安装与使用指南
DSH Go 是一款开源安卓客户端,将 DeepSeek Harness 智能体引擎装进手机:免 Root、免 Termux,一键安装即用;支持本机运行(内置 Ubuntu+Node.js)或远程接管电脑会话;具备插话打断、过程折叠、屏幕操控、端到端加密分享等特色功能,真正实现智能体“口袋化”。
5444 11
|
5天前
|
弹性计算 人工智能 API
Codex超详细入门指南(下载·安装·登录·上手,全版本覆盖,2026最新版)
建议收藏本教程,2026 全年各版本更新随时回来查阅。如果你在搭建过程中遇到任何问题,欢迎结合 阿里云工单系统 提交技术支持请求,或在 阿里云开发者社区 搜索 Codex 相关话题交流。 祝你编码愉快,效率翻倍!
2064 6
|
7天前
|
JSON 前端开发 API
阿里云最新Qwen4-Max大模型介绍:模型定位、特征、能力、适用场景解析
2026 年 11 月 11 日,阿里发布第四代旗舰模型Qwen4-Max预览版,首发千问 AI 平台 Token Plan,并同步接入千问办公、Qoder 等入口。该版本聚焦知识理解、世界感知、编程与 Agentic 四项升级,主打复杂编程、专业办公、前端设计与专业软件操作。预览期至 11 月 25 日 24:00,到期后模型标识下线;限时 2 折、新用户再享 5 折,最低 1 折可体验。
|
7天前
|
人工智能 前端开发 API
阿里云Qwen4-Max 大模型详解:定位、特征、能力、适用场景与相对Qwen3-Max差异解析
2026年11月11日,阿里发布第四代旗舰模型Qwen4-Max预览版,首发千问AI平台Token Plan并接入千问办公、Qoder等入口。该版本聚焦知识理解、世界感知、编程与Agentic四项升级,主打复杂编程、专业办公、前端设计与专业软件操作等真实任务。预览期为11月11日10:00至11月25日24:00,仅支持Token Plan调用,到期后模型标识下线;限时2折、新用户再享5折,最低1折可体验。
|
20天前
|
Linux 开发工具 iOS开发
Codex保姆级教程(下载+安装+登录+使用,含所有版本,2026最新)
Codex是OpenAI推出的开源AI编程智能体,本地运行,可理解整个代码库,支持自然语言指令改代码、执行命令、跑测试、修Bug,兼容Win/macOS/Linux。(239字)
9707 58
|
3天前
|
传感器 安全 区块链
Windows 电脑运行安卓应用教程:开源工具 ApkStart 双击 APK 即装、独立窗口运行
ApkStart 是一款开源Windows工具,让安卓APP像原生软件一样运行:双击APK即安装、生成真实图标、独立窗口启动、开始菜单可搜索。无需传统模拟器,内置QEMU运行时,支持数据互通、ARM兼容与命令行操作。(239字)
|
15天前
|
Linux 开发工具 iOS开发
2026最新codex下载安装保姆级使用教程(下载+安装+登录+使用,含所有历史版本)
本文详解OpenAI Codex国内快速上手指南:提供Win/macOS/Linux全平台免安装包、npm/Homebrew等多方式安装、账号/API Key双登录、简体中文切换,覆盖下载、安装、汉化、使用及高频避坑(如微软商店失败、npm超时等),10分钟即可跑通。
3306 9
|
20天前
|
JavaScript API iOS开发
DeepSeek Harness下载、安装、配置一篇搞定(2026整理,送常用插件)
DeepSeek Harness(DSH)是DeepSeek于2026年开源的MIT协议AI Agent框架,支持插件化组装模型、工具、沙箱与UI,兼容主流大模型。本文提供免Node.js的桌面端安装包(Win/macOS),含详细图文教程及热门插件推荐。
6004 69
|
3天前
|
人工智能 弹性计算 开发工具
零成本玩各大模型!DeepSeek Harness dsh-our-free-model 插件,13 个厂商模型直接用
总结一下:装这个插件,你不用注册、不用绑卡、不用填一个 Key,就能在 DeepSeek Harness 里用上 DeepSeek V4.1 Flash、Kimi K3 这一批前沿模型,而且是白嫖的、还不限量。三步搞定:下载插件,复制包含 `package.json` 的插件目录路径,在「添加插件」里粘贴路径安装并重启。无论是在阿里云 ECS 上通过命令行部署的 Web 版,还是本地的 Electron 桌面端,都能顺利跑通,快速搭建一套零成本的免费模型使用环境。
944 0