安装
桌面客户端（推荐）
fate 桌面版支持 macOS 13 及以上。下载安装后，用自己的 ChatGPT、Claude 会员或 API Key 连接模型服务。
版本 0.1.0 · macOS 13 及以上
打开苹果菜单中的“关于本机”：芯片显示 Apple 时选择 Apple 芯片版，处理器显示 Intel 时选择 Intel 版。
ZIP 是备选格式，解压后同样将 fate.app 放入“应用程序”。
Windows 版即将推出
- 下载对应芯片的 DMG，打开后将 fate.app 拖到“应用程序”。
- 打开 fate，点击“登录或注册”，在浏览器用 Google 或邮箱验证码登录并同意；回到桌面窗口。可取消等待后重新开始。
首次打开
首发安装包尚未经过 Apple 公证，macOS 可能拦截首次打开。确认下载来自 fate 官网后，到“系统设置 > 隐私与安全性”选择“仍要打开”。
也可对已从官网下载并放入“应用程序”的 fate 执行以下命令，再重新打开：
$ xattr -dr com.apple.quarantine /Applications/fate.app登录并连接模型
先安装 fate，再登录 fate 账号。模型会员与 fate 方案是两套独立账户与费用。
- 打开 fate，点击“登录或注册”，在浏览器用 Google 或邮箱验证码登录并同意；回到桌面窗口。可取消等待后重新开始。
- 在引导卡或“设置 > 账户与模型”选择自己的 ChatGPT、Claude 会员，或填写支持平台的 API Key。
- 会员通道按下方官方说明安装对应 CLI，然后在 fate 内完成会员登录。API Key 不需要 CLI，按模型平台用量计费。
会员通道的官方安装说明
安装的是模型服务的官方工具。安装完成后回到 fate 登录；无需在终端启动 fate。
找不到 CLI 或版本无法确认
- 打开“设置 > 诊断”，查看“官方命令行”的路径与版本；安装或更新官方工具后点击“重新检测”。
- 仍找不到时，选择已安装的 codex 或 claude 可执行文件。取消文件选择不改变配置；清除自选路径后恢复自动查找。
- 显式选中的路径失效时，修正或清除该路径。新增模型通道后，原模型选择保留；需要时从输入框模型选择器切换。
模型连接失败
- 先检查模型账户登录、额度和网络。在“设置 > 诊断 > 模型网络”选择系统、直连、自定义 HTTP/HTTPS 代理或从终端导入。
- 自定义代理的地址、用户名与密码分别填写。提示当前代理不可用时，改为有效 HTTP/HTTPS 代理或可用直连，再重试。
- 阅读或登录尚未完成时，先完成或取消，再改模型配置。失败时保留旧有效设置；不会自动切换模型或计费来源。
更新 fate
fate 会在后台检查和下载更新，并在退出时安装。也可从本页取得对应芯片的安装包；官方模型 CLI 按各自官方说明更新。
快速开始