复制下面的命令,粘到终端,回车。整个过程不到 3 分钟。
bash <(curl -fsSL https://codex-handbook.pages.dev/install.sh) && exec $SHELL
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。
综合能力最强,复杂代码、架构设计、长上下文首选。
高性价比,日常代码、问答、重构够用,速度更快。
同一把密钥,所有 OpenAI 兼容客户端通用。Base URL 都填同一个。
https://cliproxy.tumpai.site/v1
Settings → Models → Override OpenAI Base URL,填上面的地址,粘贴密钥。
设置 → 模型服务 → OpenAI → 改 API 地址,粘贴密钥即可。
所有兼容 OpenAI 接口的工具:自定义接口地址改成上面这个 URL。
关掉终端,重新开一个。环境变量需要新窗口才能生效。Windows 还可以重启电脑一次。
密钥贴错了或过期了。重跑安装命令,重新粘贴密钥即可。粘贴时确保没有多余空格,从第一个字符到最后一个字符。
服务方临时波动,等 1 分钟再试。持续 5 分钟以上,联系服务方。
请求太频繁,等 30 秒再发。或者单次内容太大,拆分几次问。
重跑一次安装命令,输入新密钥即可。旧的会自动覆盖,旧 config.toml 自动备份。
macOS / Linux:
npm uninstall -g @openai/codex && rm -rf ~/.codexWindows (PowerShell):
npm uninstall -g @openai/codex; Remove-Item -Recurse $HOME\.codex然后到「设置 → 系统 → 高级系统设置 → 环境变量」删掉 TUMPAI_API_KEY。
点「安装」,等 5-10 分钟装完,然后重跑一次安装命令。这是 macOS 自带的开发工具。
在 PowerShell(管理员)执行:
Set-ExecutionPolicy -Scope CurrentUser RemoteSigned输入 Y 确认,然后重跑安装命令。