> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aihubmix.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 常见问题与排错

> 登录、付款、会话出错、本机执行、云主机、模型来源、项目、通知与更新中常见的问题，以及原因和处理办法。

这页按主题汇总使用中常见的问题和报错。总的原则是：你写的内容不会丢，已完成的步骤和文件不会丢，能自动恢复的会自动恢复。出错时报错一般显示在输入框上方，点 **详情** 可以看原始报错，联系支持时点 **复制详情** 附上。

## 登录与账户

### 登录时提示已取消、超时或登录请求已失效

浏览器里取消了授权、等待太久，或者这次登录链接已经用过。重新点 **使用 AIHubMix 账号继续** 即可。

### 提示登录服务暂时不可用或登录失败

AIHubMix 登录服务暂时出了问题，稍后重试。

### 提示账号已被封禁

这个 AIHubMix 账号无法登录云 Agent，请在 AIHubMix 处理账号问题。

### 桌面客户端提示设备已被移除

这台电脑已被从机器列表中移除，重新登录就会重新加入。

### 使用中提示登录已过期

点 **重新登录**，对话和草稿都会保留。

### 怎么修改或找回密码

密码属于 AIHubMix 账号，云 Agent 里没有修改或找回密码的入口，请在 AIHubMix 的账号设置或登录页处理。

### 桌面客户端和网页版要分别注册吗

不需要。两者用同一个 AIHubMix 账号，看到同一份项目、会话和 Plus 订阅。

## Plus 与付款

### 付款没有完成，或中途放弃了

不会扣款。回到订阅窗口点 **重新订阅** 即可。

### 已经付了款，但还没开通

付款结果可能还没到。结果到达后会自动开通，**不要重复付款**；可以点 **刷新** 或 **重试** 查看最新状态。显示正在开通时是在准备云主机，通常需要几分钟。

### 提示这个地区暂时售罄

换一个出口地区再订阅。所有地区都售罄时暂时无法订阅，请稍后再试。

### 提示扣款失败

自动续订没有扣款成功。到云主机页点 **更新付款方式**，在提示的日期前处理，否则云主机会停机；宽限期内照常使用。非在线付款开通的订阅请联系客服。

### 首月优惠之后每月多少钱

订阅窗口里写的续订价就是第 2 个月起每月的扣款，之后一直按这个价格续订。

### 取消续订后还能用吗

到期前一切照常，到期后云主机停止运行会话和定时任务。到期前可以在云主机页点 **恢复续订**。

### 不开通 Plus，能用自己的订阅或 API Key 运行会话吗

不能。会话都需要 Plus 才能运行，与模型来源无关。

### 没有 Plus 时发出的消息会丢吗

不会，开通后会自动开始处理。只有退出登录会清掉首页暂存、还没发出的消息。网页版付款后如果暂存消息里的附件没能恢复，这条消息不会自动发出，需要回到会话里手动发送。

### 在哪里换付款卡、下载发票

在云主机页点 **付款方式与发票**。账单记录和导出的 CSV 都不是正式发票。见 [Plus 套餐与用量](https://docs.aihubmix.com/cn/cloud/account/plus.md)。

### 用量页的花费和账单金额对不上，时间也差几个小时

账单只记录 Plus 订单，用量页的花费是对模型调用的估算，自有 API Key 由服务商另行收费。账单日期按 Asia/Shanghai 时区计算，用量按你电脑的本地时区计算。

## 发起会话

### 新对话页每次都不在任何项目中

新对话页不会记住上次选的项目。从侧栏项目行的 **＋** 或项目页的 **在此项目新建任务** 进入，会自动选好这个项目。

### 发送按钮不可用

通常是还有附件在上传、转换，或者上传失败了。等进度完成，或者重试、移除失败的附件。

### 附件一直上传不成功

点附件上的重试按钮。多次失败时检查网络，或移除后重新添加。提示文件太大时，压缩或拆分后再添加。

### 斜杠命令无法选择

命令下方会写原因。最常见的是这条命令只装在某台设备上，而当前会话不在那台设备上执行。

### 选了自己的电脑后，完全访问无法选择

那台电脑设了更低的权限上限。在那台电脑的桌面客户端里，到 **设置 › 机器** 调高权限上限。

### 会话开始后能换模型、运行位置或 Harness 吗

模型、来源和推理强度可以在当前任务结束后更换；运行位置和 Harness 在会话开始时就定了，要换请新建会话。见[发起会话](https://docs.aihubmix.com/cn/cloud/sessions/start-a-session.md)。

### 新会话一直在排队

同一个项目里最多同时运行 5 个会话，超出时或云主机正在恢复时会排队，空出后自动按顺序开始，排队期间发的消息会在开始后处理。

## 运行中出错

### 消息没有发出去

消息下方会提示内容已保留。点 **重试** 即可，不会重复发送。

### 提示连接中断，正在重连

和服务器的连接暂时断了，恢复后会自动补齐期间的消息，等待即可。提示连接已断开、请刷新页面时，刷新页面。

### 提示网络中断、请求超时、请求太频繁或服务暂时不可用

点 **重试** 或稍等片刻，客户端会自动重试。一直失败时复制详情联系支持。

### 提示没有权限

你在当前工作区没有这项操作的权限，请联系工作区管理员。

### 提示「会话已休眠，下次发消息自动恢复」

一段时间没有活动的会话会休眠。直接发一条消息就会恢复。

### 提示会话已暂停

侧栏会把这个会话标为需要你处理，按提示里的原因处理：

* 模型额度已用完：见本页模型与来源部分的「订阅额度用完了」。
* 订阅账号断开或失效、Key 失效：换一个来源或模型继续。
* 待答项超时：发一条消息继续。
* 等待补充配置：按提示补齐配置。
* 账号已被停用：联系支持。

### 会话中断了，之前改好的文件还在吗

在。无论是你主动停止、云主机升级或停机，还是执行设备断开，已完成的步骤和文件都会保留，继续发消息即可。

### 选了插话，消息还是排队了

当前会话的 Agent 不支持中途接收消息，会自动改为排队，等当前任务结束后再发出。只有 Claude Code 和 Codex 支持插话。

### 点了停止，排队的消息会怎样

在当前窗口点停止时，排队的消息按顺序接着发出；在别的窗口或设备上停止时，队列会暂停，需要你点 **全部发送** 或逐条 **发送**。

### 按 Esc 没有停止会话

有菜单或对话框打开时，`Esc` 会先关闭它们；焦点在搜索框等其他输入区域时也不会停止。焦点在主输入框或对话区时再按 `Esc`。

### 按数字键 1 没有批准请求

批准类快捷键只在焦点不在输入框或按钮上时生效。先点一下对话区空白处再按。

### 收起了 Agent 的请求，找不到了

点输入框上方的 **需要你处理**，或会话记录里那一条的 **处理**。

### 拒绝请求后会话会失败吗

不一定。Agent 会尝试换一种方式完成，确实无法继续时会在回复里说明。想告诉它怎么做，选 **其他要求…** 写下你的要求。

### 消息上没有修改按钮

会话使用的 Agent 不支持回退时不显示；已归档、只能查看或正在排队的会话也不能修改。修改消息不会撤销已经写入的文件改动。

## 本机执行

### 执行设备断开，会话暂停了

那台电脑关机、休眠、断网或退出了客户端。重新连上后会从中断处自动继续，已完成的操作不会重复执行。如果暂停期间你发了消息或点了停止，就不会自动继续，再发一条消息即可。那台电脑的客户端会显示断开原因：

* 登录已过期：重新登录后自动连接。
* 这台电脑没有允许执行：在 **设置 › 机器** 里打开 **允许执行**。
* 还没关联项目文件夹：点 **关联文件夹**。
* 本机服务多次意外退出：点 **重启**。

### 运行环境菜单里我的电脑无法选择

菜单里会写原因：设备离线、没有允许执行、设备已移除、当前项目不在这台设备上，或者当前 Agent 不是 Claude Code（在设备上执行目前只支持 Claude Code）。按原因处理，或改选云主机。见[在本机执行](https://docs.aihubmix.com/cn/cloud/environments/your-device.md)。

### 在本机执行时，电脑要一直开着吗

要。电脑断开后会话会暂停，重新连上后自动继续。需要合上电脑也继续运行的，请选云主机。

### 网页版改不了电脑的执行授权

执行授权只能在那台电脑自己的桌面客户端里修改，网页版和其他设备只能查看。

### 怎么添加一台新电脑

在那台电脑上安装桌面客户端并登录同一账号，它会自动出现在机器列表里，再在那台电脑的客户端里打开 **允许执行**。

### 客户端弹出访问确认

Agent 要访问 SSH 配置这类敏感位置，而这台电脑设为每次询问。点 **允许这一次** 只放行这一次，点 **拒绝** 不放行；一段时间没处理会按拒绝处理。

## 云主机

### 关掉客户端或合上电脑，会话和定时任务还会继续吗

会。在云主机上运行的会话和定时任务与你的设备是否在线无关。

### 提示云主机正在更新

稍等片刻，更新完成后会自动重试。

### 云主机升级或停机，任务中断了

已完成的步骤和文件都保留。升级中断时点 **重发**，把你最后一条消息重新发送一次；停机或替换时，等环境就绪后发一条消息，Agent 会从已有进度继续。

### 提示已拦截访问内网地址

出于安全考虑，云主机只能访问公网，不能访问你的内网。如果你在 BYOK 里配置的自定义模型地址指向内网，请改用公网可访问的地址。

### 关掉了管理员权限，还显示已生效

设置需要稍等片刻才会在云主机上生效，期间显示应用中，通常不到 1 分钟。显示应用失败时点 **重试**。

### 云主机桌面只能看不能操作

你在另一个窗口或设备上接管了云主机，这里自动退回只读。点 **接管** 把控制切回来。

### 接管桌面或桌面画面断开后，Agent 会停吗

不会。接管只是把键盘鼠标交给你，Agent 继续运行；画面连接和会话运行也是分开的。

### 打开网页预览失败

确认开发服务仍在运行、并且监听 `0.0.0.0`，再点 **重试**。有些网站禁止被嵌入其他页面，这时请点 **在浏览器中打开**。

### 定时任务暂停了

可能是你手动暂停、连续失败 3 次被自动暂停，或会话定时已到期。看运行记录找到原因，处理后点 **恢复**（已到期的先 **续期**）。见[定时任务](https://docs.aihubmix.com/cn/cloud/automation/scheduled-tasks.md)。

## 模型与来源

### Plus 模型无法选择

还没有开通 Plus。点模型选择器里的 **开通 Plus**。

### 某个账号或 Key 的模型无法选择

它与当前 Harness 不兼容，下方会写原因。新会话里点它会自动换成能用的 Harness；会话开始后不能选。

### 订阅已连接，但订阅页签里没有模型

账号下会写原因，例如当前 Harness 不支持该订阅。换一个 Harness 或稍后再试。

### Anthropic 的 Key 不能配 Codex CLI

Codex CLI 需要 OpenAI 兼容接口，Claude Code 需要 Anthropic 兼容接口。按 Harness 添加对应格式的 Key。

### 添加订阅时提示云主机没有运行

订阅登录在你的云主机里完成，需要云主机处于运行中。等云主机就绪后再添加。

### 订阅账号显示授权已失效

点账号行的 **重新连接**。

### 订阅额度用完了

会话会停下，改动和环境都保留，系统不会自动换账号。在弹出的对话框里选同一家的另一个账号继续，或 **添加账号**、**换模型继续**；也可以点 **稍后**，等额度恢复。

### Plus 模型到达用量上限

**设置 › 账户** 的 Plus 模型行会提示何时恢复。可以等恢复，或者改用你自己的订阅或 API Key。

### 自己的 API Key 调用失败

默认直接报错。在 **设置 › 账户** 打开 **Key 失败时改用 Plus 模型** 后，Key 额度用尽、限流或失效时会改用 Plus 模型继续。

### 提示这个来源当前不可用

换一个来源或模型再试。

### 会话中换模型会丢失上下文吗

一般不会，之前的记录全部保留。只有上下文放不下新模型时才会请你确认压缩，较早的细节可能不再保留。

### 换模型后推理强度变了

新模型没有你之前选的档位时，会回到新模型推荐的档位。见[选择模型](https://docs.aihubmix.com/cn/cloud/models/choose-a-model.md)。

### Ultracode 开关无法打开

开关旁会写原因，例如 Harness 不是 Claude Code，或云主机还没就绪。

## 项目与环境

### 项目和工作区里都有同名变量，用哪个

用项目里的。所有项目共用的值只在项目里没有同名项时生效。

### AI 能看到我填的密钥吗

不能。密钥加密保存，界面和对话里只显示名称，运行时才提供给环境。你在会话里提供的密钥也只记录名称，原值不进入对话。

### 跳过了环境检查，之后还能补密钥吗

可以。在 **设置 › 密钥与环境变量** 里补，或回到配置环境页点 **编辑环境**。见[项目与环境配置](https://docs.aihubmix.com/cn/cloud/environments/projects.md)。

### 新建项目后没有自动开始配置环境

配置环境是可选的，项目建好就可以开始会话。需要时到 **项目设置 › 环境** 进入。

### 上传本地项目失败

已经传上去的部分不会保留，点 **重试** 会从头开始。

### 删除项目会删掉电脑上的文件吗

不会，本地项目的文件夹不受影响。项目下的会话会被归档，在 **设置 › 已归档对话** 里只能打开查看或永久删除，不能恢复到侧栏。

### 找不到以前的会话

侧栏的最近只放不在任何项目里的会话，项目里的会话在对应项目下，置顶的只在已置顶里。按 `⌘K` 搜索；在操作记录里把时间改成全部时间；或到 **设置 › 已归档对话** 查看。见[管理会话](https://docs.aihubmix.com/cn/cloud/sessions/manage-sessions.md)。

### GitHub 或 Gmail 显示授权已失效

通常是在服务方撤销了授权。在 **设置 › 连接器** 点 **重新连接**。断开 GitHub 不会删除项目，只是无法再拉取代码、推送分支或创建 PR。

### 导入的 MCP 没有生效

导入的 MCP 默认停用，需要在列表里打开开关，下一次会话时加载。见[插件、MCP 与 Skills](https://docs.aihubmix.com/cn/cloud/integrations/plugins-mcp-skills.md)。

### 某个 MCP 不能同步到云端

它依赖设备本地路径或 localhost，或者配置里有密钥明文。前者改成远程可访问的配置；后者选 **改用密钥引用**，在设备上改成变量引用后再同步。

## 通知与更新

### 会话完成了却没有弹通知

依次检查：**设置 › 通用** 里的允许系统通知是否开启、系统权限是否已允许、任务完成这一类是否开启；如果是定时任务，它自己的通知设置是否为全部更新（默认只通知失败）；以及你当时是否正在看这个会话。见[设置](https://docs.aihubmix.com/cn/cloud/reference/settings.md)。

### 系统里已经允许了通知，还显示未允许

切回云 Agent 窗口后状态会更新。macOS 上可能要等下一条通知送达后才显示已允许。

### 把等待批准的通知标为已读，会话会继续吗

不会。已读只表示你看过，需要打开会话完成批准。

### 更新下载失败

检查网络后点 **下载失败，点按重试**。

### 下载完成后提示更新安装准备失败

点 **重试** 重新下载，或点 **手动下载** 下载安装包后自行安装。

### 重启更新时只能选任务结束后重启

这台电脑上还有本机任务在运行。客户端会等这些任务结束后自动重启，也可以点 **取消重启** 稍后再重启。云端会话不受影响。

### 提示当前版本过低，需要更新

界面仍可继续使用，请尽快下载并安装新版本。

### 重启失败

再点一次重启，或手动退出客户端后重新打开。

### 网页版怎么更新

不需要手动更新，刷新页面就是最新版本。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.