展开知识库目录
macOS / Linux 安装 Codex：先核对 Shell、目录和权限
同一安装命令在 zsh、bash、系统包管理器和版本管理器下可能落到不同路径。
macOS 和 Linux 先辨认 Shell 与安装范围
同一安装命令在 zsh、bash、系统包管理器和版本管理器下可能落到不同路径。先确认 CPU 架构、Shell、Node.js 来源、PATH 和目标目录权限，再按当前官方文档安装。
记录平台和 Shell
运行系统、架构、Shell、Node.js、包管理器和 PATH 检查，保存实际输出；远程服务器还要确认是否有交互登录条件。
把涉及的文件、目录、版本、命令和实际输出写进记录；代码变化同时保留 diff 与测试结果。
只选一种安装来源
优先使用官方当前推荐方式，避免系统 Node、nvm、Homebrew 或其他包同时管理同一命令。
确认“只选一种安装来源”已经有可回查结果，再进入“确认命令解析位置”；依据仍然来自猜测时，把缺口单列并停在当前步骤。
确认命令解析位置
安装后检查可执行文件实际路径和版本，重新打开 Shell 验证 PATH 已加载，而不是只在当前窗口偶然可用。
确认“确认命令解析位置”已经有可回查结果，再进入“限定工作目录与权限”；依据仍然来自猜测时，把缺口单列并停在当前步骤。
限定工作目录与权限
从测试仓库启动，确认工具只在预期目录读写；涉及 sudo、钥匙串或系统目录时先停下理解原因。
确认“限定工作目录与权限”已经有可回查结果，再进入“完成可逆任务”；依据仍然来自猜测时，把缺口单列并停在当前步骤。
完成可逆任务
保存 diff、测试和撤销结果，确认换一个新终端仍能复现。
需要修改时先限定文件和行为范围，无法说明回滚方式或影响面的动作先不执行。 完成后把证据归入“可运行环境与平台核验记录”。
完成后应能在“可运行环境与平台核验记录”中找到与这一步对应的记录；仍需靠猜测补全，就停在这里。
跨平台教程的通过标准是可复现
把平台、架构、Shell、运行时、安装来源、命令路径和版本写成记录。复制 Windows 命令改几个斜杠不算完成。