頁面主題
CLI 常見錯誤及解決方案
全部開啟執行 kiro-cli login 後即可選擇是否通過 GitHub 或 Google 登錄，並彈出系統瀏覽器完成登錄過程。
如果您使用沒有圖形界面的系統環境，執行 kiro-cli login 則只會顯示 Builder ID 登錄方式或企業登錄方式，您可以選擇 Builder ID 使用郵箱註冊登錄
報錯：Improperly formed request 或 An unexpected 錯誤 occurred
通常是 MCP Tool 的描述格式不規範，特別是 input_schema 字段，需要嚴格保證爲合法的 JSON 架構
可以使用 /tools schema 子命令查看 MCP Tool 的描述，確認 input_schema 字段是否合法
建議使用 iTerm2 作爲 終端機 來使用 Kiro CLI。
如果您已經在 Kiro-CLI 的設置中啓用了 autocomplete，但是自動補全沒有生效，可以嘗試執行 kiro-cli doctor 進行自動修復
使用 Kiro CLI 時，如果通過 /agent set-default --name 設置的預設 Agent 後，希望恢復預設的 Agent，可以使用命令 kiro-cli settings --delete chat.defaultAgent 刪除設置來還原預設 Agent
配置 VPC 端點 後，可能無法使用 kiro-cli update 進行 CLI 的升級。這是因爲升級時需要訪問 desktop-release.q.us-east-1.amazonaws.com ，它是 Q 的 VPC 端點 的子域名。如果您需要升級，可以參考[byte index is not a char boundary
Kiro CLI 使用 Rust 語言編寫，對 UTF-8 字符串的合法性有嚴格要求。此報錯說明 Kiro CLI 處理了非法的 UTF-8 字符串，請檢查本地文件是否包含非法 UTF-8 字符
目前只有 MCP Prompt 支持參數。
最新版本 Kiro CLI 可以使用 /logdump 命令把日誌保存爲一個 壓縮 文件。
爲加速我們排查您遇到的問題，我們建議您復現問題，並提供如下資訊給 AWS Support 或者 AWS 解決方案架構師：
必須項：
- 日誌資訊（建議去除敏感資訊）。請參考上文獲取 CLI 的日誌
- CLI 的版本資訊，使用 kiro-cli --version 可以查看當前版本。如果不是最新版，您可以嘗試執行 kiro-cli update 升級到最新版後，再看下問題是否還存在
- 操作系統版本資訊，如 Windows 11
- 問題描述，以及已經進行過哪些排查
可選項： 問題的影片或者截圖（如您能提供問題的影片或者截圖將有助於我們排查問題）
通用問題
全部開啟通常是由於 LLM 的幻覺導致，可以告訴 AI “重試” 或者 “繼續” 或者 “Go on”，如果多次重試仍然失敗，可以嘗試重新開始會話。
通常是網絡不穩定導致，可以告訴 AI “重試” 或者 “繼續” 或者 “Go on”，如果多次重試仍然失敗，可以嘗試重新開始會話，或排查網絡連接。
通常是網絡不穩定導致，可以告訴 AI “重試” 或者 “繼續” 或者 “go on”，如果多次重試仍然失敗，可以嘗試重新開始會話，或排查網絡連接。