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 后还需要额外磁盘空间
快速开始
- 安装并打开 WeyAi,点击「个人登录」或「企业登录」,在浏览器中完成授权。
- 登录后打开左侧「Agents」,在「可安装」中找到 Claude Code、Codex 或 Gemini CLI。
- 点击「安装」,确认客户端将要修改的配置文件,等待下载、校验、解压和配置完成。
- 点击 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 指定配置时:
- 在 Agents 卡片点击「模型配置」或「更换」。
- 选择分组;分组后的倍率代表相对价格,标记为「自动」的分组由平台按请求选择。
- 选择该分组允许使用的模型。
- 保存,之后新开的 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」复制诊断信息;诊断信息不包含完整密钥。 |