OpenAI Codex 完整下载 & 安装指南（2026最新版）

重要前置说明（2026.7最新变动）

1. 独立Codex桌面App已停用：OpenAI 7月9日完成产品整合，原独立Codex客户端全部并入新版ChatGPT桌面客户端，新版ChatGPT内置独立「Codex代码模式」，免费/Plus/企业账号均可使用。
2. 仍保留独立可用组件：Codex CLI（开源终端工具）、VSCode Codex插件、Codex Cloud云端服务 完全独立，不受整合影响。
3. 基础使用门槛：访问OpenAI官方渠道、登录、调用模型均需要合规境外网络环境；国内无官方直连安装包，第三方修改版存在盗号风险，仅使用官方渠道。

一、桌面端（新版ChatGPT内置Codex，新手首选）

官方下载地址

###桌面App安装（最推荐，可视化操作）

**Windows:**：https://pan.quark.cn/s/1ed5727cd602

---

1. macOS 安装步骤

1. 官网下载 .dmg 镜像文件
2. 打开镜像，将「ChatGPT」拖拽至「应用程序」文件夹
3. 启动应用，使用ChatGPT账号登录（免费账号也能使用Codex基础代码能力）
4. 左侧切换标签：Codex，即可进入完整代码编程Agent界面

2. Windows 安装两种方式

方式A：微软商店（推荐小白）

1. 打开Microsoft Store，搜索 ChatGPT
2. 点击获取安装，自动完成配置
3. 启动后登录账号，切换Codex模式

方式B：PowerShell 命令安装（管理员）

winget install OpenAI.ChatGPT

3. 登录两种方案

1. ChatGPT账号登录（完整功能）：支持Computer Use、项目批量处理、云端同步，免费/Plus通用
2. API Key登录（仅基础代码）：缺少桌面端高级Agent能力，仅适合临时调试

二、Codex CLI 开源终端工具（开发者专用，独立可用）

跨平台开源编程Agent，可读取本地项目、自动执行命令、修改代码，支持自定义第三方模型（DeepSeek、Ollama本地模型等）

环境要求

Node.js ≥ 18.0，Windows建议搭配Git Bash/WSL2

安装方式（任选其一）

1. NPM 全局安装（全平台通用）

npm install -g @openai/codex
# 指定稳定版安装
npm install -g @openai/codex@0.144.1

2. macOS Homebrew 安装

brew install --cask codex

3. Windows winget 安装

winget install OpenAI.Codex.CLI

4. GitHub 二进制离线包（无网络脚本）

发布页：https://github.com/openai/codex/releases/latest
下载对应系统压缩包，解压后将二进制文件移入系统PATH目录

# Linux/macOS 示例
tar -xzf codex-x86_64-linux.tar.gz
sudo mv codex /usr/local/bin/

验证安装 & 基础命令

# 查看版本
codex --version
# 终端交互编程模式
codex
# 登录OpenAI账号
codex login
# 单次代码提问
codex 写一个Python爬虫

配置自定义API（无需OpenAI账号）

# Linux/macOS
echo 'export OPENAI_API_KEY="sk-xxx"' >> ~/.zshrc
source ~/.zshrc

# Windows PowerShell
$env:OPENAI_API_KEY="sk-xxx"

三、VS Code Codex 插件（编辑器内直接使用）

1. 打开VS Code扩展商店，搜索 OpenAI Codex
2. 一键安装，重启编辑器
3. 侧边栏打开Codex面板，登录ChatGPT账号或填入API Key
4. 支持整库重构、代码调试、自动生成单元测试、Git提交辅助

四、系统硬件最低配置

系统	最低要求	推荐配置
macOS	macOS 14+, 4GB内存	M系列芯片 / 8GB+内存
Windows	Win10 21H2 / Win11, 4GB内存	Win11, 8GB内存
Linux	Ubuntu20.04+/Debian11, 4GB内存	8GB内存，WSL2

五、常见问题排错

1. 官网无法打开、下载失败
   网络无法访问OpenAI海外域名，需合规境外网络环境，无国内镜像安装包。
2. 原独立Codex App消失
   产品整合，卸载旧Codex，安装新版ChatGPT桌面端即可找回全部代码功能，项目数据自动迁移。
3. CLI提示sh命令不存在（Windows）
   安装Git Bash，或启用WSL2子系统运行Codex。
4. 登录后Codex功能受限
   免费账号有调用速率限制；开通ChatGPT Plus解锁完整Computer Use、大项目上下文。
5. 第三方模型接入报错
   修改配置文件调整API兼容协议，使用CC-Switch做本地协议转换。

六、区分：旧版Codex模型 vs 新版Codex Agent

• 2021旧Codex模型：GPT-3微调代码模型，现已废弃，仅历史API可用；
• 2025-2026新版Codex：本文下载的桌面/CLI/IDE编程Agent，底层基于GPT-5系列模型，为当前官方主力工具。