常见问题

本页汇总 Aichat 使用中的高频问题。如果你不确定问题属于哪一类，可以先从这里查。

下载与安装

请先查看下载与安装。Aichat 当前通过官方下载源分发安装包，下载清单是 https://desktop.94168168.xyz/aichat/latest.json。不要从不明来源下载安装文件。

先确认安装包来源可靠，再到系统设置中允许打开。不要为了打开未知来源安装包而绕过系统安全保护。

通常表示客户端缺少必要的本地资源，或本地后端没有正常启动。请先重启客户端；如果仍失败，从官方入口重新下载安装最新版。

检查 Key 是否复制完整，前后不要多空格或换行。确认网络正常后重新绑定。如果仍失败，联系提供方确认 Key 状态。

先重新同步模型，等待几秒后再查看模型下拉框。如果仍没有出现，重启客户端，并确认你的 License 是否包含该模型。

如果客户端提供解绑入口，可以先在旧设备解绑，再到新设备绑定。如果旧设备无法使用，需要联系提供方处理。

可以。Aichat 默认提供内置 Aichat CLI，适合新用户和没有外部 CLI 的设备。

可能是 Codex / ChatGPT CLI 没安装、没有登录、不在系统 PATH 中，或当前客户端无法识别它。你可以先使用 Aichat CLI，也可以在本地 Agent 页面使用安装、修复或智能识别入口。

关闭统一模型渠道后，外部 CLI 会尽量使用自己的账号和模型配置。不同 CLI 官方模型名称、可见范围和账号权限可能不同，所以显示结果可能和 Aichat 的模型列表不同。

不同 Agent 对模型类型的支持可能不同。先确认设置页已经同步模型，再切换到 Aichat CLI 查看。如果仍没有出现，联系提供方确认该模型是否支持当前 Agent。

通常会在启动时检测到已绑定 License、绑定或查询额度、打开技能中心、手动刷新时同步。没有绑定 License 时，受限技能可能不会显示。

Aichat 官方技能由技能中心统一同步和更新，本地导入用于你自己的自定义技能或可信来源技能包。两者可以同时存在。

如果客户端提供导入入口，可以导入可信来源的本地技能。导入后建议先用简单任务测试效果。

遇到启动失败、Agent 无法启动、模型列表异常、技能同步异常或提示强制更新时，建议先检查更新。

通常不需要。更新后如果 License 状态异常，可以重新查询额度或重新输入 Key。

扫码登录不是远程穿透。请先确认手机浏览器能直接打开 WebUI 首页，再扫码登录。如果手机和电脑不在同一局域网，需要先使用 Tailscale、ZeroTier、Cloudflare Tunnel、FRP、ngrok 或 VPS 反向代理让地址可访问。

如果扫码地址里是 127.0.0.1 或 localhost，手机无法直接访问。请使用客户端显示的局域网地址，或配置可靠的远程访问地址。

浏览器本身可以访问 WebUI，不需要另一个 Aichat 客户端。但跨网络访问需要额外的网络方案，例如 Tailscale、ZeroTier 或 Cloudflare Tunnel。它们解决的是网络可达性，不是替代浏览器。