Mac 上在 App Store 搜不到、下载不了 Codex，核心原因是 Codex 桌面版已经不在国内区 App Store 上架，存在地区上架限制，想要正常使用 Codex Mac 版，不用纠结 App Store 渠道，优先选择官网 dmg 包、Homebrew、官方脚本三种方式安装，适配 Apple Silicon 和 Intel 两种 Mac 芯片。很多人下载完 dmg 之后，打开会弹出 “无法验证开发者、已损坏” 的报错，这是 macOS 自带 Gatekeeper 安全机制拦截，不是安装包本身损坏，只要执行解除隔离的终端命令就能绕过限制，安装完成登录 OpenAI 账号，配置好 API Key 就可以正常使用 Codex 的代码生成、项目调试、Agent 任务能力，整体流程稳定，和 App Store 版本功能一致。
一、Codex Mac 版无法在 App Store 下载的主要原因
- 区域限制：Codex 桌面版仅在部分海外地区 App Store 上架，国内 Apple ID 搜索不到
- 分发策略调整：OpenAI 主推官网直链、Homebrew、脚本安装，不再依赖 App Store 分发更新
- 苹果审核规则：AI 代理类应用持续迭代，App Store 审核周期长，官方优先独立分发渠道
二、三种安装方案（按推荐优先级排序）
方案 1：官网 DMG 安装包（新手首选）
- 前往 OpenAI Codex 官方页面，根据你的 Mac 芯片（Apple Silicon / Intel）下载对应 dmg 安装包
- 双击 dmg 文件，把 Codex.app 拖拽到「应用程序」文件夹
- 打开终端，执行命令解除安全隔离：
- 回到 Launchpad，点击 Codex 启动，登录 OpenAI 账号，填入 API Key
sudo xattr -cr /Applications/Codex.app
方案 2：Homebrew 安装（适合有终端基础的开发者）
- 已经装好 Homebrew，直接执行：
- 等待自动下载、签名、部署
- 启动命令：codex app 打开图形界面；直接输入codex进入 CLI 终端模式
- 后续更新：brew upgrade --cask codex
brew install --cask codex
方案 3：官方一键安装脚本（跨平台通用）
- 打开终端复制执行：
- 脚本自动校验文件完整性、配置环境变量
- 安装完成后，codex app启动桌面客户端
curl -fsSL https://chatgpt.com/codex/install.sh | sh
三、安装后高频报错处理清单
| 报错提示 | 解决办法 |
|---|---|
| 无法打开，因为无法验证开发者 | 执行sudo xattr -cr /Applications/Codex.app，或者系统设置→安全性与隐私，允许运行 |
| 提示软件已损坏、移入废纸篓 | 更换官方原版安装包，不要使用第三方网盘修改包，同时更新 Homebrew 源 |
| 打开 Codex 后登录失败 | 检查网络，确认 OpenAI 账号状态，API Key 额度未耗尽 |
| Apple Silicon 芯片打开卡顿 | 下载对应 arm64 版本，不要用 Intel 版本，避免 Rosetta 转译带来性能损耗 |
四、安装后基础配置步骤
- 启动 Codex，选择登录方式：网页账号登录 / 手动填入 API Key
- 设置项目工作目录，授权 Codex 读取本地代码文件夹权限
- 按需开启代码补全、终端联动、文件读写 Agent 权限
- 测试：新建代码文件，让 Codex 生成一段测试代码，验证功能正常
【相关 FAQ】
问题 1：Codex Mac 版不走 App Store 安装，会不会有安全风险？
回答 1：只要从 OpenAI 官网、官方 GitHub、Homebrew 官方源获取 Codex 安装包，文件和 App Store 版本同源，风险很低；不要从不知名网盘、第三方站点下载 Codex Mac 安装包，避免篡改包。
问题 2：Codex Mac 版 Homebrew 安装和 dmg 安装，功能有区别吗？
回答 2：Codex Mac 版两种安装方式的核心功能完全一致；Homebrew 方便后续一键升级，dmg 适合不想装 Homebrew、只想简单使用 Codex 的普通用户。
问题 3：Codex Mac 版安装成功之后，需要一直挂 API Key 吗？
回答 3：Codex Mac 版运行依赖 OpenAI 接口，必须配置有效的 API Key，免费额度用完之后会按 token 计费，和 App Store 版本计费规则相同。
问题 4：切换海外 Apple ID 之后，能不能在 App Store 下载 Codex Mac 版？
回答 4：部分海外地区 App Store 还有 Codex 上架，但版本更新滞后，还会受 Apple ID 地区、支付、风控限制，稳定性不如官网直接下载 Codex Mac 版。
【参考资料】
[2026-11-10]（Codex Mac 版安装教程 (AppStore 无法下载解决)）阿里云开发者社区
[2026-11-04]（codex 产品分析：从写代码的助手，到别人产品里的一个零件）人人都是产品经理
[2026-07-30]（2026 实测 Codex 下载 | Codex 国内安装使用全流程教程）SegmentFault 思否
[2026-07-21]（Codex 全网最全指南：安装、登录、国内登录问题解决）稀土掘金
[2026-04-17]（OpenAI 上线 Mac 版 Codex）36 氪
【免责声明】
本文为 Codex Mac 版安装实操科普教程，仅提供渠道与排错指引；Codex 是 OpenAI 旗下产品，接口访问、账号权限、计费规则、版本更新均以 OpenAI 官方公告为准；macOS 安全命令存在权限风险，仅在确认安装包来源可信时执行；AI 代码生成内容存在漏洞风险，Codex 输出的代码务必人工审核后再上线；第三方分发渠道的安装包安全性无法保证，请谨慎选择。