一行命令安装 全平台支持 5 分钟跑通

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

无需懂代码,无需手工改配置。复制 → 粘贴 → 输入密钥,全自动完成 Codex CLI 安装、模型配置、连通性验证。

兼容客户端
OpenAI Codex CLI Cursor Cherry Studio NextChat 沉浸式翻译 所有 OpenAI 兼容工具

选择你的系统

复制下面的命令,粘到终端,回车。整个过程不到 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> irm https://codex-handbook.pages.dev/install.ps1 | iex
$ bash <(curl -fsSL https://codex-handbook.pages.dev/install.sh) && exec $SHELL
这条命令会做什么?

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

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

为什么选这个

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

一行命令

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

只问一次密钥

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

三端覆盖

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

本地优先

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

顶级模型

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

稳定低延迟

Cloudflare 全球边缘节点,国内直连无需代理。

装完了,怎么用?

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

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

支持的模型

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

GPT-5.5 推荐

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

GPT-5.4

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

不只是 Codex

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

URL https://cliproxy.tumpai.site/v1

Cursor

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

Cherry Studio

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

NextChat / 沉浸式翻译

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

常见问题

① 提示 command not found / 找不到 codex

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

② 提示 401 / 密钥无效

密钥贴错了或过期了。重跑安装命令,重新粘贴密钥即可。粘贴时确保没有多余空格,从第一个字符到最后一个字符。

③ 提示 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 uninstall -g @openai/codex; Remove-Item -Recurse $HOME\.codex

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

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

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

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

在 PowerShell(管理员)执行:

PS>Set-ExecutionPolicy -Scope CurrentUser RemoteSigned

输入 Y 确认,然后重跑安装命令。

准备好了吗?

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