Codex 高速通道 — 一行命令，立刻用上 GPT-5.5

One-Line Install

选择你的系统

先拿到服务方发放的 API Key，再复制下面的命令粘到终端。整个过程不到 3 分钟。

macOS

Apple Silicon · Intel · 自动装 brew/node

⌘ + 空格 → terminal

Windows

x64 · 自动装 winget/node · 管理员运行

Win + X → 终端 (管理员)

Linux

Ubuntu / Debian / CentOS / Fedora

需 sudo 权限

$ bash <(curl -fsSL https://codex-handbook.pages.dev/install.sh) && exec $SHELL

PS>

try { $env:CODEX_NO_PAUSE='1'; $u='https://codex-handbook.pages.dev/install.ps1'; iex ([System.Text.Encoding]::UTF8.GetString((New-Object Net.WebClient).DownloadData($u))) } catch { Write-Host ('Installer failed: ' + $_.Exception.Message) -ForegroundColor Red } finally { if (-not [Console]::IsInputRedirected) { Read-Host 'Press Enter to exit' } }

$ bash <(curl -fsSL https://codex-handbook.pages.dev/install.sh) && exec $SHELL

API Key 从哪里来？

API Key 需要由服务方在管理台生成：管理台 → 配置面板 → 认证 → API 密钥列表 (api-keys)，点击「添加 API 密钥」后可「生成」，保存后把这串 key 发给用户。

这个 key 才是客户端访问 https://api.tumpai.site:2053/v1 时使用的认证密钥，不是管理台登录密钥。

这条命令会做什么？

检查并安装 Node.js → 安装 Codex CLI → 提示你输入 API 密钥 → 自动写入 ~/.codex/config.toml 和环境变量 → 测试连通性。

所有操作都在你本机进行，密钥不会上传任何地方。可在 install.sh / install.ps1 查看源码。

Why Codex 高速通道

为什么选这个

把繁琐的环境配置压缩到一条命令，专注写代码本身。

一行命令

无需 brew、node、npm 任何前置知识。脚本自己装好所有依赖。

只问一次密钥

粘贴一次 API Key，自动写好配置和环境变量。下次开机即用。

三端覆盖

macOS / Windows / Linux 同一条命令体验。脚本自动识别系统。

本地优先

密钥只在本机的 ~/.codex/config.toml，不会上传。备份现有配置。

顶级模型

默认 GPT-5.5，可切 GPT-5.4。OpenAI 兼容协议，所有客户端通用。

稳定低延迟

API 直连 VPS HTTPS 入口，避开 CF Tunnel 中转；网站只负责分发安装脚本。

Quick Start

装完了，怎么用？

看到「🎉 安装完成」之后，关掉终端重新开一个，输入下面任一命令。

$ codex "用 python 写一个猜数字游戏"

$ codex

Models

支持的模型

安装时可选默认模型，之后随时改 ~/.codex/config.toml。

GPT-5.5 推荐

综合能力最强，复杂代码、架构设计、长上下文首选。

GPT-5.4

高性价比，日常代码、问答、重构够用，速度更快。

Compatible

不只是 Codex

同一把密钥，所有 OpenAI 兼容客户端通用。Base URL 都填同一个。

URL https://api.tumpai.site:2053/v1

Cursor

Settings → Models → Override OpenAI Base URL，填上面的地址，粘贴密钥。

Cherry Studio

设置 → 模型服务 → OpenAI → 改 API 地址，粘贴密钥即可。

NextChat / 沉浸式翻译

所有兼容 OpenAI 接口的工具：自定义接口地址改成上面这个 URL。

FAQ

常见问题

① 提示 command not found / 找不到 codex

关掉终端，重新开一个。环境变量需要新窗口才能生效。Windows 还可以重启电脑一次。

② 提示 401 / 密钥无效

密钥贴错了、过期了，或误用了管理台登录密钥。这里需要填写服务方在 api-keys 里生成的客户端 API Key。重跑安装命令，重新粘贴即可。

③ 提示 502 / 503 / 网络错误

服务方临时波动，等 1 分钟再试。持续 5 分钟以上，联系服务方。

④ 提示 429 / Too Many Requests

请求太频繁，等 30 秒再发。或者单次内容太大，拆分几次问。

⑤ 想换密钥怎么办？

重跑一次安装命令，输入新密钥即可。旧的会自动覆盖，旧 config.toml 自动备份。

⑥ 想卸载怎么办？

macOS / Linux：

$npm uninstall -g @openai/codex && rm -rf ~/.codex

Windows (PowerShell)：

PS>npm.cmd uninstall -g @openai/codex; Remove-Item -Recurse $HOME\.codex

然后到「设置 → 系统 → 高级系统设置 → 环境变量」删掉 TUMPAI_API_KEY。

⑦ Mac 提示「需要安装命令行工具」

点「安装」，等 5-10 分钟装完，然后重跑一次安装命令。这是 macOS 自带的开发工具。

⑧ Windows 提示「无法加载脚本，因为在此系统上禁止运行脚本」

先关掉当前 PowerShell，重新打开后再运行安装命令。新版脚本会自动绕过 npm.ps1。如果仍然报错，只在当前窗口执行：

PS>Set-ExecutionPolicy -Scope Process Bypass

然后重跑安装命令。

⑨ Windows 安装窗口一闪而过

打开 PowerShell，复制下面的诊断命令运行。新版脚本会在失败时停住窗口，并显示日志路径。

PS>

try { $env:CODEX_NO_PAUSE='1'; $u='https://codex-handbook.pages.dev/install.ps1'; iex ([System.Text.Encoding]::UTF8.GetString((New-Object Net.WebClient).DownloadData($u))) } catch { Write-Host ('Installer failed: ' + $_.Exception.Message) -ForegroundColor Red } finally { if (-not [Console]::IsInputRedirected) { Read-Host 'Press Enter to exit' } }

⑩ Windows 提示「powershell.exe 拒绝访问」

说明当前电脑禁止启动子 PowerShell。请改用 CMD 包装器，它会把错误留在窗口里：

PS>

cmd /k 'curl.exe -L -f -o "%TEMP%\codex-install.cmd" https://codex-handbook.pages.dev/install.cmd && call "%TEMP%\codex-install.cmd"'

准备好了吗？

复制一行命令，3 分钟后就能让 GPT-5.5 帮你写代码。

一键安装查看脚本源码

一行命令，立刻用上 GPT-5.5 · Codex CLI