Alibaba Cloud Model Studio：常見問題

常見報錯及解決方案

Claude Code 提示 “Claude Code has switched from npm to native installer”怎麼辦？

不影響 Claude Code 的正常使用。你可以選擇在終端執行claude install 將 Claude Code 遷移到官方原生安裝版本，並參照終端中返回的命令完成配置遷移。

Claude Code 報錯 “Unable to connect to Anthropic services. Failed to connect to api.anthropic.com: ERR_BAD_REQUEST”怎麼辦

原因：Claude Code 初次開機時會嘗試串連 api.anthropic.com 完成初始化認證，但 Claude Code 在部分國家和地區不可用，導致串連失敗。

解決方案：

1. 在 ~/.claude.json中添加 "hasCompletedOnboarding": true作為頂層欄位。

   建議使用 Qwen Code 自動添加。在終端運行qwen啟動後，在對話方塊中發送以下內容：請在 ~/.claude.json 檔案中添加 "hasCompletedOnboarding": true 作為頂層欄位，不要覆蓋已有內容。

   {
     "hasCompletedOnboarding": true
   }

2. 儲存後重新啟動 Claude Code。

   claude

OpenCode 報錯 "Request Entity Too Large" 怎麼辦？

該報錯表示請求內容（如代碼上下文、對話歷史）過大，超出最大輸入限制。請按以下方式處理：

1. 執行 /new 建立對話，或執行 /compact 壓縮上下文。更多緩解上下文超限的方法，請參見各模型的上下文長度是多少？超出上下文長度如何處理？。

2. 若以上方法無法解決，請將 OpenCode 更新至 1.2.16 或以上版本，該版本修複了相關問題。

OpenCode 報錯 "The thinking_budget parameter must be a positive integer and not greater than 38912" 怎麼辦？

原因： 設定檔opencode.json中 budgetTokens 的值超過了當前模型支援的最大 thinking_budget。不同模型的上限不同，請參照下表調整配置。

解決方案：開啟 OpenCode 設定檔 opencode.json，將對應模型的 options.thinking.budgetTokens 值調整為不超過該模型的上限值。對於不支援思考模式的模型（qwen3-coder-next、qwen3-coder-plus），需要移除 options.thinking 配置項。詳情請參見OpenCode。

OpenCode報錯“InternalError.Algo.InvalidParameter: Range of max_tokens should be [1, xxxx]”怎麼辦？

原因：設定檔opencode.json中 limit.output 的值超過了當前模型支援的最大輸出Token數（max_tokens）。

解決方案：請根據OpenCode修改設定檔 opencode.json，調整對應模型的limit值。

Coding Plan 模型支援開啟思考模式嗎？

Coding Plan 支援深度思考的模型多為預設支援思考模式，常見工具開啟方式為：

使用的模型需支援思考模式。

{
  "thinking": {
    "type": "enabled",
    "budgetTokens": 1024
  }
}

{
  "ide": {
    "hasSeenNudge": true
  },
  "env": {
    "BAILIAN_CODING_PLAN_API_KEY": "sk-sp-xxx"
  },
  "modelProviders": {
    "openai": [
      {
        "id": "qwen3.5-plus",
        "name": "[Bailian Coding Plan] qwen3.5-plus",
        "baseUrl": "https://coding-intl.dashscope.aliyuncs.com/v1",
        "envKey": "BAILIAN_CODING_PLAN_API_KEY",
        "generationConfig": {
          "extra_body": {
            "enable_thinking": true
          }
        }
      },
      ...
    ]
  },
  "security": {
    "auth": {
      "selectedType": "openai"
    }
  },
  "codingPlan": {
    "region": "china",
    "version": "xxx"
  },
  "model": {
    "name": "qwen3.5-plus"
  },
  "$version": 3
}

為什麼 OpenClaw 中出現未配置模型的調用記錄？

原因：openclaw.json中沒有配置agents.defaults.models來限制可用模型範圍。

解決方案：請在~/.openclaw/openclaw.json的agents.defaults.models中顯式聲明允許使用的模型列表，限制 OpenClaw 僅調用已配置的模型，詳情請參考在 OpenClaw 中配置 Coding Plan。

OpenClaw 顯示已串連但聊天無響應/一直轉圈怎麼辦？

可能的原因如下：

1. 本地代理（VPN/HTTP Proxy）攔截或無法正確轉寄請求到 coding.dashscope.aliyuncs.com。

2. OpenClaw 快取檔案~/.openclaw/agents/main/agent/models.json中的 Base URL 指向了錯誤地址，請求被發送到了無法響應的端點。

解決方案：

1. 嘗試關閉本地代理，或確保代理能正常訪問coding.dashscope.aliyuncs.com。

2. 刪除~/.openclaw/agents/main/agent/models.json快取檔案並重啟 OpenClaw，重啟後快取檔案會根據~/.openclaw/openclaw.json中的配置自動重建。

OpenClaw中報錯 "Agent failed before reply: OAuth token refresh failed" 怎麼辦？

此報錯表明當前接入的是第三方 OAuth 服務，而非 Coding Plan。

解決方案：

1. 在 OpenClaw 中配置 Coding Plan，詳情請參考在 OpenClaw 中配置 Coding Plan。

2. 清理舊的 OAuth 憑證和模型緩衝並重啟 OpenClaw。

   刪除舊的 OAuth 憑證前，建議先備份相關檔案，以便恢複時回退。

     rm ~/.openclaw/agents/main/agent/auth.json
     rm ~/.openclaw/agents/main/agent/models.json
     openclaw gateway restart

OpenClaw報錯“Agent failed before reply: Unknown model”怎麼辦？

該報錯表示 OpenClaw 在設定檔中找不到指定的模型。請按以下順序逐一排查：

1. models.providers 鍵名或模型首碼配置錯誤

   當使用 Coding Plan套餐時，models.providers 下的鍵名必須包含 bailian 鍵（可與其他 provider 共存）。並且，agents.defaults.model.primary 必須加 bailian/首碼。正確的結構如下所示：

   //設定檔：~/.openclaw/openclaw.json
   {
     "models": { "providers": { "bailian": {...} } },
     "agents": { "defaults": { "model": { "primary": "bailian/qwen3.5-plus" } } }
   }

2. 舊 Provider 配置殘留導致路由衝突

   若之前使用過 qwen-portal 等其他供應商，舊 provider 殘留會導致模型路由混亂。請清理無關 provider，確保 primary 欄位指向的模型已在 models.providers.bailian.models 列表中正確定義。配置資訊請參見OpenClaw。

OpenClaw報錯“No API key found for provider "xxxxx".”怎麼辦？

該報錯表示 OpenClaw 無法找到報錯資訊中所指 provider（xxxx）對應的 API Key。請按以下步驟逐一排查：

1. models.providers 中缺少對應 provider 配置

   開啟設定檔 ~/.openclaw/openclaw.json，確認models.providers 下存在與報錯中 provider 名稱一致的鍵。

   1. 若接入 Coding Plan，配置中必須包含 bailian 鍵（可與其他 provider 共存）。

   2. 若不存在，請補充對應的 provider 配置。

2. provider對應的API Key 配置錯誤

   • 確保已填寫有效 API Key（非空、無多餘空格）。

   • 若使用 Coding Plan，請確保使用的是專屬 Key（sk-sp-xxx）。

   • 若 Web UI 中顯示的是 “__OPENCLAW_REDACTED__”，表示API Key 已儲存，無需重填；若顯示為空白或YOUR_API_KEY，則需重新填寫。

3. 本地憑證緩衝未更新，導致配置未生效

   刪除舊的憑證前，建議先備份相關檔案，以便出錯時回退。

   # 刪除舊憑證和模型緩衝
   rm ~/.openclaw/agents/main/agent/auth-profiles.json
   rm ~/.openclaw/agents/main/agent/models.json
   
   # 重啟 Gateway 使配置重新生效
   openclaw gateway restart

OpenClaw報錯“API rate limit reached”怎麼辦？

請按以下順序排查：

1. OpenClaw 配置錯誤

   若 Base URL 或模型供應商配置有誤，導致請求未進入 Coding Plan 專屬通道，而是被路由到了 通用的API 呼叫，從而觸發限流。

   • 若使用 Coding Plan 套餐，請核對OpenClaw設定檔中的 models、agents、gateway（含嵌套欄位），確保與文檔配置一致。例如：模型服務提供者的結構為{ "models": { "providers": { "bailian": {...} } } } 。

   • 若當前未使用 Coding Plan 套餐，建議切換至 Coding Plan 以擷取專屬額度。

2. 超出套餐限額：在Coding Plan頁面查看套餐用量情況。

   • 若額度已用盡，在該頁面查看下一次額度重設的時間。

   • 若頻繁觸達限額，建議升級至 Pro 套餐以擷取更多調用次數。

3. 嘗試重設 API Key：若完成上述排查後問題仍未解決，請前往Coding Plan頁面重設 API Key。

OpenClaw 啟動時報錯 "Failed to discover Alibaba Cloud models" 怎麼辦？

OpenClaw 啟動時出現以下報錯資訊：

• Failed to discover Alibaba Cloud models: TimeoutError: The operation was aborted due to timeout

• Failed to discover Alibaba Cloud models: 404 Not Found

原因：OpenClaw試圖查詢百鍊Coding Plan的模型列表，但模型列表不支援通過介面查詢。

解決方案：

1. 該資訊不影響 OpenClaw 的正常使用，可忽略。

2. 若 OpenClaw 無法正常運行，請檢查其他錯誤資訊。

3. 如需屏蔽此提示，請將 ~/.openclaw/agents/main/agent/auth-profiles.json 檔案中的alibaba-cloud:default profile刪除，例如，當前為

   "profiles": {                                                                                                                                                                                                   
        "alibaba-cloud:default": {                                                                                                                                                                                    
          "type": "api_key",                                                                                                                                                                                          
          "provider": "alibaba-cloud",                                                                                                                                                                                
          "key": "sk-sp-xxxxx"                                                                                                                                                                                        
        }                                                                                                                                                                                                             
      }

   修改為 "profiles": {} 後提示就不會再出現。

OpenClaw 報錯 "auth.profiles.xxx" 怎麼辦？

使用 OpenClaw 時出現類似以下報錯：

• auth.profiles.qwen-portal:default.mode: Invalid input

• auth.profiles.qwen-portal:default: Unrecognized key: "apiKey"

原因：錯誤修改了openclaw.json檔案中的auth.profiles欄位（如將 mode 改為非法值、添加 apiKey 欄位）。 auth僅儲存認證中繼資料，不儲存體金鑰，例如 Qwen 每日免費額度會自動添加 OAuth 配置 qwen-portal:default。Coding Plan 無需在 auth.profiles 中配置。

解決方案

1. 修複 auth.profiles 配置，刪除錯誤添加、修改的欄位和不必要的 profile。

2. 確認 Coding Plan 的 API Key 配置在 models.providers.bailian.apiKey，詳情請參見OpenClaw。

為什麼報錯“HTTP 401: Incorrect API key provided.”？

可能原因：

• API Key 格式錯誤：API Key 填寫為空白、格式不正確、複製不完整，或在複製時誤帶了多餘的空格。請確認API Key 為Coding Plan 專屬 API Key（以 sk-sp- 開頭），複製完整且無空格。

• Coding Plan 訂閱狀態已到期或失效： Coding Plan 專屬 API Key依賴於套餐的訂閱狀態。如果 Coding Plan 套餐已到期或失效，對應的專屬 Key 將無法繼續使用。請確保Coding Plan 訂閱狀態是否仍然有效。

• 使用了錯誤的Base URL：配置了 Coding Plan 專屬 API Key（以 sk-sp- 開頭），但 Base URL 仍保留為阿里雲百鍊通用地址（如 https://dashscope-intl.aliyuncs.com/compatible-mode/v1）。請根據接入的AI工具，將 Base URL 替換為下表中Coding Plan 專屬地址。

  工具	協議	Base URL
  OpenClaw	OpenAI 相容	https://coding-intl.dashscope.aliyuncs.com/v1
  OpenCode	Anthropic 相容	https://coding-intl.dashscope.aliyuncs.com/apps/anthropic/v1
  Claude Code	Anthropic 相容	https://coding-intl.dashscope.aliyuncs.com/apps/anthropic
  Cursor	OpenAI 相容	https://coding-intl.dashscope.aliyuncs.com/v1
  VSCode Cline	OpenAI 相容	https://coding-intl.dashscope.aliyuncs.com/v1
  Qwen Code	OpenAI 相容	https://coding-intl.dashscope.aliyuncs.com/v1

• 使用了錯誤的API Key：配置了 Coding Plan 的專屬 Base URL，但 API Key 誤填了阿里雲百鍊的通用 API Key（以 sk- 開頭）。請將API Key更新為Coding Plan 專屬 API Key。

• OpenClaw歷史配置緩衝導致配置錯誤：請刪除~/.openclaw/agents/main/agent/models.json檔案中的providers.bailian配置項，並重啟OpenClaw。

為什麼報錯“Authentication failed, please make sure that a valid ModelScope token is supplied.”？

此報錯表明當前接入的是第三方 ModelScope 服務，而非 Coding Plan。如需接入Coding Plan，請參考接入AI工具。

報錯資訊表示身分識別驗證失敗。通常是在調用 ModelScopeAPI 服務時，填寫的訪問憑證有誤。請按以下順序排查：

1. 填錯了平台的訪問憑證：ModelScope 的 Token格式為ms-xxx ，阿里雲百鍊的通用 API Key格式為sk-xxx。兩者為獨立平台，訪問憑證互不通用。請前往ModelScope擷取。

2. 格式有誤：確認複製ModelScope Token 時，無多餘空格或分行符號。

為什麼報錯“Coding Plan is currently only available for Coding Agents”？

此報錯表明使用了Coding Plan 不支援的工具或環境發起調用。

Coding Plan 僅限在編程工具（如 Claude Code、Qwen Code 等）中使用，不支援在 curl、Postman、Dify等工具上使用。

為什麼開通了Coding Plan還有模型 API 呼叫費用產生（或導致欠費）？

如果開通 Coding Plan 後仍產生計費或欠費，可能有以下原因：

1. 未正確配置專屬 API Key 和 Base URL（最常見原因）

   • 原因：如果在 AI 工具中配置的是通用 API Key（格式為sk-xxx）和通用 Base URL（不含 coding 關鍵字），系統會將其識別為隨用隨付調用，產生隨用隨付的賬單。

   • 解決方案：請務必使用Coding Plan專屬配置。API Key 的格式必須為sk-sp-xxx，Base URL 必須包含 coding 關鍵字（如 https://coding-intl.dashscope.aliyuncs.com/xxx）。詳情請參見擷取套餐專屬 API Key 和 Base URL。

2. 賬單結算延時導致欠費（費用產生於開通Coding Plan套餐前）

   • 原因：賬單按分鐘匯總，出賬存在分鐘級延遲。 例如 16:00 產生的 API 呼叫，可能延至 16:05（開通Coding Plan套餐後） 才出賬計費。

   • 解決方案：以實際出賬時間為準，詳情請參見賬單查詢與成本管理。

3. 同時配置了 Coding Plan和通用API調用憑證，但誤用了通用API調用

   • 原因：若工具中同時保留了“通用”和“專屬”兩套配置，部分工具（如 OpenClaw）會自動路由到通用憑證進行請求，從而產生計費。

   • 解決方案：建議在工具中移除通用 API 配置，並確保選用Coding Plan支援的模型。例如在 OpenCode 中，請選擇供應商標為“Model Studio Coding Plan”的模型。

4. 用戶端緩衝未清理

   • 原因：配置新憑證後，部分工具可能仍在讀取舊的通用API調用憑證緩衝。

   • 解決方案：清理緩衝並重啟。以 OpenClaw 為例：刪除 ~/.openclaw/agents/main/agent/models.json 檔案，執行 openclaw gateway restart 重啟服務後，再根據OpenClaw重新設定。

額度用完了怎麼辦？

• Lite 套餐：5 小時或每周額度用完後可等待自動回復；每月額度用完可升級至 Pro 套餐，或等待至下個訂閱月續約後恢複。

• Pro 套餐：5 小時或每周額度用完後等待自動回復；每月額度用完需等待至下個訂閱月續約後恢複。

Coding Plan 額度用完後會轉為隨用隨付嗎？

Coding Plan 額度消耗完畢後，繼續調用會失敗報錯，並且不會自動轉為隨用隨付模式計費。如需繼續使用，請升級至 Pro 版本擷取更多額度或等待下一訂閱周期額度重新整理。

Coding Plan 可以使用百鍊的模型免費試用嗎？

Coding Plan 是一個獨立的訂閱產品，其計費和配額系統不參與百鍊的通用模型免費試用計劃。

為什麼 2 月購買的 Coding Plan 只有 28 天，而不是 31 天？

套餐自開通時刻起生效，有效期間至次月對應日 23:59:59（UTC+8）結束。若次月沒有對應日期，則有效期間至次月最後一日23:59:59（UTC+8）結束。

例如：2026 年 2 月 3 日開通 Coding Plan，有效期間至 2026 年 3 月 3 日，因此剩餘天數為 28 天。

如何查看 Token 消耗資訊？

暫無法查看。Coding Plan的額度消耗與 Token 消耗無關，只與模型調用次數有關。可在Coding Plan頁面查看用量資訊。

可以查詢 Coding Plan 套餐內特定模型（如qwen3.5-plus）的使用量嗎？

不支援。Coding Plan頁面僅展示套餐總額度的整體消耗和剩餘情況。

Coding Plan 有年付套餐嗎？

目前 Coding Plan 僅支援按月訂閱，暫無年付套餐。

Coding Plan 可以提前續訂嗎？到期後還能續約嗎？

支援在套餐到期前續訂，到期後無法續約，只能新購。新購的套餐API Key會變化，需要手動替換原有API Key。

Coding Plan 提前續訂後，新服務周期如何計算？

新購 1 個月套餐，按照自然月計算訂單時間長度。套餐自開通時刻起生效，有效期間至次月對應日 23:59:59（UTC+8）結束。若次月沒有對應日期，則有效期間至次月最後一日23:59:59（UTC+8）結束。提前續訂時，新周期在原到期日基礎上自動順延。

例如：

• 首次開通為 3 月 15 日 10:00，有效期間至 4 月 15 日 23:59:59。

• 4 月 10 日提前續訂 1 個月，新有效期間至 5 月 15 日 23:59:59。

續訂是否可以使用代金券抵扣？

可以使用通用代金券。

續約入口在哪裡？

推薦在Coding Plan頁面進行續約（也支援新購），也可以資源續訂頁面進行續約（不能新購）。

Coding Plan支援哪些模型？

推薦模型：qwen3.5-plus（支援圖片理解）、kimi-k2.5（支援圖片理解）、glm-5、MiniMax-M2.5，更多模型請參見Coding Plan概述。

每個百鍊帳號支援同時開通幾個 Coding Plan？

每個百鍊帳號同時只能訂閱一個 Coding Plan（不區分 Lite 和 Pro 套餐版本）。

是否可以使用支援的模型列表以外的模型？

Coding Plan 當前僅可以使用支援的模型列表中的模型，使用其他模型會報錯。

Lite 和 Pro 套餐的模型響應速度相同嗎？

Lite 基礎套餐和 Pro 進階套餐在模型響應速度上是相同的，兩個套餐使用的是同樣的模型資源和推理服務。

Lite套餐是否可以升級到Pro套餐？API Key是否會變化？

支援升配。在Lite套餐有效期間內升配後，API Key 保持不變。升配費用和到期時間以購買頁為準，請在Coding Plan頁面進行升配。

Pro套餐是否可以降級到Lite套餐？

不支援降配。

Coding Plan是否支援多人使用？

Coding Plan 的 API Key 僅供個人使用，暫不支援多人共用，請勿與他人共用。若系統檢測到您的 API Key 存在公開泄露的情況，可能會自動將其禁用。

Pro 套餐支援企業多名開發人員同時使用嗎？

不支援。請妥善儲存密鑰資訊，不要與他人共用，或者暴露在用戶端代碼中。若系統檢測到您的 API Key 存在公開泄露的情況，可能會自動將其禁用。

各模型的上下文長度是多少？超出上下文長度如何處理？

當遇到與上下文超限相關的報錯時，建議建立會話。此外，可以通過以下方式來避免超出上下文長度：

1. 切換模型：切換支援更長內容相關的模型，如 qwen3.5-plus、qwen3-coder-plus。

2. 減少無關檔案：建議在具體的專案目錄中啟動 AI 編程工具，同時僅保留必要的專案檔。

3. 分割任務：將複雜任務拆成若干子任務，逐項提問，降低單次請求的上下文佔用。

4. 精確指令：模糊的請求會觸發非必要的檔案掃描，請在使用 AI 編程工具時提出更明確、具體的問題或指令。

具體操作因工具而異，請參考接入AI工具。

Coding Plan 如何重設 API Key？

在Coding Plan頁面，點擊Coding Plan 的 API Key 旁邊的重設按鈕即可。

Coding Plan 到期不續約，重新開通後API Key會重設嗎？

會重設；在到期前續約則不會重設。

Coding Plan 到期前有無提醒？

有提醒。系統會在到期前7、3、1天，通過站內信、郵件、簡訊以及智能外呼提醒您及時續訂。

支援為 Coding Plan 配置到期訊息訂閱嗎？

不支援，也無需額外配置。系統會在到期前 7 天、3 天、1 天，通過站內信、郵件、簡訊以及智能外呼自動推送到期提醒，無需手動訂閱。

Coding Plan 可以產生多個 API Key 嗎？

當前僅支援一個 API Key。

Coding Plan 支援設定使用的IP白名單嗎？

不支援。如果API Key泄露，請在Coding Plan頁面重設API Key。

子帳號如何查看擷取 Coding Plan API Key？

請聯絡主帳號或具有管理員權限的子帳號為帳號添加订阅套餐許可權。

VSCode 如何使用 Coding Plan？

使用支援接入相容OpenAI / Anthropic API 協議的外掛程式，如 Qwen Code、Claude Code 等。

Coding Plan 中的模型是否經過量化處理？

Coding Plan 套餐中包含的模型（如 glm-5、qwen3.5-plus 等）均為完整版模型，未經過量化或功能閹割，屬於滿血版本。

Coding Plan 和節省計劃有什麼區別？

data_inspection_failed 報錯如何處理？

請參見錯誤資訊文檔。

Coding Plan 配置 Dify 為什麼報錯？

不建議在 Dify 中使用 Coding Plan。Coding Plan 套餐額度僅可在編程工具（如 Claude Code、Qwen Code 等）中使用，禁止以 API 呼叫的形式用於自動化指令碼、自訂應用程式後端或任何非互動式批量調用情境。將套餐 API Key 用於允許範圍之外的調用將被視為違規或濫用，可能會導致訂閱被暫停或 API Key 被封鎖。

Coding Plan 能在 postman上調用嗎？

不建議。Coding Plan 套餐額度僅可在編程工具（如 Claude Code、Qwen Code 等）中使用，禁止以 API 呼叫的形式用於自動化指令碼、自訂應用程式後端或任何非互動式批量調用情境。將套餐 API Key 用於允許範圍之外的調用將被視為違規或濫用，可能會導致訂閱被暫停或 API Key 被封鎖。