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

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

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

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

安装 Codex CLI

Codex 使用 OpenAI 兼容入口 https://sundy-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://sundy.tumpai.site/install.sh) && exec $SHELL
PS> try { $env:CODEX_NO_PAUSE='1'; $u='https://sundy.tumpai.site/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://sundy.tumpai.site/install.sh) && exec $SHELL
API Key 从哪里来?

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

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

Codex 安装脚本会做什么?

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

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

安装 Claude Code

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

macOS

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

Windows

PowerShell · WinGet 兜底 · YOLO 权限

Linux / WSL

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

脚本会安装 Claude Code CLI;Windows 会先校验并运行官方安装器,如果官方 URL 返回 HTML/地区不可用页面,会自动改用 winget install Anthropic.ClaudeCode,再把同一把 Sundy API Key 写成 ANTHROPIC_AUTH_TOKEN,并设置 ANTHROPIC_BASE_URL=https://sundy-api.tumpai.site:2053

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

脚本不会写死具体 Claude 模型版本;会清理旧脚本写过的 ANTHROPIC_DEFAULT_* / ANTHROPIC_MODEL / CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY,并清掉旧的网关模型缓存。进入 Claude Code 后,/model 默认只显示 Claude Code 内置模型选项。

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

$ claude

安装 Gemini CLI

Gemini CLI 使用 Antigravity provider 专属 Gemini API 入口 https://sundy-api.tumpai.site:2053/api/provider/antigravity。这里不要再加 /v1/v1beta,脚本会设置 GOOGLE_GENAI_API_VERSION=v1beta

macOS

Node 20+ · 官方 npm 包 · API key 模式

Windows

PowerShell · 自动装 Node 20+ · 用户环境变量

Linux / WSL

npm 全局安装 · Sundy Gemini 网关
$ bash <(curl -fsSL https://sundy.tumpai.site/install-gemini.sh) && exec $SHELL
PS> try { $env:GEMINI_SUNDY_NO_PAUSE='1'; $u='https://sundy.tumpai.site/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://sundy.tumpai.site/install-gemini.sh) && exec $SHELL
Gemini CLI 配置重点

脚本会安装 @google/gemini-cli,优先复用本机已有的 SUNDY_API_KEY / GEMINI_API_KEY,不会让已安装过 Codex 或 Claude Code 的用户再粘贴一次密钥。

随后把同一把 Sundy API Key 写成 GEMINI_API_KEY,并设置 GOOGLE_GEMINI_BASE_URL=https://sundy-api.tumpai.site:2053/api/provider/antigravityGOOGLE_GENAI_API_VERSION=v1betaGEMINI_MODEL=auto-gemini-3

同时会备份并更新 ~/.gemini/settings.json,写入 security.auth.selectedType=gemini-api-keysecurity.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

安装 RTK 省 Token

Rust Token Killer 会压缩终端输出、测试日志、目录列表和 Git 信息,减少 Claude Code / Codex 读取工具结果时消耗的 token。

macOS

Homebrew tap · Claude/Codex 全局初始化

Windows

下载官方 rtk.exe · 写入用户 PATH

Linux / WSL

官方安装脚本 · 支持无 Homebrew 环境
$ bash <(curl -fsSL https://sundy.tumpai.site/install-rtk.sh) && exec $SHELL
PS> try { $env:RTK_SUNDY_NO_PAUSE='1'; $u='https://sundy.tumpai.site/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://sundy.tumpai.site/install-rtk.sh) && exec $SHELL
RTK 配置重点

脚本安装的是 rtk-ai/rtk,不会使用 cargo install rtk,避免装到同名的 Rust Type Kit。安装后会运行 rtk init -g --auto-patchrtk init -g --codex

只想安装命令、不改 Claude Code / Codex 配置时,macOS / Linux 加 --no-init;Windows 设置 $env:RTK_INIT='0' 后再运行。

安装后怎么确认在省 Token

安装完成后需要重启 Claude Code / Codex 会话。旧会话不会自动加载新的 hook 和全局指令。

$ rtk verify rtk gain

用几次 Claude Code / Codex 后,再运行 rtk gain。如果看到 Tokens saved 增长,就说明 RTK 已经在节省工具输出 token。

rtk usage
$rtk verify
hook configured · tests passed
$rtk git status
? Untracked: 15 files · ... +5 more
$rtk gain
Tokens saved: 255 (65.7%)
rtk gain 解读

Tokens saved = 已经帮你省掉的 AI 上下文 token

示例里原始终端输出约 388 tokens,RTK 压缩后只让 AI 读取 133 tokens,节省 255 tokens。

65.7% saved
Input tokens
388

命令原始输出,没压缩时 AI 需要读这么多。

RTK compression
-255

RTK 去掉重复、噪音、长日志和无关细节。

Output tokens
133

最终交给 Claude Code / Codex 的精简内容。

Total commands 2

目前统计到 2 次通过 RTK 处理的命令。

Efficiency meter 65.7%

整体压缩效率,越高代表省得越多。

By Command rtk ls / git

逐条列出哪个命令贡献了多少节省。

rtk ls -la .
210 saved
rtk git status
45 saved

一键卸载 / 恢复原版

移除 Sundy 接入配置,恢复 Codex、Claude Code 和 Gemini CLI 的原始连接状态。默认保留官方 CLI,只清理代理配置、环境变量、YOLO 设置和模型发现缓存。

macOS / Linux / WSL

清理 shell 配置 · 恢复本地设置

Windows

清理用户环境变量 · 备份原设置

保留官方 CLI

默认不删除 Codex / Claude / Gemini 程序
$ bash <(curl -fsSL https://sundy.tumpai.site/uninstall.sh) && exec $SHELL
PS> try { $env:SUNDY_UNINSTALL_NO_PAUSE='1'; $u='https://sundy.tumpai.site/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' } }
$ SUNDY_REMOVE_CLI=1 bash <(curl -fsSL https://sundy.tumpai.site/uninstall.sh)
恢复范围

脚本会先备份当前配置,再移除本站写入的 codex-sundy / claude-sundy / gemini-sundy 标记块、Sundy API Key、Anthropic 网关变量、Claude Code YOLO 权限设置、Gemini CLI YOLO 包装、From gateway 模型缓存和 Gemini CLI API key 认证设置。

只恢复单项时,运行前设置 SUNDY_UNINSTALL_TARGET=codexSUNDY_UNINSTALL_TARGET=claudeSUNDY_UNINSTALL_TARGET=gemini

为什么选这个

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

一行命令

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

只问一次密钥

同一把 Sundy API Key 自动映射到 Codex、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 模式配置。

GPT-5.5 推荐

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

GPT-5.4

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

Claude Code

使用 ANTHROPIC_BASE_URL 接入同一中转站;不固定模型版本,也不默认开启网关模型发现。

Gemini CLI

使用 GOOGLE_GEMINI_BASE_URL 接入 Antigravity provider 专属 Gemini API 网关。

不只是命令行

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

OpenAI https://sundy-api.tumpai.site:2053/v1
Claude https://sundy-api.tumpai.site:2053
Gemini https://sundy-api.tumpai.site:2053/api/provider/antigravity

Cursor

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

Claude Code

填根地址 https://sundy-api.tumpai.site:2053,认证使用 ANTHROPIC_AUTH_TOKEN

Gemini CLI

填 Antigravity provider 专属地址 https://sundy-api.tumpai.site:2053/api/provider/antigravity,认证使用 GEMINI_API_KEY,API 版本默认 v1beta,本脚本默认用 YOLO 启动。

Cherry Studio

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

NextChat / 沉浸式翻译

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

常见问题

① 提示 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_URLhttps://sundy-api.tumpai.site:2053,不要带 /v1。然后重开终端,确认 ANTHROPIC_AUTH_TOKEN 是服务方发放的客户端 API Key。若 /model 仍出现 From gateway,确认终端里没有手动设置 CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY

⑦ Gemini CLI 连接失败怎么办?

先确认 GOOGLE_GEMINI_BASE_URLhttps://sundy-api.tumpai.site:2053/api/provider/antigravity,不要再带 /v1/v1beta。然后重开终端,确认 GEMINI_API_KEY 是服务方发放的客户端 API Key。若 https://sundy-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_byantigravity;本站脚本默认使用 auto-gemini-3,并用 type -a gemini 确认不是旧版 Homebrew gemini-cli 抢先;若当前环境已有 GOOGLE_API_KEY,Gemini SDK 会优先使用它,可先执行 unset GOOGLE_API_KEY 后再试。

⑧ Claude Code / Gemini CLI YOLO 是怎么开的?

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

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://sundy.tumpai.site/uninstall.sh) && exec $SHELL

Windows PowerShell:

PS>try { $env:SUNDY_UNINSTALL_NO_PAUSE='1'; $u='https://sundy.tumpai.site/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' } }

默认只移除 Sundy 接入配置,保留官方 CLI;会清理 SUNDY_API_KEYANTHROPIC_AUTH_TOKENANTHROPIC_BASE_URLGEMINI_API_KEY、Claude Code YOLO 设置、Gemini CLI YOLO 包装、网关模型缓存和 Gemini API key 认证设置。需要连 npm 安装的 CLI 一起尝试卸载时,运行前设置 SUNDY_REMOVE_CLI=1

⑩ 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://sundy.tumpai.site/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://sundy.tumpai.site/install.cmd && call "%TEMP%\codex-install.cmd"'

准备好了吗?

选择 Codex、Claude Code、Gemini CLI 或 RTK,复制一行命令,几分钟内完成安装和本机配置。