docs: expand codex macos install guide

Author: KimYx0207

README.md

@@ -135,7 +135,7 @@ Codex 学习主线：**只有 Codex App 一条主线**。先看 CX-01 安装认
 
 | 序号 | 教程名称 | 学时 | 难度 | 说明 |
 |------|---------|------|------|------|
-| CX-01 | [Codex App 安装与认证](docs/codex/CX-01-Codex-App安装与认证完整指南.md) | 1-2h | ⭐ | Windows Microsoft Store / winget、首次防火墙、登录、本地项目和第一个线程 |
+| CX-01 | [Codex App 安装与认证](docs/codex/CX-01-Codex-App安装与认证完整指南.md) | 1-2h | ⭐ | Windows Microsoft Store / 防火墙，macOS 官方下载 / Gatekeeper，登录、本地项目和第一个线程 |
 | CX-02 | [Codex App 桌面工作流](docs/codex/CX-02-Codex-App桌面工作流完整指南.md) | 3-4h | ⭐⭐⭐ | App 主控台：Thread、Local、Worktree、Review、Settings、功能全景 |
 | CX-03 | [Commands 工作流入口](docs/codex/CX-03-Codex-Commands工作流入口完整指南.md) | 2-3h | ⭐⭐⭐ | App 里的 slash commands、/status、/plan-mode、/review、/mcp，以及 /goal、/loop 等实验入口的确认方法 |
 | CX-04 | [项目指令、权限与配置](docs/codex/CX-04-Codex项目指令权限配置完整指南.md) | 2-3h | ⭐⭐⭐ | AGENTS.md、App Settings、权限、沙盒、Rules、Hooks |
@@ -171,7 +171,7 @@ Codex 学习主线：**只有 Codex App 一条主线**。先看 CX-01 安装认
 
 ### Codex
 
-- **Codex App**：macOS / Windows 桌面端（macOS 可用 Homebrew Cask；Windows 以 Microsoft Store / winget 等官方安装入口为准；Linux 使用 CLI 或 Web）
+- **Codex App**：macOS / Windows 桌面端（macOS 从官方 Codex App 入口安装；Windows 以 Microsoft Store / `winget -s msstore` 等官方安装入口为准；Linux 使用 CLI 或 Web）
 - **Codex CLI**：Node.js 22+（`npm install -g @openai/codex`）；也可按官方 CLI 文档选择 Homebrew Cask 等路径
 - **Codex Web / Cloud**：现代浏览器 + 支持 Codex 的 ChatGPT 账号或组织工作区
 - **认证方式**：ChatGPT 账户登录 或 OpenAI API Key
@@ -377,12 +377,12 @@ Week 12 ：Automations + Review / GitHub / PR + Web/Cloud/CLI 辅助 + 安全
 - README 新增 Part 3 Codex 教程目录、环境要求、快速开始路线
 
 **Codex 教程内容**
-- CX-01 安装与认证：CLI/App/IDE/Web/SDK 分层安装、ChatGPT 登录、API Key、Windows/macOS/Linux 路径
-- CX-02 App 桌面工作流：Local/Worktree、Review、Settings、Plugins、Automations、Computer Use、内置浏览器
-- CX-03 CLI 终端 Agent：`approval_policy`、沙盒、命令行选项、非交互模式、review
-- CX-04 Web 云端 Agent：chatgpt.com/codex、环境配置、Internet Access、PR 工作流
-- CX-05 配置系统：AGENTS.md、config.toml、approval_policy、sandbox_mode、Rules、Hooks、Plugins
-- CX-06 Skills 技能系统：Skills 定位、自定义开发、团队共享、与 Plugins/MCP/Hooks 边界
+- CX-01 安装与认证：Windows Microsoft Store / 防火墙，macOS 官方下载 / Gatekeeper，登录、本地项目、首个线程
+- CX-02 App 桌面工作流：Thread、Local、Worktree、Review、Settings、App 主控台模型
+- CX-03 Commands：App slash commands、`/status`、`/plan-mode`、`/review`、`/mcp`，以及 `/goal`、`/loop` 等实验入口确认方法
+- CX-04 项目指令、权限与配置：AGENTS.md、App Settings、权限、沙盒、Rules、Hooks
+- CX-05 到 CX-10：MCP、Skills、Plugins / Connectors、Subagents、Automations、Review / GitHub / PR
+- CX-11 到 CX-14：Web / Cloud 辅助、CLI 辅助、安全企业、Claude Code 对比
 - CX-07 MCP 与 Subagents：MCP 配置、`codex app-server` 边界、Subagents、自定义 Agents
 - CX-08 Automations 与集成：App Automations、Triage、thread automation、CI/CLI、Plugins/MCP 集成
 - CX-09 Automations 后台任务：周期检查、提醒、monitor、Skills + Automation

docs/codex/CX-01-Codex-App安装与认证完整指南.md

@@ -2,7 +2,7 @@
 
 > 本篇只解决一件事：把 **Codex App** 正确装好、登上号、打开本地项目，并跑通第一个安全任务。
 >
-> 官方来源：OpenAI Codex App 文档、[Codex App Windows](https://developers.openai.com/codex/app/windows)、[Codex Quickstart](https://developers.openai.com/codex/quickstart)、Codex CLI 文档。本篇按 2026-05-09 可查官方文档修订；入口和版本会变化，以官方页面和当前 App 为准。
+> 官方来源：OpenAI Codex App 文档、[Codex App Windows](https://developers.openai.com/codex/app/windows)、[Codex Quickstart](https://developers.openai.com/codex/quickstart)、Codex CLI 文档。本篇按 2026-05-09 可查官方文档修订；入口、包名和版本会变化，以官方页面和当前 App 为准。
 
 ## 0. Critical：先把安装目标说清楚
 
@@ -37,7 +37,20 @@ CLI、Web / Cloud、SDK 都是后续辅助。
 
 ### 1.2 macOS
 
-macOS 用户从官方 Codex App 入口安装。安装后同样先做登录、本地项目、只读线程验证。
+macOS 用户同样是一等主线，不是补充路径。安装后也要跑通登录、本地项目、只读线程和 Review。
+
+建议准备：
+
+| 项目 | 建议 |
+|---|---|
+| macOS 版本 | 使用仍受 Apple 支持的 macOS 版本 |
+| 芯片 | Apple Silicon / Intel 都先以官方下载页提供的包为准 |
+| 安装来源 | 官方 Codex App 页面，不要从第三方网盘下载 |
+| 终端 | 系统 Terminal / zsh 默认可用；项目也可能用 iTerm2、Homebrew 工具链 |
+| 项目位置 | 新手优先放在用户目录，例如 `~/Projects/repo` |
+| Git | 必装，Review 面板和 diff 依赖 Git |
+| Node / Python / Xcode | 按项目需要安装 |
+| 系统权限 | 首次打开项目、访问目录、运行终端或控制本机应用时，按最小权限授权 |
 
 ### 1.3 Linux
 
@@ -199,17 +212,89 @@ Set-ExecutionPolicy -ExecutionPolicy RemoteSigned
 
 改执行策略前要理解影响；企业电脑按管理员策略处理。
 
-## 8. macOS 安装简述
+## 8. macOS 安装：官方入口、系统权限和开发工具链
+
+### 8.1 从哪里下载
+
+macOS 用户从官方 Codex App 页面进入下载：
+
+1. 打开官方 Codex App 页面：[https://developers.openai.com/codex/app/](https://developers.openai.com/codex/app/)
+2. 选择 macOS 下载入口。
+3. 按页面提示下载适合当前 Mac 的安装包。
+4. 打开安装包，把 Codex App 安装到 Applications / 应用程序。
+5. 从 Launchpad 或 Applications 打开 Codex。
+
+注意：
+
+- 如果页面区分 Apple Silicon 和 Intel，按你的芯片选择；不确定时看“关于本机”。
+- 不要从第三方网盘、论坛附件或别人转发的安装包安装。
+- 如果公司 Mac 有 MDM / 安全软件限制，按公司软件分发流程安装。
+
+### 8.2 第一次打开和 Gatekeeper
+
+macOS 可能出现 Gatekeeper 或系统安全提示。处理原则：
+
+| 提示 | 建议 |
+|---|---|
+| “无法打开，因为无法验证开发者” | 先确认来源是官方页面；再到系统设置的隐私与安全里按提示允许 |
+| 请求访问项目目录 | 只授权当前项目或你明确需要的目录 |
+| 请求访问桌面、文稿、下载 | 不要全给；项目在哪里就给哪里 |
+| 请求控制其他应用 | 只有任务确实需要本机自动化或浏览器验证时再授权 |
+
+如果 App 打不开，不要立刻改系统全局安全设置。先确认安装包来源、重新下载、检查系统设置中的拦截提示。
+
+### 8.3 macOS 登录与首次线程
 
-macOS 用户从官方 Codex App 入口下载安装。安装后检查：
+安装后检查：
 
 1. App 能打开。
 2. 能登录账号。
 3. 能选择本地项目目录。
 4. 能创建线程。
 5. 能看到 Review / Settings。
 
-如果 macOS Gatekeeper 或系统权限弹窗拦截，按系统提示允许来自官方来源的 App，并只授权必要目录。
+登录建议和 Windows 一样：普通 App 使用优先走 ChatGPT / OpenAI 账号；API Key 只用于 CLI、CI、SDK 或服务端自动化，不写进仓库。
+
+### 8.4 macOS 必备开发工具
+
+macOS 项目常见准备：
+
+```bash
+git --version
+xcode-select --install
+```
+
+如果项目使用 Homebrew：
+
+```bash
+brew --version
+```
+
+Node / Python 按项目选择，不要所有教程都强制安装：
+
+```bash
+node --version
+python3 --version
+```
+
+常见判断：
+
+| 项目类型 | 建议工具 |
+|---|---|
+| Web / Node 项目 | Node.js、包管理器、Git |
+| Python 项目 | Python 3、虚拟环境工具、Git |
+| iOS / macOS 原生项目 | Xcode、Command Line Tools、Git |
+| 需要本地浏览器验证 | Chrome / Safari，以及项目要求的浏览器工具 |
+
+### 8.5 macOS 常见问题
+
+| 问题 | 处理 |
+|---|---|
+| App 看不到项目文件 | 检查目录权限，重新选择项目目录 |
+| Git 状态不可用 | 安装 Command Line Tools，确认项目是 Git 仓库 |
+| `xcrun` / `git` 不可用 | 运行 `xcode-select --install` |
+| Node 命令不可用 | 安装 Node，并重新打开 App 让 PATH 生效 |
+| 权限给多了 | 到系统设置的隐私与安全里撤销不必要权限 |
 
 ## 9. 第一次打开项目
 
@@ -261,9 +346,10 @@ CLI 安装和深入使用放到 CX-12。安装篇只要求你知道它不是主
 
 | 检查项 | 通过标准 |
 |---|---|
-| App 安装 | Windows 从 Microsoft Store / `winget -s msstore` 安装，macOS 从官方入口安装 |
+| App 安装 | Windows 从 Microsoft Store / `winget -s msstore` 安装，macOS 从官方 App 入口安装 |
 | 登录 | App 显示已登录账号 |
 | 防火墙 | Windows 弹窗已按专用网络最小放行处理 |
+| macOS 权限 | 只授权必要项目目录和必要系统能力 |
 | Git | App 能看到项目 Git 状态 |
 | 项目 | 能添加本地仓库 |
 | 线程 | 能创建 Local thread |
@@ -293,6 +379,10 @@ CLI 安装和深入使用放到 CX-12。安装篇只要求你知道它不是主
 
 不建议。只有明确需要管理员权限的任务才右键 Run as administrator。
 
+### Q6：macOS 和 Windows 哪个是主线？
+
+都是主线。Windows 要写清 Microsoft Store、PowerShell、防火墙；macOS 要写清官方下载、Gatekeeper、目录权限、Command Line Tools。CLI / Web / Cloud 才是辅助线。
+
 ## 下一步
 
 下一篇：[CX-02 Codex App 桌面工作流](./CX-02-Codex-App桌面工作流完整指南.md)。