Windows
Windows 10/11（64 位）
- 使用官方安装程序或包管理器
- 安装步骤简单，适合新手
- 10 分钟内完成安装
安装客户端Codex 下载安装教程
Codex 下载安装教程
从官方方式开始，10分钟完成安装验证
先按你的系统选择 Codex 官方安装方式，安装结束后运行 codex --version 验证命令是否可用。
先按照系统选择安装方式，完成后再用版本命令验证是否安装成功。
$ codex --versioncodex 0.12.0✓ 安装成功！
CodexOpenAI 官方AI 编程工具
1
先确认你的安装方式
Codex 提供 Windows、macOS 和 Linux 官方安装方式，请根据你的系统选择对应的安装步骤。
macOS
macOS 12+（Apple Silicon / Intel）
- 支持 Homebrew 安装
- 也可使用官方安装包
- 几分钟即可完成
Linux
主流发行版（x64 / ARM64）
- 支持多种包管理器
- 也可使用官方安装脚本
- 适合开发环境和服务器
2
安装前准备
在开始安装 Codex 之前，请先确认以下准备工作已完成：
系统要求
- 操作系统：Windows 10/11、macOS 12+ 或主流 Linux 发行版
- 网络环境：能够访问 OpenAI 官方服务和下载地址
- 磁盘空间：至少 500MB 可用空间
- 权限要求：需要管理员权限（部分安装方式）
注意事项
- 请从官方渠道下载安装，避免使用第三方修改版本
- 安装过程中保持网络稳定，避免下载中断
- 如在公司或学校网络，可能需要配置代理
- 安装前建议关闭旧版本或残留进程
3
官方安装步骤
以下是从官方方式安装 Codex 的步骤，请选择你的系统查看详细步骤：
1
下载安装包
从 OpenAI 官方下载页选择 Windows 安装入口，也可以使用官方 PowerShell 安装脚本。
2
运行安装程序
双击下载的安装包，按照提示完成安装。安装过程中可使用管理员权限。
3
完成安装
安装完成后，重新打开 PowerShell，运行版本命令进行验证。
Windows · PowerShell
PowerShell 安装（可选）
# 使用 winget 安装（如支持）
winget install OpenAI.Codex
# 或使用 Chocolatey（如果已安装）
choco install codex
# 安装完成后验证
codex --version1
打开官方安装地址
点击上方 macOS 下载地址，或在 Terminal 中运行官方安装命令。
2
完成安装
如果系统提示安全确认，请在系统设置中允许来自 OpenAI 的应用。
3
验证命令
重新打开 Terminal，运行 codex --version 确认命令已经可用。
macOS · Terminal
官方安装命令
curl -fsSL https://chatgpt.com/codex/install.sh | sh
codex --version1
准备终端环境
确认当前用户可以写入个人 bin 目录，并使用受信任的官方脚本。
2
执行安装脚本
在终端运行官方脚本，完成后按提示重新加载 Shell。
3
验证安装
运行 codex --version，确认当前架构下的命令可以正常启动。
Linux · Terminal
官方安装命令
curl -fsSL https://chatgpt.com/codex/install.sh | sh
codex --version提示：如果在安装过程中遇到问题，可以尝试使用管理员权限运行安装程序，或者查看常见问题部分。
4
如何验证安装成功
安装完成后，通过以下命令验证 Codex 是否正常工作：
在终端中运行以下命令：
确认版本
codex --version如果看到版本号，说明安装成功！
- 会显示类似 codex 0.12.0 的版本信息
- 表示 Codex 已正确安装并可正常使用
- 如果显示命令不存在，请检查环境变量或重新安装
- 也可以运行 codex --help 查看更多信息
5
常见安装问题
如果在安装过程中遇到问题，可以参考以下常见问题及解决方案：
安装时提示权限不足怎么办？
在 Windows 以管理员身份运行安装程序；在 macOS 或 Linux 使用官方脚本安装到当前用户目录，避免直接写入系统目录。
下载速度很慢或下载失败？
确认网络可以访问 OpenAI 官方域名，必要时使用稳定代理；不要改用来源不明的镜像安装包。
安装完成后提示 “codex” 不是内部或外部命令？
重新打开终端让 PATH 生效，并运行 Get-Command codex -All 或 type -a codex 检查实际路径。
在公司或学校网络中无法安装？
请向网络管理员确认代理、TLS 拦截和下载白名单；不要为了绕过策略关闭安全软件。
如何卸载已有的 Codex 版本？
按当前系统的应用卸载方式移除 App，CLI 则使用对应包管理器卸载，并保留配置文件备份。
6
安装成功后下一步
完成安装并验证成功后，你可以继续进行以下操作：
已经安装好 Codex？继续配置 API 吧！
学习如何配置 API Key，开始享受强大的 AI 编程体验。