GPTZZZ 客户端下载
macOS 与 Windows
GPTZZZ 客户端用来给 Claude Code、Codex、小龙虾、爱马仕、Grok 切换供应商。 登录 GPTZZZ 账号后，它把 GPTZZZ 写入供应商列表，不再自动切换；要用时在客户端里手动切换，原配置可一键恢复。
先双击打开一次，再到“系统设置” → “隐私与安全性”，向下滚动点“仍要打开”，再确认“打开”（macOS 12 及更早：“系统偏好设置” → “安全性与隐私” → “通用” → “仍要打开”）。应用未做苹果签名，“仍要打开”按钮在尝试打开后一小时内可用。
Windows 弹出 SmartScreen 提示？
应用未做代码签名，SmartScreen 会对没有信誉记录的新程序给出警告。先按下文核对 SHA256，确认文件无误后再选择继续运行。
浏览器（Chrome / Edge）提示“可能有害”或“不常下载”？
在浏览器的下载列表里选择“保留”。安装包没有代码签名，新版本刚发布、下载记录还少时浏览器会这样提示；按下文核对 SHA256 即可确认文件无误。
全部安装包
安装与第一次打开
4.0 没有做 Apple / Windows 代码签名，第一次打开时系统会拦一下。按你的系统放行一次即可，之后的版本在应用内自动更新。
选安装包
GPTZZZ-v…-macOS.dmg
GPTZZZ-v…-Windows-x64-Setup.exe
GPTZZZ-v…-Windows-arm64-Setup.exe
- ARM 电脑也能运行 x64 版（系统会转译），但更慢、更费电，请优先用 ARM64 版。
- x64 电脑不能运行 ARM64 版，装错时会提示“此应用无法在你的电脑上运行”，换 x64 版即可。
不再提供 Linux 版本，不支持 32 位 Windows。只从 gptzzz.ai 下载：安装包没有代码签名，系统无法替你确认来源， 别人转发、网盘里的安装包不要用。想确认文件完整，按核对 SHA256比对哈希值。
macOS：安装与第一次打开macOS 12+
-
双击
.dmg，在弹出的窗口里把 GPTZZZ.ai 拖到应用程序文件夹，然后推出 DMG。 - 从「应用程序」里打开它，不要直接在 DMG 窗口里运行（那样无法自动更新）。第一次打开时系统会提示无法验证开发者或无法检查恶意软件，按下面你的系统版本放行一次。
不知道系统版本：点左上角苹果菜单 →「关于本机」。
macOS 15 Sequoia 及更新版本（包括 macOS 26）
- 在「应用程序」里双击 GPTZZZ.ai。系统提示“未打开”“Apple 无法验证…是否包含恶意软件”时，点完成。不要点「移到废纸篓」。
- 打开系统设置→ 左侧隐私与安全性，向下滚动到「安全性」部分，会看到 GPTZZZ.ai 已被阻止的提示，点它右边的仍要打开。
- 系统再弹一次确认框，点仍要打开，按要求输入登录密码（或用触控 ID）。
- GPTZZZ.ai 启动。以后直接双击即可，不会再问。
macOS 13 Ventura、14 Sonoma
方法一（最快）
- 在 Finder 的「应用程序」里，按住 Control 键点按 GPTZZZ.ai（也可以右键点按，或触控板双指轻点）。
- 在菜单里选打开。
- 弹窗问是否确定打开，点打开。以后直接双击即可。
方法二
- 先双击 GPTZZZ.ai，提示无法打开时点「好」或「取消」关掉（不要点「移到废纸篓」）。
- 打开系统设置→隐私与安全性，向下滚动到「安全性」，点 GPTZZZ.ai 那一行的仍要打开。
- 弹窗里点打开，如有要求输入登录密码。
macOS 12 Monterey
方法一与 macOS 13、14 相同：按住 Control 键点按（或右键点按）GPTZZZ.ai →打开→ 弹窗里再点打开。
方法二
- 先双击 GPTZZZ.ai，提示无法打开时关掉提示。
- 打开系统偏好设置→安全性与隐私→通用标签页。
- 如果下方的按钮是灰色的，先点窗口左下角的锁形图标并输入登录密码。
- 点 GPTZZZ.ai 那一行的仍要打开，弹窗里点打开。
高级：用终端解除隔离
只在上面的方法都不行、或者提示“已损坏，无法打开”时使用，并且先核对过 SHA256、确认文件来自 gptzzz.ai。打开「终端」，执行：
xattr -dr com.apple.quarantine /Applications/GPTZZZ.ai.app
然后双击打开。这条命令只去掉这一个应用的“从网上下载”标记，不会关闭系统的安全检查。不要照网上的说法执行
sudo spctl --master-disable，那会对所有应用关掉这项保护。
Windows：安装Windows 10 / 11
- 浏览器拦下载时：有的浏览器会提示这个文件“不常下载”或“可能有害”，在浏览器的下载列表里选择保留。Edge 是点文件右边的…→保留→ 展开显示更多→仍然保留；Chrome 是在下载列表里选保留。
-
双击 Setup.exe。如果出现蓝色窗口“Windows 已保护你的电脑”：
- 点窗口里的文字链接更多信息；
- 下方出现仍要运行按钮（发布者显示为“未知发布者”，因为没有代码签名），点它。
- 安装器会自动完成，不需要管理员权限，也不用选目录；装好后 GPTZZZ.ai 自动启动，并在桌面和开始菜单放上快捷方式。
这是 Windows 11 的「智能应用控制」，它会直接拦下所有没有签名的程序，不能对单个程序放行。可以换一台没有开启这项功能的电脑使用，或者自行决定关闭它：设置→隐私和安全性→Windows 安全中心→应用和浏览器控制→智能应用控制设置选「关闭」。注意在部分 Windows 版本上关闭后不能直接再打开（需要重置系统），请自己权衡。
Windows 免安装版（Portable.zip）
-
先完整解压再运行：右键 zip →「全部解压缩…」，不要在压缩包预览窗口里直接双击
GPTZZZ.exe。解压后得到GPTZZZ.ai文件夹，放到你有写入权限的位置（例如D:\Tools\GPTZZZ.ai），运行其中的GPTZZZ.exe。 - 第一次运行同样可能出现“Windows 已保护你的电脑”，按上面的步骤处理。也可以在解压之前右键 zip →「属性」→ 在「常规」页底部勾选解除锁定→「确定」，再解压。
- 不要删除文件夹里的
portable.ini，有它才是免安装版。 - 不会自动更新：有新版本时，从托盘图标菜单选「退出」，下载新的 zip，用新文件夹替换旧的。
-
不设置开机自启，不注册
gptzzz://链接，没有开始菜单快捷方式；托盘的切换通知可能不显示。 - 浏览器登录（Google / GitHub）可能无法回到免安装版，尤其是电脑上同时装了安装版时。遇到这种情况请用邮箱和密码登录。
-
登录信息、设置和备份保存在
%LOCALAPPDATA%\GPTZZZ.ai，与安装版共用；删除免安装版的文件夹不会删除它们。 - 电脑上装着旧版 3.x 时，免安装版不会动它；要升级旧版请用安装版。
老用户升级（3.20.2 / 3.21.0 → 4.0）
- 老用户会自动升级。旧版客户端会陆续收到 4.0 的更新提示（分批推送，可能比别人晚几天），按提示更新即可。自动升级不经过浏览器下载，一般不会出现上面的系统拦截。
- 升级后需要重新登录一次，工具配置不受影响：Claude Code、Codex、Grok Build、OpenClaw（小龙虾）、Hermes（爱马仕）里正在用的设置不会被改动。
- 想马上升级也可以直接下载安装。Windows：运行新的 Setup.exe，它会自动卸载旧版 3.x；如果提示旧版未能自动卸载，到「设置 → 应用」里卸载名称为“GPTZZZ”或“GPTZZZ.ai”、版本为 3.x 的那一项。macOS：把新的 GPTZZZ.ai 拖进「应用程序」替换旧版；3.20.2 的应用名是 GPTZZZ，如果「应用程序」里同时有 GPTZZZ 和 GPTZZZ.ai，新版启动后会提示把旧的移到废纸篓，请照做，以免浏览器登录被旧版接收。
- Windows 上旧的任务栏固定图标会失效，重新固定一次即可。
- 以后的更新都在应用里完成：「设置 → 关于 → 检查更新」，或托盘菜单「检查更新…」。
常见问题
杀毒软件报毒，或者安装包被删掉了
没有代码签名的新程序容易被安全软件按“信誉不足”误报。请按这个顺序处理：
- 按核对 SHA256比对哈希值。对不上就删掉文件，重新从 gptzzz.ai 下载。
- 对得上，再从隔离区恢复并放行。Windows 安全中心：「病毒和威胁防护 → 保护历史记录」，点开这一条，在「操作」里选「还原」或「在设备上允许」（不同 Windows 版本的按钮名称略有差异）。360、火绒等：在隔离区（或“恢复区”）里恢复这个文件，并加入信任区。
- 不要为此整个关闭杀毒软件。欢迎把报毒软件名称、检测名称截图发到 Telegram 群里。
无法打开
macOS
- 提示“已损坏，无法打开”：先重新下载并核对 SHA256（下载不完整也会这样），再用上面的「高级：用终端解除隔离」。
- 误点了「移到废纸篓」：从废纸篓把 GPTZZZ.ai 放回「应用程序」（或重新下载），再按 macOS 的步骤放行。
- 双击后没有窗口：它可能已经在运行，点屏幕顶部菜单栏里的 GPTZZZ.ai 图标 →「打开主窗口」。另外确认系统是 macOS 12 或更高，并且是从「应用程序」打开的。
Windows
- 提示“此应用无法在你的电脑上运行”：下错了架构，x64 电脑请下载 x64 版。
- 双击后没有反应：先看任务栏右下角的托盘区（可能藏在「^」里），GPTZZZ.ai 可能已经在运行；再看是否被杀毒软件或「智能应用控制」拦截。
如何卸载
- macOS：点菜单栏的 GPTZZZ.ai 图标 →「退出」（或在应用里按 ⌘Q），然后在「应用程序」里把 GPTZZZ.ai 拖到废纸篓。如果「系统设置 → 通用 → 登录项」里还有 GPTZZZ.ai，手动移除。
- Windows 安装版：托盘图标 →「退出」，然后「设置 → 应用 → 已安装的应用」（Windows 10 是「应用和功能」），找到 GPTZZZ.ai →「卸载」。
- Windows 免安装版：托盘图标 →「退出」，删除整个文件夹。
-
彻底清除数据（可选）：删除
~/Library/Application Support/GPTZZZ.ai（macOS）或%LOCALAPPDATA%\GPTZZZ.ai（Windows）。这会同时删掉登录信息、设置和各工具原配置的备份，删除前请确认已经恢复好原配置。
如何恢复原配置
GPTZZZ.ai 每次改工具的配置文件之前都会先备份，随时可以改回去：
- Claude Code、Codex、Grok Build：在左侧「工具」里打开对应工具，点恢复原配置。也可以在托盘菜单里对应工具下选「恢复为你原本的配置」。
- OpenClaw（小龙虾）、Hermes（爱马仕）：GPTZZZ 是追加进配置里的，不会删除你原有的供应商。恢复原默认把默认模型改回原来的；从配置移除把 GPTZZZ 的条目全部删掉。
- 一次恢复全部：「设置 → 工具与数据」里的准备回退到旧版会把 Claude Code、Codex、Grok Build 恢复为你原本的配置，然后打开下载页。
-
手动找备份：「设置 → 工具与数据」里的打开备份文件夹。备份在
~/Library/Application Support/GPTZZZ.ai/backups/（macOS）或%LOCALAPPDATA%\GPTZZZ.ai\backups\（Windows），文件名带时间。 - 恢复后，正在运行的工具要重启才会读到新配置，应用会提示具体怎么做。
- 3.21.0 曾误删部分用户的原配置。4.0 会尝试从旧版备份里找回，找回的会标为「从备份找回」；较早升级的多数用户已经无法找回，这时「恢复」会回到该工具的官方登录方式。
English · Install guide (short)
GPTZZZ.ai 4.0 is not code-signed on macOS or Windows, so your system asks you to confirm the first launch. Download only from gptzzz.ai, and check the SHA-256 on this page if in doubt.
Which file? Mac (Apple silicon or Intel, macOS 12+): …-macOS.dmg. Windows
10/11 x64 (most PCs): …-Windows-x64-Setup.exe. Windows on ARM (e.g. Snapdragon):
…-Windows-arm64-Setup.exe. No install rights: the matching
Portable.zip. To check, open Settings → System → About → System type (“x64-based”
or “ARM-based processor”). Linux and 32-bit Windows are no longer supported.
macOS first launch. Drag GPTZZZ.ai into Applications and open it from there.
- macOS 15 Sequoia and later: double-click, click Done (not Move to Trash), then System Settings → Privacy & Security → scroll to Security → Open Anyway → confirm Open Anyway and enter your password. Control-click → Open no longer works on macOS 15.
- macOS 13–14: Control-click (or right-click) the app → Open → Open. Or use System Settings → Privacy & Security → Open Anyway.
- macOS 12: Control-click → Open → Open, or System Preferences → Security & Privacy → General → Open Anyway (click the lock first if the button is greyed out).
-
Advanced, only if the above fails or macOS says the app is “damaged”:
xattr -dr com.apple.quarantine /Applications/GPTZZZ.ai.app. Never runsudo spctl --master-disable.
Windows. If “Windows protected your PC” appears, click More info → Run anyway. If your browser warns about the download, choose Keep. If Smart App Control blocks the app there is no per-app override; turning Smart App Control off is your call (on some Windows versions it cannot simply be turned back on).
Portable zip. Extract the whole zip first (don’t run from inside it) and keep
portable.ini next to GPTZZZ.exe. It doesn’t auto-update, change
login items or register gptzzz:// links; browser sign-in may not return to it, so
use email and password. Data lives in %LOCALAPPDATA%\GPTZZZ.ai, shared with the
installed version.
Existing users (3.20.2 / 3.21.0) are upgraded automatically. Sign in once after the update; your tool configurations are not affected. Re-pin the app to the Windows taskbar.
FAQ. Antivirus flagged it: verify the SHA-256, then restore it from quarantine and allow it. Uninstall: quit from the tray / menu bar, then delete the app (macOS) or use Settings → Apps (Windows); restore your original tool configs before uninstalling. Restore original configs: open the tool and click Restore original (Claude Code, Codex, Grok Build) or Restore previous default / Remove from config (OpenClaw, Hermes); backups are in Settings → Tools & Data → Open backups folder.
安装遇到问题，可以在 Telegram 群里问。
客户端会改哪些配置、怎么恢复
简要说明（详细步骤见上方安装指南 · 常见问题）：
- 登录后只写入供应商列表，不再自动切换到 GPTZZZ。
- 要用 GPTZZZ 时，在客户端里手动切换。
- 想回到原来的设置，在客户端里一键恢复原配置。
- 只开放 Claude Code、Codex、小龙虾、爱马仕、Grok 这 5 个工具。
4.0 每次改工具的配置文件之前都会先备份，文件名带时间：macOS 在 ~/Library/Application Support/GPTZZZ.ai/backups/，Windows 在 %LOCALAPPDATA%\GPTZZZ.ai\backups\。客户端里「设置 → 工具与数据 → 打开备份文件夹」可以直接打开。
系统要求：选哪个安装包
- macOS（macOS 12 及以上）：一个 .dmg 通用安装包，Apple 芯片和 Intel 芯片的 Mac 都能用。
- Windows x64（Windows 10 / 11，大多数电脑）：Setup.exe 安装版（推荐）；或 Portable .zip 免安装版，解压即用，无需管理员权限。
- Windows ARM64（骁龙等 ARM 芯片电脑）：Setup.exe 安装版（推荐），或 Portable .zip 免安装版，解压即用。
- v4.0.1 没有 Linux 版本，也不支持 32 位 Windows。
不确定 Windows 电脑是 x64 还是 ARM：打开“设置” → “系统” → “关于”，在“设备规格”里看处理器类型。
安装包没有代码签名，第一次打开时系统会拦一下，按上方安装指南放行即可。
下载后核对 SHA256
每个安装包的 SHA256 如下：
ce3c86bb434c45dff4138fa8a40346f5b501cbcb7cd694dc4dc5884f9aaacce8 GPTZZZ-v4.0.1-Windows-x64-Setup.exe
096314a56472d4332cbbe227bff45c4a5ed89ba11daced546c4a2df25c3fd854 GPTZZZ-v4.0.1-Windows-Portable.zip
b8e8698d8763120f9ace84317327e3609ce8bfacbe458753bc0d8292b79e5037 GPTZZZ-v4.0.1-Windows-arm64-Setup.exe
47a802d57c15e77c3000410254183490bf01123cddf17f5d36a8093c516dc3e5 GPTZZZ-v4.0.1-Windows-arm64-Portable.zip
b7f46d16026c4742c2f3465de7db366ea5bd9dce029dfc6b59ced28c567e0c72 在下载目录执行下面的命令，把文件名换成你下载的那个，输出要和上面对应的值一致：
shasum -a 256 GPTZZZ-v4.0.1-macOS.dmgWindows PowerShell：
Get-FileHash .\GPTZZZ-v4.0.1-Windows-x64-Setup.exe | Format-ListGet-FileHash 默认算法就是 SHA256，Hash 一行是大写字母，和上面的小写值逐位比对即可，大小写不算差异。对不上就删掉文件，重新下载。
v4.0.1 更新内容（2026-10-12）
- 修复账号密码无法登录：改为在内嵌的官方登录页登录，支持人机验证与两步验证。
- 切换后自动重启 Codex / Claude 桌面版，不用再手动重启。
- 配置自动同步：密钥、模型有变化时自动更新到各工具，保留你选的模型。
v4.0.0（2026-10-12）：
- GPTZZZ.ai 4.0：全新架构，更快更稳。
- 老用户会自动收到更新；更新后需要重新登录一次，你的工具配置不受影响。
- 旧的任务栏固定图标会失效，请重新固定；不再支持 Linux。
- 3.21.0 曾误删部分用户的原配置，新版会尝试从备份找回，但多数较早升级的用户无法找回。
历史版本
只在 4.0 无法使用、需要回退时才下载旧版。回退前先在 4.0 的「设置 → 工具与数据 → 准备回退到旧版」执行一次；回退后需要重新登录。
下载之后
GPTZZZ 是独立的第三方 AI API 中转服务，与各模型厂商没有隶属关系。