> ## 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/zh-Hant/cloud/account/plus.md)。

### 用量頁的花費和賬單金額對不上，時間也差幾個小時

賬單隻記錄 Plus 訂單，用量頁的花費是對模型呼叫的估算，自有 API Key 由服務商另行收費。賬單日期按 Asia/Shanghai 時區計算，用量按你電腦的本地時區計算。

## 發起會話

### 新對話頁每次都不在任何專案中

新對話頁不會記住上次選的專案。從側欄專案行的 **＋** 或專案頁的 **在此專案新建任務** 進入，會自動選好這個專案。

### 傳送按鈕不可用

通常是還有附件在上傳、轉換，或者上傳失敗了。等進度完成，或者重試、移除失敗的附件。

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

點附件上的重試按鈕。多次失敗時檢查網路，或移除後重新新增。提示檔案太大時，壓縮或拆分後再新增。

### 斜槓命令無法選擇

命令下方會寫原因。最常見的是這條命令只裝在某臺裝置上，而當前會話不在那臺裝置上執行。

### 選了自己的電腦後，完全訪問無法選擇

那臺電腦設了更低的許可權上限。在那臺電腦的桌面客戶端裡，到 **設定 › 機器** 調高許可權上限。

### 會話開始後能換模型、執行位置或 Harness 嗎

模型、來源和推理強度可以在當前任務結束後更換；執行位置和 Harness 在會話開始時就定了，要換請新建會話。見[發起會話](https://docs.aihubmix.com/zh-Hant/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/zh-Hant/cloud/environments/your-device.md)。

### 在本機執行時，電腦要一直開著嗎

要。電腦斷開後會話會暫停，重新連上後自動繼續。需要合上電腦也繼續執行的，請選雲主機。

### 網頁版改不了電腦的執行授權

執行授權只能在那臺電腦自己的桌面客戶端裡修改，網頁版和其他裝置只能檢視。

### 怎麼新增一臺新電腦

在那臺電腦上安裝桌面客戶端並登入同一帳號，它會自動出現在機器列表裡，再在那臺電腦的客戶端裡開啟 **允許執行**。

### 客戶端彈出訪問確認

Agent 要訪問 SSH 配置這類敏感位置，而這臺電腦設為每次詢問。點 **允許這一次** 只放行這一次，點 **拒絕** 不放行；一段時間沒處理會按拒絕處理。

## 雲主機

### 關掉客戶端或合上電腦，會話和定時任務還會繼續嗎

會。在雲主機上執行的會話和定時任務與你的裝置是否線上無關。

### 提示雲主機正在更新

稍等片刻，更新完成後會自動重試。

### 雲主機升級或停機，任務中斷了

已完成的步驟和檔案都保留。升級中斷時點 **重發**，把你最後一條訊息重新傳送一次；停機或替換時，等環境就緒後發一條訊息，Agent 會從已有進度繼續。

### 提示已攔截訪問內網地址

出於安全考慮，雲主機只能訪問公網，不能訪問你的內網。如果你在 BYOK 裡配置的自定義模型地址指向內網，請改用公網可訪問的地址。

### 關掉了管理員許可權，還顯示已生效

設定需要稍等片刻才會在雲主機上生效，期間顯示應用中，通常不到 1 分鐘。顯示應用失敗時點 **重試**。

### 雲主機桌面只能看不能操作

你在另一個視窗或裝置上接管了雲主機，這裡自動退回只讀。點 **接管** 把控制切回來。

### 接管桌面或桌面畫面斷開後，Agent 會停嗎

不會。接管只是把鍵盤滑鼠交給你，Agent 繼續執行；畫面連線和會話執行也是分開的。

### 開啟網頁預覽失敗

確認開發服務仍在執行、並且監聽 `0.0.0.0`，再點 **重試**。有些網站禁止被嵌入其他頁面，這時請點 **在瀏覽器中開啟**。

### 定時任務暫停了

可能是你手動暫停、連續失敗 3 次被自動暫停，或會話定時已到期。看執行記錄找到原因，處理後點 **恢復**（已到期的先 **續期**）。見[定時任務](https://docs.aihubmix.com/zh-Hant/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/zh-Hant/cloud/models/choose-a-model.md)。

### Ultracode 開關無法開啟

開關旁會寫原因，例如 Harness 不是 Claude Code，或雲主機還沒就緒。

## 專案與環境

### 專案和工作區裡都有同名變數，用哪個

用專案裡的。所有專案共用的值只在專案裡沒有同名項時生效。

### AI 能看到我填的金鑰嗎

不能。金鑰加密儲存，介面和對話裡只顯示名稱，執行時才提供給環境。你在會話裡提供的金鑰也只記錄名稱，原值不進入對話。

### 跳過了環境檢查，之後還能補金鑰嗎

可以。在 **設定 › 金鑰與環境變數** 裡補，或回到配置環境頁點 **編輯環境**。見[專案與環境配置](https://docs.aihubmix.com/zh-Hant/cloud/environments/projects.md)。

### 新建專案後沒有自動開始配置環境

配置環境是可選的，專案建好就可以開始會話。需要時到 **專案設定 › 環境** 進入。

### 上傳本地專案失敗

已經傳上去的部分不會保留，點 **重試** 會從頭開始。

### 刪除專案會刪掉電腦上的檔案嗎

不會，本地專案的資料夾不受影響。專案下的會話會被歸檔，在 **設定 › 已歸檔對話** 裡只能開啟檢視或永久刪除，不能恢復到側欄。

### 找不到以前的會話

側欄的最近只放不在任何專案裡的會話，專案裡的會話在對應專案下，置頂的只在已置頂裡。按 `⌘K` 搜尋；在操作記錄裡把時間改成全部時間；或到 **設定 › 已歸檔對話** 檢視。見[管理會話](https://docs.aihubmix.com/zh-Hant/cloud/sessions/manage-sessions.md)。

### GitHub 或 Gmail 顯示授權已失效

通常是在服務方撤銷了授權。在 **設定 › 聯結器** 點 **重新連線**。斷開 GitHub 不會刪除專案，只是無法再拉取程式碼、推送分支或建立 PR。

### 匯入的 MCP 沒有生效

匯入的 MCP 預設停用，需要在列表裡開啟開關，下一次會話時載入。見[外掛、MCP 與 Skills](https://docs.aihubmix.com/zh-Hant/cloud/integrations/plugins-mcp-skills.md)。

### 某個 MCP 不能同步到雲端

它依賴裝置本地路徑或 localhost，或者配置裡有金鑰明文。前者改成遠端可訪問的配置；後者選 **改用金鑰引用**，在裝置上改成變數引用後再同步。

## 通知與更新

### 會話完成了卻沒有彈通知

依次檢查：**設定 › 通用** 裡的允許系統通知是否開啟、系統許可權是否已允許、任務完成這一類是否開啟；如果是定時任務，它自己的通知設定是否為全部更新（預設只通知失敗）；以及你當時是否正在看這個會話。見[設定](https://docs.aihubmix.com/zh-Hant/cloud/reference/settings.md)。

### 系統裡已經允許了通知，還顯示未允許

切回雲 Agent 視窗後狀態會更新。macOS 上可能要等下一條通知送達後才顯示已允許。

### 把等待批准的通知標為已讀，會話會繼續嗎

不會。已讀只表示你看過，需要開啟會話完成批准。

### 更新下載失敗

檢查網路後點 **下載失敗，點按重試**。

### 下載完成後提示更新安裝準備失敗

點 **重試** 重新下載，或點 **手動下載** 下載安裝包後自行安裝。

### 重啟更新時只能選任務結束後重啟

這臺電腦上還有本機任務在執行。客戶端會等這些任務結束後自動重啟，也可以點 **取消重啟** 稍後再重啟。雲端會話不受影響。

### 提示當前版本過低，需要更新

介面仍可繼續使用，請儘快下載並安裝新版本。

### 重啟失敗

再點一次重啟，或手動退出客戶端後重新開啟。

### 網頁版怎麼更新

不需要手動更新，重新整理頁面就是最新版本。


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