Codex 一键配置安装教程

0. 前置：先安装 Node.js

一键配置脚本会自动安装 Codex CLI，但前提仍然是你的电脑已经装好 Node.js 和 npm。

Codex 对 Node.js 版本要求更高，建议直接使用 Node.js 22+。

先装 Node.js：

• macOS：Nodejs macOS
• Linux：Nodejs Linux
• Windows：Nodejs Windows

验证安装：分别执行下面两个命令

node -v

npm -v

如果看到版本号，说明 Node.js 安装成功了。

1. 运行一键配置命令

第一步：打开终端

• macOS：打开 Terminal
• Linux：打开你常用的终端
• Windows：请使用 Git Bash、MSYS2 或 WSL 终端运行下面命令，不要直接在 cmd 里执行

第二步：执行一键配置命令

curl -sSL https://sh.flashapi.top/codex.sh | bash

脚本启动后会显示菜单，你可以按提示选择：

• 1 只安装 Codex CLI
• 2 只配置 API Key 和线路
• 3 一键全部安装（推荐）

如果你是第一次安装，直接选 3 即可。

2. 这个脚本会做什么

2.1 安装 Codex CLI

脚本会先检查你的电脑里有没有 npm。

如果没有 npm，脚本会提示你先安装 Node.js（需要 v22+）。

脚本还会检查你的 Node.js 主版本号：

• 如果低于 22，脚本会提醒你 Codex CLI 建议使用 Node.js 22+
• 你可以选择继续安装，也可以先升级 Node.js 再回来执行

安装时脚本会执行：

npm install -g @openai/codex

如果默认 npm 源安装失败，脚本会自动切换到国内 npm 镜像（npmmirror.com）继续安装。

如果你之前已经装过 Codex CLI，脚本会先检测版本，并询问你是否重新安装。

2.2 配置 API Key 和线路

脚本会引导你完成下面几件事：

• 选择要配置的客户端（Codex CLI、桌面版 App，或两者都配）
• 选择 API 线路
• 输入你的闪电 API Key（输入时会用 * 遮盖，不会明文显示）
• 自动验证这个 Key 是否能正常获取模型列表
• 把配置写入 Codex 配置文件

你可以选择两条线路：

• https://ai.flashapi.top：国内直连，适合中国大陆用户
• https://cdn.flashapi.top：海外 CDN，适合海外网络环境

脚本最终写入两个文件：

~/.codex/config.toml（主配置）：

model_provider = "flashapi"
model = "gpt-5.5"
review_model = "gpt-5.5"
model_reasoning_effort = "high"
openai_base_url = "https://ai.flashapi.top/v1"
network_access = "enabled"
disable_response_storage = true
model_context_window = 270000

[model_providers.flashapi]
name = "flashapi"
base_url = "https://ai.flashapi.top/v1"
wire_api = "responses"
requires_openai_auth = true

注意：Codex 走 OpenAI 接口，Base URL 必须带 /v1。

~/.codex/auth.json（认证信息）：

{
  "OPENAI_API_KEY": "你的 API Key"
}

如果这两个文件已经存在，脚本会先备份原文件（加时间戳后缀），再写入新配置。

2.3 写入到哪里

Codex 配置统一写入 ~/.codex/ 目录，不依赖 Shell 环境变量。

3. 使用前你还需要准备什么

在运行一键配置前，请先准备好下面两样：

• 一个可用的闪电 API Key
• 你已经在 ai.flashapi.top 后台创建好对应的令牌分组

脚本本身也会提示你：如果没有先创建令牌分组，可能拿不到模型列表。

4. 安装完成后怎么用

脚本执行完成后，建议你关闭当前终端，再重新打开一个新的终端窗口。

然后先验证：

codex --version

你也可以顺手检查配置文件：

cat ~/.codex/config.toml

然后进入你的项目目录启动 Codex：

cd /path/to/your/project
codex

把 /path/to/your/project 替换成你的实际项目路径。

常见问题

1. 一键脚本提示未找到 npm

原因：你的机器还没有安装 Node.js，或者终端还没加载到 npm。

解决方法：

1. 先按你的系统安装 Node.js
2. 重新打开一个新的终端窗口
3. 先执行 node -v 和 npm -v
4. 确认正常后，再重新运行一键脚本

2. Node.js 版本低于 22，还能装吗？

可以，脚本会先给你提示，然后询问你是否继续。

但更推荐直接升级到 Node.js 22+，这样和 Codex CLI 的要求更一致，后面也更省事。

3. Windows 为什么不能直接用 PowerShell 跑这条命令？

这条命令本质上是把远程 bash 脚本交给本地 bash 执行，所以 Windows 需要有 Bash 环境。

推荐三种方式：

• 使用 Git Bash
• 使用 WSL
• 使用 MSYS2

如果你更想在 PowerShell 里手动配置，可以改看 Codex Windows。

4. 脚本执行完后，codex 还是找不到

原因：新的 PATH 还没有在当前终端里生效。

解决方法：

1. 先关闭当前终端
2. 再打开一个新的终端窗口
3. 重新执行 codex --version

如果还是不行，再重新运行一次脚本，选择 1 或 3。

5. API Key 验证失败，还能继续保存吗？

可以。脚本在验证失败时会再次询问你是否仍然保存配置。

但更推荐先检查：

1. API Key 是否复制完整
2. 令牌分组是否已经创建
3. 你选择的线路是否适合当前网络环境