Codex 使用 OpenAI 兼容入口 https://api.tumpai.site:2053/v1。先拿到服务方发放的 API Key,再复制下面的命令粘到终端;安装器会清理可能遮蔽新模型的旧目录配置。
bash <(curl -fsSL https://tumpai-handbook.pages.dev/install.sh) && exec $SHELL
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
已有用户执行下面的 GPT-6 修复模式即可:脚本会更新 Codex CLI、切换到精品 CN2、清理旧 model_catalog_json,并将默认模型设为 gpt-6-astra。
bash <(curl -fsSL https://tumpai-handbook.pages.dev/install.sh) --gpt6 && exec $SHELL
try { $env:CODEX_GPT6_REPAIR='1'; $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 ('GPT-6 repair failed: ' + $_.Exception.Message) -ForegroundColor Red } finally { if (-not [Console]::IsInputRedirected) { Read-Host 'Press Enter to exit' } }
API Key 需要由服务方在管理台生成:管理台 → 配置面板 → 认证 → API 密钥列表 (api-keys),点击「添加 API 密钥」后可「生成」,保存后把这串 key 发给用户。
这个 key 才是客户端访问 https://api.tumpai.site:2053/v1 时使用的认证密钥,不是管理台登录密钥。
检查并安装 Node.js → 安装 Codex CLI → 提示你输入 API 密钥 → 保留已有插件市场 / MCP 配置、清理旧 model_catalog_json 并更新 ~/.codex/config.toml → 写入环境变量 → 测试连通性。
如果 CN2 已返回 gpt-6-astra,但模型菜单仍未显示,重新运行安装或线路切换脚本并彻底重启客户端。Codex CLI 还需更新到 0.153.1 或更高版本;桌面应用使用自己的内嵌 Codex 版本,需要单独更新应用。
所有操作都在你本机进行,密钥不会上传任何地方。可在 install.sh / install.ps1 查看源码。
Claude Code 使用 Anthropic 网关入口 https://api.tumpai.site:2053。这里不要加 /v1,Claude Code 会自己请求 /v1/messages。
bash <(curl -fsSL https://tumpai-handbook.pages.dev/install-claude.sh) && exec $SHELL
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 CLI;已有 npm/nvm 安装会沿用原安装目录升级。Windows 会先校验并运行官方安装器,如果官方 URL 返回 HTML/地区不可用页面,会自动改用 winget install Anthropic.ClaudeCode,再把同一把 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_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1,让 Claude Code 在启动时读取中转站的 /v1/models;/model 的 From gateway 选项显示网关返回的模型 ID 和名称。
脚本会清理旧的 ANTHROPIC_DEFAULT_*_MODEL* / ANTHROPIC_MODEL / ANTHROPIC_CUSTOM_MODEL_OPTION* 固定覆盖和旧模型缓存,保留你选中的模型;旧脚本写入的 model=fable 默认项会移除。
同时会写入 permissions.defaultMode=bypassPermissions,也就是跳过所有权限确认的 YOLO 模式;脚本不会自动请求 /v1/models 做连通性验证。
claude
已经安装 Codex / Grok CLI / Claude Code / Gemini CLI 后,用这个脚本在 Tumpai 普通线路和精品 CN2 线路之间统一切换。两条线路使用同一把 TUMPAI_API_KEY。
bash <(curl -fsSL https://tumpai-handbook.pages.dev/switch-line.sh) cn2 --yes && exec $SHELL
bash <(curl -fsSL https://tumpai-handbook.pages.dev/switch-line.sh) normal --yes && exec $SHELL
try { $env:TUMPAI_SWITCH_LINE='cn2'; $env:TUMPAI_SWITCH_YES='1'; $env:TUMPAI_SWITCH_NO_PAUSE='1'; $u='https://tumpai-handbook.pages.dev/switch-line.ps1'; iex ([System.Text.Encoding]::UTF8.GetString((New-Object Net.WebClient).DownloadData($u))) } catch { Write-Host ('Line switch failed: ' + $_.Exception.Message) -ForegroundColor Red } finally { if (-not [Console]::IsInputRedirected) { Read-Host 'Press Enter to exit' } }
try { $env:TUMPAI_SWITCH_LINE='normal'; $env:TUMPAI_SWITCH_YES='1'; $env:TUMPAI_SWITCH_NO_PAUSE='1'; $u='https://tumpai-handbook.pages.dev/switch-line.ps1'; iex ([System.Text.Encoding]::UTF8.GetString((New-Object Net.WebClient).DownloadData($u))) } catch { Write-Host ('Line switch failed: ' + $_.Exception.Message) -ForegroundColor Red } finally { if (-not [Console]::IsInputRedirected) { Read-Host 'Press Enter to exit' } }
脚本不会重装 CLI,会同时更新四类入口:Codex/OpenAI 写入 ~/.codex/config.toml 的 base_url 并清理旧 model_catalog_json,Grok CLI 写入 ~/.grok/config.toml 的 models_base_url,Claude Code 写入 ANTHROPIC_BASE_URL,Gemini CLI 写入 GOOGLE_GEMINI_BASE_URL 和 ~/.gemini/.env。
普通线路分别使用 https://api.tumpai.site:2053/v1、https://api.tumpai.site:2053/v1、https://api.tumpai.site:2053、https://api.tumpai.site:2053/api/provider/antigravity;精品线路会切到对应的 cn2-api.tumpai.site 地址。
说明:脚本只改本机客户端配置,不会上传或改动服务端 Claude 账号认证文件,默认也不做健康探测。正常使用 Claude 时,请求会进入选中的中转站,并由服务端住宅代理链路处理上游认证。
两条线路同属 Tumpai,使用同一把 TUMPAI_API_KEY。如果本机已经保存过密钥,脚本会直接复用;也可以粘贴新 key 覆盖旧值。
切换时会清理 Codex 的旧 model_catalog_json;Claude Code 则开启网关模型发现,移除旧固定模型环境覆盖和 ~/.claude/cache/gateway-models.json,保留当前模型选择。
Claude Code 只在统一 macOS VM 内运行。成员本机只需要 Tailscale 和 SSH,不在本机安装 Claude Code、不设置 Base URL,也不接触中转站账号。
1/2/3/4vm 与 vmt 两个快捷命令bash <(curl -fsSL https://tumpai-handbook.pages.dev/team-vm.sh)
irm https://tumpai-handbook.pages.dev/team-vm.ps1 | iex
安装并登录团队 Tailscale。管理员已在 R4S 暴露 VM 路由,并在 VM 内启用 SSH;成员本机需要能通过 SSH 访问 192.168.50.122:22。
新用户和旧用户都运行同一条初始化命令,再选原来的成员编号。旧用户会更新本机 vm / vmt;首次登录新 VM 需输入 cc 用户密码。
脚本会在 VM 内生成或复用 siyun-dev GitHub SSH key,并写入 github-main 别名。四个人只区分 Git 提交姓名和邮箱。
重开终端后执行 vm 直连 VM;VM 装好 tmux 后,执行 vmt 可进入自己的保活会话。
每个成员都有单独的工作目录;大家共用 cc 系统用户,目录不构成权限隔离。只在自己的目录里拉项目、运行 claude、提交代码。
VM 安装 tmux 后,vmt 会进入 成员-main 会话并支持断线恢复。当前新 VM 尚未安装 tmux,vmt 会提示并回退普通 SSH,不能保活。
脚本会在 VM 的 shell 和 tmux 环境写入 COLORTERM=truecolor、DISABLE_AUTOUPDATER=1 与 DISABLE_UPDATES=1,让 Claude Code 保持原生色彩并避免自动更新报错。
脚本会给你的成员目录写目录级 Git 配置,避免多人提交都显示成同一个 Git 作者。GitHub clone 统一使用 github-main,走 ssh.github.com:443。
不要在成员本机安装或登录 Claude Code。Claude Code、出口网络、时区和账号状态都统一留在 macOS VM 里。
新 VM 运行 macOS,旧 Ubuntu 的 iTerm2 图片桥不适用。新版初始化脚本会跳过旧图片桥,并更新 vm / vmt 到新 VM。
macOS · 192.168.50.122登录团队 Tailscale,打开下方文件网关,选择自己的成员空间并上传图片。
在 VM 中运行 claude,输入图片路径,例如 /Users/cc/lyx/screenshot.png,让 Claude 读取图片。
重新运行上方入口命令并选择原成员编号,完成后重开终端。更新只切换连接入口;旧 VM 的项目、GitHub 公钥和会话需要另行迁移。
连接团队 Tailscale 后打开文件网关,选择自己的成员身份,即可上传资料和下载结果。文件网关已经连接新 macOS VM。
http://100.92.77.45:8787/
LYX → /Users/cc/lyxCJ → /Users/cc/cjLJ → /Users/cc/ljRXP → /Users/cc/rxp
通过网关管理文件;运行 Claude、Git 和项目命令时,使用 vm 进入新 VM 终端。
文件网关需要 Tailscale。旧的 192.168.50.126 SMB 共享不再作为当前入口,请删除旧书签并改用此地址。
系统设置 → 通用 → 共享 → 远程登录(允许 cc);tmux 需另行安装
ssh -o ConnectTimeout=8 cc@192.168.50.122 true
ssh cc@192.168.50.122
vm
vmt
git clone git@github-main:OWNER/REPO.git
Gemini CLI 使用 Antigravity provider 专属 Gemini API 入口 https://api.tumpai.site:2053/api/provider/antigravity。这里不要再加 /v1 或 /v1beta,脚本会设置 GOOGLE_GENAI_API_VERSION=v1beta。
bash <(curl -fsSL https://tumpai-handbook.pages.dev/install-gemini.sh) && exec $SHELL
try { $env:GEMINI_TUMPAI_NO_PAUSE='1'; $u='https://tumpai-handbook.pages.dev/install-gemini.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-gemini.sh) && exec $SHELL
脚本会安装 @google/gemini-cli,优先复用本机已有的 TUMPAI_API_KEY / GEMINI_API_KEY,不会让已安装过 Codex 或 Claude Code 的用户再粘贴一次密钥。
随后把同一把 Tumpai API Key 写成 GEMINI_API_KEY,并设置 GOOGLE_GEMINI_BASE_URL=https://api.tumpai.site:2053/api/provider/antigravity、GOOGLE_GENAI_API_VERSION=v1beta 和 GEMINI_MODEL=auto-gemini-3。
同时会备份并更新 ~/.gemini/settings.json,写入 security.auth.selectedType=gemini-api-key 和 security.auth.enforcedType=gemini-api-key,并把同一组变量写到 ~/.gemini/.env,让 Gemini CLI 直接走 API key 模式。macOS 上如果 Homebrew 旧版 gemini-cli 抢先,脚本会把当前 Node 的 bin 目录写到 PATH 前面。
按 CLIProxyAPI 官方文档,/api/provider/antigravity 会把 Gemini API 请求打到 Antigravity provider-specific 路径;Gemini CLI 实际请求的是 /api/provider/antigravity/v1beta/models 和生成接口。脚本还会读取 /v1/models,只接受 owned_by=antigravity 且模型名为 gemini* 的模型,并写入 modelConfigs.customAliases,让 Auto (Gemini 3)、Auto (Gemini 2.5) 和 auto 都映射到 Antigravity Gemini 模型,避免误选 Claude / Codex 账号模型。
Gemini CLI 的 YOLO 不能写进 settings.json;脚本会在 shell rc 或 PowerShell profile 里写入 gemini 包装函数。之后直接运行 gemini,实际会追加 --approval-mode=yolo --skip-trust;显式传 --approval-mode=default 时不会覆盖用户选择。
gemini
Rust Token Killer 会压缩终端输出、测试日志、目录列表和 Git 信息,减少 Claude Code / Codex 读取工具结果时消耗的 token。
bash <(curl -fsSL https://tumpai-handbook.pages.dev/install-rtk.sh) && exec $SHELL
try { $env:RTK_TUMPAI_NO_PAUSE='1'; $u='https://tumpai-handbook.pages.dev/install-rtk.ps1'; iex ([System.Text.Encoding]::UTF8.GetString((New-Object Net.WebClient).DownloadData($u))) } catch { Write-Host ('RTK 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-rtk.sh) && exec $SHELL
脚本安装的是 rtk-ai/rtk,不会使用 cargo install rtk,避免装到同名的 Rust Type Kit。安装后会运行 rtk init -g --auto-patch 和 rtk init -g --codex。
只想安装命令、不改 Claude Code / Codex 配置时,macOS / Linux 加 --no-init;Windows 设置 $env:RTK_INIT='0' 后再运行。
安装完成后需要重启 Claude Code / Codex 会话。旧会话不会自动加载新的 hook 和全局指令。
rtk verify
rtk gain
用几次 Claude Code / Codex 后,再运行 rtk gain。如果看到 Tokens saved 增长,就说明 RTK 已经在节省工具输出 token。
示例里原始终端输出约 388 tokens,RTK 压缩后只让 AI 读取 133 tokens,节省 255 tokens。
命令原始输出,没压缩时 AI 需要读这么多。
RTK 去掉重复、噪音、长日志和无关细节。
最终交给 Claude Code / Codex 的精简内容。
目前统计到 2 次通过 RTK 处理的命令。
整体压缩效率,越高代表省得越多。
逐条列出哪个命令贡献了多少节省。
移除 Tumpai 接入配置,恢复 Codex、Claude Code 和 Gemini CLI 的原始连接状态。默认保留官方 CLI,只清理代理配置、环境变量、默认模型、YOLO 设置和模型发现缓存。
bash <(curl -fsSL https://tumpai-handbook.pages.dev/uninstall.sh) && exec $SHELL
try { $env:TUMPAI_UNINSTALL_NO_PAUSE='1'; $u='https://tumpai-handbook.pages.dev/uninstall.ps1'; iex ([System.Text.Encoding]::UTF8.GetString((New-Object Net.WebClient).DownloadData($u))) } catch { Write-Host ('Uninstaller failed: ' + $_.Exception.Message) -ForegroundColor Red } finally { if (-not [Console]::IsInputRedirected) { Read-Host 'Press Enter to exit' } }
TUMPAI_REMOVE_CLI=1 bash <(curl -fsSL https://tumpai-handbook.pages.dev/uninstall.sh)
脚本会先备份当前配置,再移除本站写入的 codex-tumpai / claude-tumpai / gemini-tumpai 标记块、Tumpai API Key、Anthropic 网关变量、Claude Code 默认模型和 YOLO 权限设置、Gemini CLI YOLO 包装、From gateway 模型缓存和 Gemini CLI API key 认证设置。
只恢复单项时,运行前设置 TUMPAI_UNINSTALL_TARGET=codex、TUMPAI_UNINSTALL_TARGET=claude 或 TUMPAI_UNINSTALL_TARGET=gemini。
把 Codex、Grok CLI、Claude Code 和 Gemini CLI 的环境配置压缩到几条可审计脚本,用户只需要拿到一把客户端密钥。
Codex、Claude Code 和 Gemini CLI 提供一条命令安装入口;Grok CLI 已安装时,线路切换脚本会写入中转配置。
同一把 Tumpai API Key 自动映射到 Codex、Grok CLI、Claude Code 和 Gemini CLI 需要的本地环境变量。
macOS / Windows / Linux 同一条命令体验。脚本自动识别系统。
密钥只写入用户本机 shell 或用户环境变量,不会上传到这个静态网站。
Codex 走 OpenAI 兼容协议,Claude Code 走 Anthropic Messages 网关,Gemini CLI 走 Antigravity provider 专属 Gemini API 网关。
API 直连 VPS HTTPS 入口,避开 CF Tunnel 中转;网站只负责分发安装脚本。
看到安装完成后,关掉终端重新开一个,根据你安装的工具运行下面命令。
codex "用 python 写一个猜数字游戏"
codex
claude
claude "帮我解释这个项目的目录结构"
gemini
gemini "帮我解释这个项目的目录结构"
Codex 默认写入 ~/.codex/config.toml;Claude Code 写入 Anthropic 连接环境变量;Gemini CLI 写入 Gemini API key 模式配置。
精品 CN2 线路已提供 gpt-6-astra。新版 Codex CLI 可在模型菜单中选择,也可使用 codex -m gpt-6-astra 直接启动。
普通线路默认模型,适合复杂代码、架构设计和长上下文任务。
高性价比,日常代码、问答、重构够用,速度更快。
使用 ANTHROPIC_BASE_URL 接入同一中转站,开启网关模型发现,由中转站返回模型名称与 ID。
使用 GOOGLE_GEMINI_BASE_URL 接入 Antigravity provider 专属 Gemini API 网关。
同一把密钥可以给不同客户端使用,但要按客户端协议填不同入口。
https://api.tumpai.site:2053/v1
https://api.tumpai.site:2053
https://api.tumpai.site:2053/api/provider/antigravity
Settings → Models → Override OpenAI Base URL,填 OpenAI 兼容地址,粘贴密钥。
填根地址 https://api.tumpai.site:2053,认证使用 ANTHROPIC_AUTH_TOKEN。
填 Antigravity provider 专属地址 https://api.tumpai.site:2053/api/provider/antigravity,认证使用 GEMINI_API_KEY,API 版本默认 v1beta,本脚本默认用 YOLO 启动。
设置 → 模型服务 → OpenAI → 改 API 地址为 OpenAI 兼容地址,粘贴密钥即可。
所有兼容 OpenAI 接口的工具:自定义接口地址改成 OpenAI 兼容地址。
关掉终端,重新开一个。环境变量需要新窗口才能生效。Windows 还可以重启电脑一次。
密钥贴错了、过期了,或误用了管理台登录密钥。这里需要填写服务方在 api-keys 里生成的客户端 API Key。重跑安装命令,重新粘贴即可。
服务方临时波动,等 1 分钟再试。持续 5 分钟以上,联系服务方。
请求太频繁,等 30 秒再发。或者单次内容太大,拆分几次问。
重跑一次安装命令,输入新密钥即可。旧的会自动覆盖,旧 config.toml 自动备份。
先确认 ANTHROPIC_BASE_URL 是 https://api.tumpai.site:2053,不要带 /v1,并确认 ANTHROPIC_AUTH_TOKEN 是服务方发放的客户端 API Key。若 /model 没有 From gateway,检查 CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1,然后重开终端和 Claude Code 会话。模型发现失败时,CLI 可能回退到缓存或内置列表。
先确认 GOOGLE_GEMINI_BASE_URL 是 https://api.tumpai.site:2053/api/provider/antigravity,不要再带 /v1 或 /v1beta。然后重开终端,确认 GEMINI_API_KEY 是服务方发放的客户端 API Key。若 https://api.tumpai.site:2053/api/provider/antigravity/v1beta/models 返回 404,说明后端还没开 Antigravity provider-specific Gemini API gateway;若 auto 一直停在 Thinking,确认 ~/.gemini/settings.json 里有 modelConfigs.customAliases,并确认 /v1/models 里 Gemini 模型的 owned_by 是 antigravity;本站脚本默认使用 auto-gemini-3,并用 type -a gemini 确认不是旧版 Homebrew gemini-cli 抢先;若当前环境已有 GOOGLE_API_KEY,Gemini SDK 会优先使用它,可先执行 unset GOOGLE_API_KEY 后再试。
安装脚本会备份并更新 ~/.claude/settings.json,写入 env.CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1、permissions.defaultMode=bypassPermissions 和 permissions.skipDangerousModePermissionPrompt=true。模型列表由中转站发现,模型选择与权限模式各自生效。
Gemini CLI 官方不允许在 settings.json 里设置 yolo,只能通过启动参数开启。所以本站脚本会写入 shell / PowerShell 包装函数,让 gemini 默认等价于 gemini --approval-mode=yolo --skip-trust。临时关闭时运行 gemini --approval-mode=default。
macOS / Linux / WSL:
bash <(curl -fsSL https://tumpai-handbook.pages.dev/uninstall.sh) && exec $SHELLWindows PowerShell:
try { $env:TUMPAI_UNINSTALL_NO_PAUSE='1'; $u='https://tumpai-handbook.pages.dev/uninstall.ps1'; iex ([System.Text.Encoding]::UTF8.GetString((New-Object Net.WebClient).DownloadData($u))) } catch { Write-Host ('Uninstaller failed: ' + $_.Exception.Message) -ForegroundColor Red } finally { if (-not [Console]::IsInputRedirected) { Read-Host 'Press Enter to exit' } }默认只移除 Tumpai 接入配置,保留官方 CLI;会清理 TUMPAI_API_KEY、ANTHROPIC_AUTH_TOKEN、ANTHROPIC_BASE_URL、GEMINI_API_KEY、Claude Code 默认模型和 YOLO 设置、Gemini CLI YOLO 包装、网关模型缓存和 Gemini API key 认证设置。需要连 npm 安装的 CLI 一起尝试卸载时,运行前设置 TUMPAI_REMOVE_CLI=1。
点「安装」,等 5-10 分钟装完,然后重跑一次安装命令。这是 macOS 自带的开发工具。
先关掉当前 PowerShell,重新打开后再运行安装命令。新版脚本会自动绕过 npm.ps1。如果仍然报错,只在当前窗口执行:
Set-ExecutionPolicy -Scope Process Bypass然后重跑安装命令。
打开 PowerShell,复制下面的诊断命令运行。新版脚本会在失败时停住窗口,并显示日志路径。
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' } }说明当前电脑禁止启动子 PowerShell。请改用 CMD 包装器,它会把错误留在窗口里:
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、Gemini CLI 或 RTK,复制一行命令,几分钟内完成安装和本机配置。