铝型材如何让AI判断应用场景？从参数建模到选型验证

官方文档、npm 包页和 11 月 6 日的版本发布记录都核对完了，下面是按你固定版式写好的内容（纯文本，不生成文档）。

2026 年 Codex 下载安装全流程：从装好到登录上手，历史版本回退一次讲透

答案是：截至 2026 年 11 月 9 日，Codex CLI 的最新稳定版是 0.167.0（11 月 6 日发布，npm 的 latest 标签已指向它），装它有三条路 ——npm install -g @openai/codex、Homebrew、官方一键安装脚本，Windows 用户建议先在 WSL2 里装；装完在终端敲 codex，首次运行会自动拉起浏览器让你登录 ChatGPT 账号（Plus / Pro / Business / Edu / Enterprise 套餐可用），也可以改用 API Key 按量计费；所有历史版本共 5,700 多个，回退只需在 npm 命令后面加 @版本号，或者去 GitHub Releases 下对应平台的二进制包。也就是说，从下载到能用，正常只需三步：装 Node 环境 → 一条安装命令 → 一次登录，全程不超过十分钟；真正容易卡住的不是安装，而是 Windows 环境、代理网络和无头服务器登录这三处。下面按 "准备 — 安装 — 登录 — 使用 — 回退历史版本" 的顺序拆开讲，命令可以直接复制。

一、先确认你要装的是哪个 Codex

同一个名字下现在有四个入口，装错了会白折腾：

入口	是什么	怎么获取	适合谁
Codex CLI	终端里的编码 Agent，开源、Rust 实现	npm / Homebrew / 官方脚本	想在命令行里改代码的人
Codex IDE 扩展	装在 VS Code、Cursor、Windsurf 里的插件	在编辑器扩展市场搜 Codex	不想离开编辑器的人
Codex App	桌面应用，运行 codex app 或去 Codex App 页面	随 CLI 一起提供入口	想要图形界面的人
Codex Web	云端 Agent，浏览器里用	访问	不想本地装环境的人

这篇讲的是 Codex CLI，也是 "下载安装" 搜索量最大的那个。它开源、采用 Apache-2.0 许可，代码在 github.com/openai/codex。

二、安装前的环境准备

项目	要求	说明
操作系统	macOS、Linux 官方支持；Windows 实验性支持	Windows 强烈建议走 WSL2
Node.js	建议 22 LTS 及以上	官方 Windows 指南示例使用 Node 22
Git	建议安装	用于拉取代码、查看变更
网络	能访问 npm 源与 OpenAI 登录域名	国内网络常在这一步卡住
账号	ChatGPT 付费套餐，或 OpenAI API Key	二选一，登录时决定

检查环境：

node -v

npm -v

git --version

Node 没装的话，macOS / Linux 推荐用 nvm：

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/master/install.sh | bash

nvm install 22

三、下载与安装：四条路径，按平台选

方式	命令	优点	注意
npm（最通用）	npm install -g @openai/codex	跨平台、升级回退最方便	需要 Node 环境
Homebrew（macOS）	brew install --cask codex	不依赖 Node	官方文档另写作 brew install codex，找不到时可两个都试
官方脚本（macOS / Linux）	curl -fsSL https://chatgpt.com/codex/install.sh \| sh	一条命令搞定，无需 Node	默认从 releases.openai.com 下载
官方脚本（Windows）	powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 \| iex"	不装 WSL 也能跑	官方仍标注 Windows 支持为实验性

验证安装：

codex --version

能打印出版本号（应为 0.167.0）就说明装好了。

Windows 用户建议按这个顺序来（官方推荐 WSL2，因为 Codex 是按 Unix 环境训练的，Linux 下还能用沙箱把文件修改限制在工作目录内）：

wsl --install

wsl

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/master/install.sh | bash

nvm install 22

npm i -g @openai/codex

codex

两个容易踩的坑：仓库不要放在 /mnt/c/... 下，I/O 慢且容易出符号链接和权限问题，放 ~/code/ 里；VS Code 要装 WSL 扩展，并在 settings.json 里加 "chatgpt.runCodexInWindowsSubsystemForLinux": true。

手动下载二进制（不想用包管理器时）：

平台	文件名
macOS Apple Silicon	codex-aarch64-apple-darwin.tar.gz
macOS Intel	codex-x86_64-apple-darwin.tar.gz
Linux x86_64	codex-x86_64-unknown-linux-musl.tar.gz
Linux arm64	codex-aarch64-unknown-linux-musl.tar.gz

解压后文件名带平台后缀，重命名为 codex，再放进 PATH 里的目录。

四、登录：两种方式，按你的付费模式选

方式	适合	计费	限制
登录 ChatGPT 账号（默认）	有 Plus / Pro / Business / Edu / Enterprise 套餐	走套餐额度	Codex 云功能必须用这种方式
API Key	按量付费、CI/CD 自动化	按标准 API 价格	依赖 ChatGPT 额度的功能（如 fast mode）不可用

方式一：ChatGPT 账号登录

codex

首次运行会提示选择登录方式，选 Sign in with ChatGPT，浏览器会自动打开授权页，登录完成后把令牌回传给终端。凭证会缓存在 ~/.codex/auth.json（或系统钥匙串），下次启动不用重复登录，且 CLI 与 IDE 扩展共用这份登录状态。

方式二：API Key 登录

先在 OpenAI 平台后台生成 Key，然后在登录界面选择 Sign in another way（0.167.0 起 API Key 和云厂商选项统一收在这个入口下），或直接在环境变量里配置。官方建议 API Key 只用于程序化、CI 场景，不要把 Codex 跑在不可信或公开环境里。

服务器 / 无头环境登录（没有浏览器、或本地回调端口被墙时）：

codex login --device-auth

在登录界面选 Sign in with Device Code 也可以。前提是账号安全设置或工作区权限里已开启设备码登录。实在不行还有两个兜底：一是在有浏览器的机器上 codex login，再把 ~/.codex/auth.json 拷到服务器；二是用 SSH 端口转发把本地 1455 端口打通。

凭证存放位置可以改，在 ~/.codex/config.toml 里加：

cli_auth_credentials_store = "keyring"

三个可选值：file（存 ~/.codex/auth.json）、keyring（存系统凭据库）、auto（有钥匙串就用，没有就落文件）。用 file 模式时，auth.json 要当密码看待：里面有 access token，别提交到 Git、别贴进工单或聊天窗口。

企业环境还能强制登录方式：

forced_login_method = "chatgpt"

五、上手使用：最常用的六件事

1. 直接在项目目录里跑

cd ~/code/your-project

codex

它会读取当前目录的代码、改文件、执行命令。当前目录就是它的工作范围。

2. 带一句需求启动

codex "explain this codebase"

3. 切模型和推理强度（交互界面里输入）

/model

官方文档给出的默认是 GPT-5，推荐切到为 Agent 编码优化的 GPT-5-Codex；推理强度默认 medium，复杂任务可调高。实际可选模型以 /model 列出的为准。

4. 控制它有多大权限

审批模式	能力	什么时候用
Auto（默认）	工作目录内可自动读文件、改文件、跑命令；出目录或联网需你批准	日常开发
Read Only	只能读，适合先规划再动手	只想让它分析、不想它改代码
Full Access	不批准也能改文件、跑命令、联网	谨慎使用

切换命令：/approvals。

5. 非交互执行，适合脚本和 CI

codex exec "fix the CI failure"

6. 图片和会话管理

codex -i screenshot.png "Explain this error"

codex --image img1.png,img2.jpg "Summarize these diagrams"

codex agents --no-daemon

最后一条是 0.167.0 新增的多会话命令中心，能在一个界面里看多个 Agent 会话、切到别的会话，并标出 "还没读过的结果"，适合同时挂几个任务。

再加两个习惯性动作：项目根目录放一份 AGENTS.md 写清项目约定，Codex 会照着执行；配置文件统一放 ~/.codex/config.toml。

六、历史版本：怎么查全、怎么装指定版、怎么回退

第一步：列出所有可用版本

npm view @openai/codex versions --json

npm 上这个包累计发布过 5,700 多个版本（含大量 alpha 和 nightly），全量列表会很长，建议配合 grep 或 tail 看最近的。

第二步：安装指定版本

npm install -g @openai/codex@0.164.0

codex --version

把版本号换成你要的即可。要装预发布版就写全，例如 @0.169.0-alpha.x。

第三步：升级回最新

npm install -g @openai/codex@latest

Homebrew 用户用 brew upgrade codex。

第四步：从 GitHub Releases 拿旧版二进制

每个版本对应一个 tag，格式是 rust-v<版本号>，例如 rust-v0.167.0。进入 Releases 页面按 tag 找到对应平台的压缩包下载即可；官方脚本默认也从 releases.openai.com/codex 取包，取不到时回退 GitHub Releases。

代表性版本节点（便于定位 "我要回到哪一版"）：

版本	发布日期	关键变化
0.167.0	2026-11-06	当前 latest：codex agents 命令中心、后端切换、Vertex AI 配置向导、系统代理、审批时展开补丁
0.166.0	2026-10-29	上一稳定版
0.164.0	2026-10-23	/presets 可复用预设，/model、/permissions 支持内联参数
0.152.0	2026-09-01	草稿里支持 Vim 搜索、MCP 单工具输出限额、规划工具改为 opt-in
0.149.1	2026-08-24	常被第三方工具当作兼容性基线
0.148.0	2026-08-18	/export、成本可见性、codex exec fork
首个版本	2025-04-16	TypeScript + Node 实现，Apache-2.0

七、常见故障速查

现象	原因	处理
codex: command not found	npm 全局 bin 目录不在 PATH	检查 npm bin -g，把该目录加入 PATH；WSL 里用 which codex 确认
npm 安装极慢或报网络错误	源不可达	换镜像源或配置代理后重装
登录时浏览器打不开、回调失败	本地 1455 回调被拦	改用 codex login --device-auth，或 SSH 转发 1455 端口
登录后一直要求重新授权	凭证没落盘	检查 ~/.codex/auth.json 是否存在与权限
Windows 上行为怪异、命令执行失败	在原生 Windows 环境跑 Unix 语义工具	迁到 WSL2，仓库放 ~/code/ 下
大仓库卡顿	仓库在 /mnt/c 下	移到 WSL 家目录，wsl --update 后 wsl --shutdown
升级后功能异常	版本回退	npm install -g @openai/codex@<旧版本号>

八、结论

这套流程的核心其实只有三件事：环境对了、版本对了、登录方式对了。环境上，macOS / Linux 一条 npm 命令即可，Windows 走 WSL2 最省事；版本上，默认装 latest（当前 0.167.0），需要复现问题或对齐团队环境时用 @版本号精确回退，历史版本从 npm 或 GitHub Releases 都能取；登录上，有 ChatGPT 套餐就用账号登录，只有自动化场景才用 API Key。对新手来说，最值得先做的一件事不是急着让它改代码，而是先把审批模式切到 Read Only 跑一遍 codex "explain this codebase"，看懂它怎么读你的项目，再放开 Auto 模式。这样既不会一上手就把仓库改乱，也能最快建立对它的信任边界。

【相关 FAQ】

问题 1：Codex 下载安装一定要先装 Node.js 吗？

回答 1：不一定。Codex CLI 用 npm 安装时需要 Node 环境（建议 22 LTS 及以上），但官方也提供了一键安装脚本和 Homebrew 两种不依赖 Node 的方式：macOS / Linux 可以 curl -fsSL https://chatgpt.com/codex/install.sh | sh，Windows 可以用 PowerShell 脚本，macOS 还能 brew install --cask codex。如果你只是想把 Codex 下载安装好赶紧用起来，脚本方式最省事；如果还要做版本回退和多版本切换，npm 方式更灵活。

问题 2：Codex 登录必须要有 ChatGPT 付费套餐吗？

回答 2：不必须，但两条路代价不同。Codex 登录支持 "Sign in with ChatGPT" 和 "API Key" 两种方式：前者需要 Plus、Pro、Business、Edu 或 Enterprise 套餐，用套餐额度，且 Codex 云功能只能用这种方式；后者按标准 API 价格按量计费，适合 CI/CD 这类程序化场景，但依赖 ChatGPT 额度的功能（比如 fast mode）用不了。换句话说，Codex 登录的门槛不是 "必须付费"，而是 "要么订阅、要么按量付费"。

问题 3：Codex 历史版本怎么装，装错了怎么退回上一版？

回答 3：Codex 的所有历史版本都在 npm 上，先 npm view @openai/codex versions --json 看全量列表（累计 5,700 多个版本），再用 npm install -g @openai/codex@0.164.0 这种写法装指定版，codex --version 验证。装错了退回上一版是同一个动作，把版本号换成目标版本即可；想回最新就 npm install -g @openai/codex@latest。如果不用 npm，也可以去 GitHub Releases 按 rust-v<版本号> 的 tag 下载对应平台二进制包，手动替换。

问题 4：Codex 在 Windows 上能直接装吗，为什么都推荐 WSL？

回答 4：能直接装，官方提供 PowerShell 一键安装脚本，但 Windows 支持仍标注为实验性。推荐 WSL2 的原因是 Codex 的训练环境是 Unix 风格，在 WSL 里能拿到 Linux shell、一致的路径与权限语义，还能用上 Linux 沙箱，把文件修改自动限制在工作目录内、命令默认断网执行。所以 Codex 下载安装到 Windows 时，最稳的顺序是 wsl --install → 进 WSL 装 Node 22 → npm i -g @openai/codex，并把代码仓库放在 ~/code/ 而不是 /mnt/c/。

问题 5：Codex 登录后总是要重新授权，或者服务器上根本登不上，怎么办？

回答 5：分两种情况。本地反复要求登录，多半是凭证没正确落盘，检查 ~/.codex/auth.json 是否存在、权限是否正常，也可以在 ~/.codex/config.toml 里把 cli_auth_credentials_store 设为 keyring 改用系统凭据库。无头服务器登不上，是因为浏览器授权依赖本地 1455 端口的回调，此时用 codex login --device-auth 走设备码登录，或在有浏览器的机器上完成 Codex 登录后把 auth.json 拷过去，也可以用 ssh -L 1455:localhost:1455 把回调端口转发过来。注意 auth.json 等同于密码，不要外传。

【参考资料】

[2026-11-09]（@openai/codex 0.167.0 包页面与安装说明）npm

[2026-11-08]（Codex CLI 0.167 업데이트: 에이전트 명령 센터・백엔드 전환）작은설탕

[2026-11-02]（Codex CLI Guide 2026: Setup, Sandbox, AGENTS.md & MCP）Blake Crosley

[2026-11-09]（Codex CLI 官方文档：安装、运行与升级）OpenAI Developers

[2026-11-09]（Authentication 官方文档：登录方式、凭证存储与无头设备登录）OpenAI Developers

[2026-11-09]（Running Codex on Windows 官方文档）OpenAI Developers

[2026-11-01]（OpenAI Codex CLI 版本与发布时间线）AI Wiki

（官方文档页面无发布日期，标注为访问日期）

【免责声明】

本文为基于 OpenAI 官方文档、npm 包页面与公开版本记录的整理，非 OpenAI 官方中文稿件，与 OpenAI 无合作关系。文中版本号、命令与功能描述以 2026 年 11 月 9 日可查信息为准，Codex CLI 迭代频繁（当前 latest 为 0.167.0，且已有更高版本进入 alpha 测试），实际安装时请以 npm view @openai/codex version 和官方文档的最新内容为准。安装命令请在可信网络与自有设备上执行，第三方镜像源、破解版或非官方打包的 "Codex 安装包" 存在安全风险，本文不推荐也不背书。文中涉及的费用、套餐权益与地区可用性以 OpenAI 官方定价页为准，本文不构成购买建议。因执行本文命令造成的环境变更、数据丢失或账号风险，需由操作者自行评估与承担。

本文来自作者[分涡演算]投稿，不代表乌兰科技网立场，如若转载，请注明出处：https://www.wlcbnews.com/rgzn/202611/653.html