Ofox Desktop 怎么用?把常用 AI 工具接入同一个账户
从安装 Ofox Desktop 开始,了解支持的六款工具,完成账户连接、模型选择与首次请求核对,再逐个接入常用客户端。适用于 Apple Silicon Mac。
Ofox Desktop 可以帮助你把支持的 AI 工具与 Agent 接入同一个 Ofox 账户。 在兼容的 Mac 上安装 Desktop、连接账户,选中已经安装的客户端和适用模型,再发出一条简短请求,核对成功后继续接入其他工具。
如果你平时会切换几款编程工具,这篇指南适合用来整理接入过程。写代码仍然在各自的客户端中完成,Desktop 负责官方产品页介绍的接入配置。
本文依据官方资料整理,核对日期为 2026 年 9 月 18 日;不是六款工具的实机测试报告,也不代表所有模型与客户端组合都经过兼容性验证。
支持哪些工具?先从你已有的工具开始
Desktop 页面目前列出以下六款工具。不需要为了跟随教程,一次把它们全部安装。
| 官方列出的工具 | 需要具体配置帮助时看哪里 |
|---|---|
| Claude Code | Claude Code 接入文档 |
| Codex | Codex 接入文档;先分清自己使用的是 CLI 还是桌面版 |
| Gemini CLI | Gemini CLI 接入文档 |
| OpenCode | OpenCode 接入文档 |
| OpenClaw | OpenClaw 接入文档 |
| Hermes | 先查看 Desktop 实际检测到的条目,再到接入文档目录查找当前说明 |
“在支持名单中”不等于所有版本、模型和工具调用功能都能直接通用。尤其是 Codex,不能看到这个名称,就默认 CLI 与桌面版使用完全相同的配置方式。
安装前准备什么?
截至本次核对,官方下载页提供 Ofox Desktop 1.3.2,适用于 Apple Silicon 芯片、macOS 12 及以上的 Mac,目前没有提供 Windows 或 Intel Mac 安装包。下载时以该页面的当前版本为准,不必收藏带固定版本号的安装包地址。
准备好 Ofox 账户,并先安装你要接入的编程客户端。Desktop 可免费下载,模型调用另计费;请求前查看所选模型的当前收费说明和账户余额。
第一次接入建议使用空的测试目录,不直接操作业务项目。如果你已有其他服务商的配置,先记下需要保留的设置。官方页面说明 Desktop 支持自动备份配置,并为各工具分配独立 API Key;继续改动前,先确认能找到 Desktop 生成的配置备份。
接入第一款工具
1. 下载并打开 Desktop
从官方下载页获取安装包,安装后打开应用。已经安装的用户直接打开现有应用并查看版本即可,不需要为了增加另一款工具重新安装 Desktop。
2. 连接 Ofox 账户
按照应用中的账户连接流程操作。还没有账户,可以先注册 Ofox。稍后核对请求明细时,确认查看的是同一个账户。
登录成功和模型请求成功是两件事。完成登录,只能说明账户连接这一步完成,不能据此判断编程客户端已经使用了预期配置。
3. 选择已检测到的客户端和模型
选中你已经安装的客户端,为它选择适用模型,再应用配置。先接入一款工具,出现错误时更容易定位原因。官方页面介绍了自动检测能力;如果没有找到工具,先核对安装情况和对应接入文档,不要同时改动多套配置。
模型选择也要结合实际任务。除了文本生成,你的编程流程可能还需要工具调用等能力。验证第一次连接时,先保持模型不变,避免一边排查连接一边反复切换模型。
4. 在客户端发出一条简短请求
在所选客户端中打开新的测试会话,使用准备好的空目录。可以输入下面这条提示词:
Reply with exactly: OFOX_CONNECTION_CHECK.
Do not read files, run commands, or use tools.
预期文本是 OFOX_CONNECTION_CHECK。这是测试目标,不是本文采集到的真实输出。记下请求的大致时间和所选模型;如果失败,先保留错误信息并排查,再决定是否重试。
5. 到 Ofox 后台核对请求
打开 Ofox 后台,查找时间、模型相符的请求。有对应 Key 信息时,用它区分不同客户端的活动,同时查看状态与实际费用。
只看到回复还不够:旧会话或已有配置可能仍在使用其他服务商。反过来,后台出现请求但客户端没有得到可用回复,也不能算测试完成。找不到匹配记录时,先标记为“待验证”,继续核对客户端实际启用的配置。
再接入第二款工具
第一款工具的回复与请求记录能对应上之后,再重复上述流程,接入第二款。例如,你本来就使用 Claude Code 和 OpenCode,可以分别配置、分别核对。
接入时可以保留一张简单的记录表:
| 客户端及版本 | 所选模型 | 请求时间 | 对应 Ofox 记录 | 结论 |
|---|---|---|---|---|
| 第一款客户端 | 选择后填写 | 发起后填写 | 找到/未找到 | 已验证/待排查 |
| 第二款客户端 | 选择后填写 | 发起后填写 | 找到/未找到 | 已验证/待排查 |
短文本测试只能检查文本请求。正式用于开发前,再选一个不含敏感资料的小任务,明确完成标准,单独检查文件修改和工具执行。文本能回复,不代表完整编程流程已经通过验证。
遇到问题,先查哪一步?
| 现象 | 下一步检查 |
|---|---|
| 没有检测到客户端 | 是否已安装、是否在支持范围内,再查对应客户端文档 |
| 认证失败 | 核对账户连接和实际启用的配置;不要在求助信息中贴出 API Key |
| 选中的模型无法使用 | 核对准确模型、账户访问情况及客户端所需能力 |
| 有回复,但找不到对应 Ofox 请求 | 核对后台账户、请求时间和实际启用的服务商配置 |
| 文本能回复,编程任务失败 | 根据错误检查任务所需能力,不把文本连通当成工具调用验证 |
| 想切回原来的配置 | 按 Desktop 的配置备份与恢复流程操作,恢复后再核对客户端设置 |
各款工具的具体配置,以对应技术文档为准,避免把两款客户端的步骤混用。需要求助时,提供工具版本、所选模型、发生时间和脱敏后的错误信息。
从你常用的工具开始
前往 Ofox Desktop 下载页,先连接一款支持的工具,核对第一次请求,再逐个加入其他常用工具。每款工具保留自己的验证记录,后续排查会更清楚。
常见问题
- Ofox Desktop 支持哪些工具?
- 官方页面目前列出 Claude Code、Codex、Gemini CLI、OpenCode、OpenClaw 和 Hermes。应用配置前,应核对实际检测到的客户端及其版本。
- Desktop 免费下载,模型调用也免费吗?
- 不是。客户端下载免费,模型请求使用 Ofox 账户,按适用模型价格另行计费。
- Windows 和 Intel Mac 能安装吗?
- 本文核对的下载页提供 macOS 12 及以上的 Apple Silicon 安装包,目前未提供 Windows 或 Intel Mac 安装包。


