⚡ Tumpai Handbook
开始安装
一行命令安装 全平台支持 5 分钟跑通

一行命令，立刻用上
Codex CLI · Claude Code

一个中转站，两套代码助手。复制命令、粘贴密钥，自动完成 Codex CLI 或 Claude Code 的安装、环境变量配置、YOLO 权限和连通性验证。

一键安装 查看用法
兼容客户端
OpenAI Codex CLI Claude Code Cursor Cherry Studio NextChat 沉浸式翻译 所有 OpenAI 兼容工具
Codex CLI

安装 Codex CLI

Codex 使用 OpenAI 兼容入口 https://api.tumpai.site:2053/v1。先拿到服务方发放的 API Key，再复制下面的命令粘到终端。

macOS

Apple Silicon · Intel · 自动装 brew/node
⌘ + 空格 → terminal

Windows

x64 · 自动装 winget/node · 管理员运行
Win + X → 终端 (管理员)

Linux

Ubuntu / Debian / CentOS / Fedora
需 sudo 权限
$ bash <(curl -fsSL https://tumpai-handbook.pages.dev/install.sh) && exec $SHELL
PS> try { $env:CODEX_NO_PAUSE='1'; $u='https://tumpai-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://tumpai-handbook.pages.dev/install.sh) && exec $SHELL
API Key 从哪里来？

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

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

Codex 安装脚本会做什么？

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

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

Claude Code

安装 Claude Code

Claude Code 使用 Anthropic 网关入口 https://api.tumpai.site:2053。这里不要加 /v1，Claude Code 会自己请求 /v1/messages。

macOS

安装官方 Claude Code · 开启 YOLO 权限

Windows

PowerShell · 用户环境变量 · YOLO 权限

Linux / WSL

官方安装器 · YOLO 模式 · Tumpai 网关
$ bash <(curl -fsSL https://tumpai-handbook.pages.dev/install-claude.sh) && exec $SHELL
PS> try { $env:CLAUDE_TUMPAI_NO_PAUSE='1'; $u='https://tumpai-handbook.pages.dev/install-claude.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://tumpai-handbook.pages.dev/install-claude.sh) && exec $SHELL
Claude Code 配置重点

脚本会安装官方 Claude Code CLI，然后把同一把 Tumpai API Key 写成 ANTHROPIC_AUTH_TOKEN，并设置 ANTHROPIC_BASE_URL=https://api.tumpai.site:2053。

如果把 Base URL 写成 https://api.tumpai.site:2053/v1，Claude Code 会请求到 /v1/v1/messages，会连接失败。

脚本不会写死具体 Claude 模型版本；会清理旧脚本写过的 ANTHROPIC_DEFAULT_* / ANTHROPIC_MODEL，并开启 CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1。需要指定模型时，进入 Claude Code 后用 /model 选择中转站返回的模型。

同时会写入 ~/.claude/settings.json，设置 permissions.defaultMode=bypassPermissions，也就是跳过所有权限确认的 YOLO 模式。

$ claude
Why Tumpai Handbook

为什么选这个

把 Codex 和 Claude Code 的环境配置压缩到几条可审计脚本，用户只需要拿到一把客户端密钥。

一行命令

Codex 和 Claude Code 都提供一条命令安装入口，脚本负责依赖、配置和连通性检查。

只问一次密钥

同一把 Tumpai API Key 自动映射到 Codex 和 Claude Code 需要的本地环境变量。

三端覆盖

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

本地优先

密钥只写入用户本机 shell 或用户环境变量，不会上传到这个静态网站。

顶级模型

Codex 走 OpenAI 兼容协议，Claude Code 走 Anthropic Messages 网关，并默认开启 YOLO 权限。

稳定低延迟

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

Quick Start

装完了，怎么用？

看到安装完成后，关掉终端重新开一个，根据你安装的工具运行下面命令。

$ codex "用 python 写一个猜数字游戏"
$ codex
$ claude
$ claude "帮我解释这个项目的目录结构"
Models

支持的模型

Codex 默认写入 ~/.codex/config.toml；Claude Code 按 CLIProxyAPI 官方方式写入 Anthropic 模型环境变量。

GPT-5.5 推荐

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

GPT-5.4

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

Claude Code

使用 ANTHROPIC_BASE_URL 接入同一中转站；不固定模型版本，交给 Claude Code 和 CLIProxyAPI 使用当前可用模型。

Compatible

不只是命令行

同一把密钥可以给不同客户端使用，但要按客户端协议填不同入口。

OpenAI https://api.tumpai.site:2053/v1
Claude https://api.tumpai.site:2053

Cursor

Settings → Models → Override OpenAI Base URL，填 OpenAI 兼容地址，粘贴密钥。

Claude Code

填根地址 https://api.tumpai.site:2053，认证使用 ANTHROPIC_AUTH_TOKEN。

Cherry Studio

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

NextChat / 沉浸式翻译

所有兼容 OpenAI 接口的工具：自定义接口地址改成 OpenAI 兼容地址。

FAQ

常见问题

① 提示 command not found / 找不到 codex

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

② 提示 401 / 密钥无效

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

③ 提示 502 / 503 / 网络错误

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

④ 提示 429 / Too Many Requests

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

⑤ 想换密钥怎么办？

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

⑥ Claude Code 连接失败怎么办？

先确认 ANTHROPIC_BASE_URL 是 https://api.tumpai.site:2053，不要带 /v1。然后重开终端，确认 ANTHROPIC_AUTH_TOKEN 是服务方发放的客户端 API Key。模型异常时，在 Claude Code 里用 /model 选择中转站返回的模型。

⑦ Claude Code YOLO 是怎么开的？

安装脚本会备份并更新 ~/.claude/settings.json，写入 permissions.defaultMode=bypassPermissions 和 permissions.skipDangerousModePermissionPrompt=true。之后运行 claude 就是跳过权限确认的模式。

⑧ 想卸载怎么办？

Codex macOS / Linux：

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

Codex Windows (PowerShell)：

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

Claude Code：

$rm -rf ~/.claude ~/.local/bin/claude

然后删除本机环境变量 TUMPAI_API_KEY、ANTHROPIC_AUTH_TOKEN、ANTHROPIC_BASE_URL。

⑨ 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://tumpai-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://tumpai-handbook.pages.dev/install.cmd && call "%TEMP%\codex-install.cmd"'

准备好了吗？

选择 Codex 或 Claude Code，复制一行命令，几分钟内接入同一个 Tumpai 中转站。

安装 Codex 安装 Claude Code 查看 Codex 脚本