跳到主要内容

WeyAi 桌面端使用指南

WeyAi 是SensureAi提供的桌面客户端。它把 Claude Code、Codex、Gemini CLI 等 AI 编程工具集中到一个桌面界面中,也可以在系统终端里继续使用这些 CLI。客户端会为当前账号管理连接凭据、分组和模型,用户不需要手工填写中转地址或 API Key。

支持的平台​

  • Windows 10 及以上
  • macOS 10.15 及以上
  • Linux(Ubuntu 18.04、Debian 10、Fedora 32 及以上)
  • 建议至少 4 GB 内存,并预留 500 MB 可用空间;安装 CLI 后还需要额外磁盘空间

快速开始​

  1. 安装并打开 WeyAi,点击「个人登录」或「企业登录」,在浏览器中完成授权。
  2. 登录后打开左侧「Agents」,在「可安装」中找到 Claude Code、Codex 或 Gemini CLI。
  3. 点击「安装」,确认客户端将要修改的配置文件,等待下载、校验、解压和配置完成。
  4. 点击 Agent 卡片上的「开始对话」,即可在 WeyAi 内使用;也可以重新打开终端后输入 claude、codex 或 gemini。

客户端安装或接管 CLI 后,会自动配置账号连接和默认模型。终端使用同一套 WeyAi 账号额度,不需要再次登录厂商账号。

登录和账号范围​

WeyAi 支持个人账号和企业账号。登录后,模型权限、分组、余额和用量归属于当前账号范围。个人与企业之间切换时,需要先退出当前账号,再选择另一种登录方式;两种范围的对话和配置分开保存。

在「账号 → WeyAi 账号」中可以查看:

  • 当前个人或企业身份与企业名称
  • 可用余额或额度
  • 当前设备凭据的末 4 位
  • 每个 CLI 使用的分组和模型
  • 刷新账号状态、重新生成设备凭据和退出登录

客户端界面只显示凭据末 4 位。怀疑凭据泄露时,可以在账号页重新生成,已接入的 CLI 会自动同步新凭据。

安装和接管 CLI​

一键安装​

在「Agents → 可安装」中选择 Agent,点击「安装并接管配置」。确认框会列出:

  • 将要修改的 CLI 配置文件
  • 修改配置的原因(让 CLI 使用 WeyAi 账号计费)
  • 如何恢复原始配置

安装完成后,Agent 会移动到「已就绪」,卡片会显示「已接管配置 · WeyAi 账号」。客户端会将自己的命令目录加入 PATH;PATH 变化只对新开的终端生效。

接管已安装的 CLI​

如果本机已经安装 Claude Code、Codex 或 Gemini CLI,WeyAi 会检测现有版本并提供「接管配置」。接管不会重复下载 CLI,只会把连接配置切换到 WeyAi。该 CLI 的版本升级仍由原安装方式负责。

其它 Agent​

「其它 Agent」中的工具需要用户自行安装和登录。WeyAi 可以尝试测试连接,但不会替这些 Agent 管理厂商账号、凭据或费用。

在客户端和终端中使用​

安装完成后,可以在 Agent 卡片点击「开始对话」,也可以在新开的终端输入:

claude      # Claude Code
codex # Codex
gemini # Gemini CLI

如果终端提示找不到命令,先关闭旧终端并重新打开。VS Code 等编辑器的内置终端通常需要重启整个编辑器,才能读到新的 PATH。

只有在客户端提示无法自动加入 PATH 时,才需要手动加入:

  • Windows:在用户环境变量的 Path 中新增客户端提示的命令目录。
  • macOS/Linux:在 ~/.zshrc 或 ~/.bashrc 中追加 export PATH="$PATH:<客户端命令目录>",保存后重新打开终端。

分组和模型配置​

默认情况下,CLI 使用账号默认分组和默认模型。为某个 CLI 指定配置时:

  1. 在 Agents 卡片点击「模型配置」或「更换」。
  2. 选择分组;分组后的倍率代表相对价格,标记为「自动」的分组由平台按请求选择。
  3. 选择该分组允许使用的模型。
  4. 保存,之后新开的 CLI 会话使用新配置。

账号页的「已配置的智能体」可以查看每个 CLI 当前使用的分组和模型。点击「恢复默认」即可让单个 CLI 跟随账号默认配置;「全部重置」可以一次恢复全部 CLI。

模型列表按账号、分组和权限过滤。如果看不到某个模型,请先更换分组,再确认账号权限和企业策略;不要手工修改客户端托管的接口地址来绕过模型权限。

配置管理和恢复​

在 Agent 卡片的「配置」面板中可以:

  • 测试连接并查看耗时
  • 查看已脱敏的原始配置文件
  • 打开配置文件所在目录
  • 恢复接管前的原始配置
  • 查看版本、安装路径和诊断信息

客户端只管理账号连接相关字段,会保留用户自己添加的其它配置。首次修改前会在原文件旁创建 .weyai-backup 备份。

常见配置位置包括:

工具配置位置
Claude Code~/.claude/settings.json、~/.claude.json
Codex~/.codex/config.toml、~/.codex/auth.json
Gemini CLI~/.gemini/.env、~/.gemini/settings.json

点击「恢复原始配置」后,CLI 会回到接管前的厂商登录或自定义配置,WeyAi 不再自动同步该 CLI,之后可以再次点击「接管配置」。

更新、回退和卸载​

Agent 卡片右侧的菜单提供更新、回退上一版本、卸载、打开安装目录和诊断。更新不会删除已有对话;卸载客户端安装的 CLI 时,会按确认框提示删除程序并恢复配置文件。用户自行安装的 CLI 由用户自己升级和卸载。

安装位置通常为:

  • Windows:%LOCALAPPDATA%\WeyAi\agents
  • macOS/Linux:~/.weyai/agents

退出登录和凭据失效​

账号凭据失效、余额不足、企业名额达到上限或同步失败时,Agents 卡片会显示「凭据失效,点击刷新」。先在账号页刷新,仍然失败时检查余额、企业权限或联系管理员。

退出登录会清除 CLI 中由 WeyAi 管理的凭据,并恢复接管前的配置;客户端安装的 CLI 程序会保留。重新登录后,已接管的 CLI 可以再次自动配置。

常见问题​

现象处理方法
终端找不到 claude、codex 或 gemini关闭旧终端并重新打开;仍失败时按卡片提示手动加入 PATH。
Agent 显示不可用登录账号页并点击刷新,确认账号已获得模型中转凭据。
模型配置中找不到目标模型更换分组;模型可见性由账号和企业权限决定。
使用其它供应商切换工具后配置被改回在 WeyAi 配置面板恢复原始配置,或让 WeyAi 重新同步托管配置。
想恢复原来的厂商账号在配置面板点击「恢复原始配置」,不要直接删除配置文件。
需要反馈问题从 Agent 菜单或「系统 → CLI Agent」复制诊断信息;诊断信息不包含完整密钥。