Code80

Appearance

Codex CLI 安装详解 ​

Codex CLI 需要 Node.js 22+ 环境。最快的方式是跑一键脚本：装官方 CLI、接入 Code80、把 Key 放进 auth.json。

一键脚本会改现有配置，请谨慎使用

它会修改 ~/.codex/config.toml。已有文件会先备份成 config.toml.bak.时间戳。

  • 已装 oh-my-codex，或有 MCP / hooks / 自定义 provider：运行时选 1）保留现有配置，只接入 Code80
  • 选 2）覆盖 会换成 Code80 推荐模板，当前文件里的自定义内容会没掉（备份还在）
  • 想改回 OpenAI 官方，用下面的恢复脚本，不要重装一遍 Codex

一键安装配置 ​

macOS / Linux ​

在终端执行：

bash
curl -fsSL https://docs.ai80.vip/codex/install.sh | bash

脚本会通过 /dev/tty 交互询问 Code80 OpenAI 分组 的 API Key。输入时屏幕上会显示你打的内容，核对无误再回车。Key 只写入 auth.json，脚本不会再打印一遍。

不想交互时，把变量写在管道右边（写在 curl 前面 bash 读不到）：

bash
curl -fsSL https://docs.ai80.vip/codex/install.sh | CODE80_API_KEY='你的Key' bash

Windows ​

Windows 同样会交互询问 Key。在 PowerShell（不是 CMD）执行：

powershell
irm https://docs.ai80.vip/codex/install.ps1 | iex

系统自带 Windows PowerShell 5.1 用 irm 时可能把 UTF-8 中文解成乱码（一é...），并让后面的 node 报 endsWith(\n)。新版脚本会自动按 UTF-8 重新加载。仍乱码请改用：

powershell
iex ([Text.Encoding]::UTF8.GetString((iwr -useb https://docs.ai80.vip/codex/install.ps1).RawContentStream.ToArray()).TrimStart([char]0xFEFF))

输入时屏幕上会显示 Key，核对后再回车。不想交互时，先设环境变量再跑脚本（必须同一窗口）：

powershell
$env:CODE80_API_KEY='你的Key'
irm https://docs.ai80.vip/codex/install.ps1 | iex

若提示无法运行脚本：

powershell
Set-ExecutionPolicy -Scope CurrentUser RemoteSigned

也可以把下面两个文件下到同一目录，双击 install.cmd：

脚本会：

  1. 检查 / 安装 Node.js 22+
  2. npm install -g @openai/codex
  3. 备份已有 config.toml，然后按你的选择：保留现有配置只改 Code80 接入，或写入推荐模板
  4. 把 Key 写入 ~/.codex/auth.json，权限收紧为当前用户
  5. 固定 requires_openai_auth = true、supports_websockets = false，避免 0.149.0 的 401 和「正在重新连接」

覆盖模式下默认模型是 gpt-5.6-terra。保留模式下不改你原来的 model。不要写 gpt-5.6 或 gpt-luna。

配完必须彻底退出 Codex 再开，并用新对话测试。只关窗口不够。Windows 请用任务管理器结束 codex 进程，并确认 %USERPROFILE%\.codex\config.toml 里有 supports_websockets = false。

Windows 启动这两条必须遵守

  1. 不要在 C:\WINDOWS\system32 里跑 codex。 管理员 PowerShell 默认就在这里。先 cd 到项目。若 config 里已经有 [projects.'c:\windows\system32']，整段删掉。
  2. 不要写 service_tier = "fast" / "priority"。 Code80 不支持官方服务档，写了会 Reconnecting / Stream disconnected。有就删掉这一行。

然后在项目目录开新对话测试。

旧配置若不能搜新闻

新模板默认 web_search = "live"、network_access = true。以前装过仍是 cached / false 的，改这两项后彻底退出再测。Google、Reddit 在国内经常连不上，和 Code80 Key 无关。

不想跑脚本，也可以把概述页的 Agent 提示词复制给 Claude Code / Grok，让 Agent 代装。

恢复 OpenAI 官方配置 ​

安装脚本只改接入，不卸载 codex。若要继续用 OpenAI 官方（ChatGPT 登录或官方 API Key），跑恢复脚本：

macOS / Linux：

bash
curl -fsSL https://docs.ai80.vip/codex/restore.sh | bash

Windows（PowerShell）：

powershell
irm https://docs.ai80.vip/codex/restore.ps1 | iex

会先把当前配置另存一份，再让你选：

  1. 恢复安装前的备份（oh-my-codex 等也会回来）
  2. 只切回官方 openai provider，保留其他配置
  3. 取消

选 2 之后必须先登出再登录，不要接着提问：

  1. 打开 Codex
  2. 输入 /logout（清掉 Code80 凭据）
  3. 按提示用 ChatGPT 登录
  4. 用新对话测试

漏掉 /logout 会带着 Code80 Key 打 api.openai.com，立刻 401 Incorrect API key。脚本同时会注释掉 gpt-5.6-terra 这类 Code80 模型 ID。若其实还想用 Code80，把脚本另存的 config.toml.code80.bak.* 拷回去，或重跑安装脚本。

前置条件 ​

  • Node.js 22 或更高版本
  • npm（随 Node.js 一起安装）
  • Linux 用户还需要 bubblewrap（沙箱运行）

macOS ​

安装 Node.js ​

bash
brew install node

验证版本 ​

bash
node --version  # 需要 v22+

安装 Codex CLI ​

bash
npm install -g @openai/codex

验证安装 ​

bash
codex --version

Windows ​

安装 Node.js ​

bash
winget install OpenJS.NodeJS.LTS
其他安装方式
bash
choco install nodejs-lts
scoop install nodejs-lts

安装 Codex CLI ​

bash
npm install -g @openai/codex

如遇权限问题，请以管理员身份运行。

验证安装 ​

bash
codex --version

Linux ​

安装 Node.js ​

bash
curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
sudo apt-get install -y nodejs

安装沙箱依赖 ​

Codex CLI 在 Linux 上需要 bubblewrap 来运行沙箱环境：

bash
sudo apt-get install bubblewrap

安装 Codex CLI ​

bash
sudo npm install -g @openai/codex

验证安装 ​

bash
codex --version

常见安装问题 ​

Node.js 版本不够 ​

Codex CLI 要求 Node.js 22+，比 Claude Code 的要求更高。使用 nvm 管理版本：

bash
nvm install 22
nvm use 22

Linux 缺少 bubblewrap ​

bash
sudo apt-get install bubblewrap