Kiro CLI on Book of Kiro

開始使用

Mon, 01 Jan 0001 00:00:00 +0000

Kiro CLI 安裝與介紹#

Kiro CLI 是 Kiro 平台的命令列元件，提供高度互動式的終端機程式設計體驗。它支援自訂 Agent、複雜程式碼庫功能建構、工作流程自動化和精確的錯誤分析。

安裝 Kiro CLI#

在 macOS 和 Linux 系統上安裝：

curl -fsSL https://cli.kiro.dev/install | bash

Kiro CLI 的功能介紹#

💬 開始聊天#

登入後，直接使用 kiro-cli 指令即可開始聊天（kiro-cli 是 kiro-cli chat 指令的縮寫）。

您可以使用 kiro-cli chat --help 來查看額外的參數。

進入聊天後，您可以使用 /help 查看工作階段中的指令。下文中所有以 / 開頭的指令都是在工作階段中執行的。

📁 引用檔案或資料夾#

在聊天視窗中，檔案名稱會有自動補全的效果，您可以按下 Tab 來進行路徑自動補全。

只要告訴 Agent 需要讀取的檔案路徑，Agent 就會自動讀取檔案或資料夾中的資訊。

除了手動引用，您還可以使用自訂智慧代理來設定 Agent 預設讀取的檔案。

⏹️ 打斷 Agent#

在 Agent 工作的過程中可以隨時使用 Ctrl+C 或者 Ctrl+D 來打斷 Agent 的工作。

💾 儲存工作階段和載入工作階段#

使用 /save xxx 來儲存工作階段，使用 /load xxx.json 來載入工作階段。

自訂智慧代理

Mon, 01 Jan 0001 00:00:00 +0000

自訂智慧代理#

Kiro CLI 支援建立自訂智慧代理，讓您可以根據特定需求設定專門的開發助手。透過 JSON 設定檔，您可以定制 Agent 的行為、權限和預設上下文。

設定檔位置#

Kiro CLI 會把智慧代理的設定檔儲存在 ~/.kiro/agents/*.json 路徑中，您可以建立不同的 JSON 設定檔，從而建立自訂的智慧代理出來。

完整設定可以參考官方文件

📚 自動上下文#

在自訂智慧代理的設定檔中，可以設定 resource 欄位，設定一些檔案路徑，這些路徑的檔案會被自動包含在聊天中。

預設設定#

{
 "resources": [
 "file://README.md",
 "file://AGENTS.md",
 "file://AmazonQ.md",
 "file://.amazonq/rules/**/*.md",
 "file://.kiro/steering/**/*.md",
 "file://~/.kiro/steering/**/*.md"
 ]
}

所以每次和 CLI 聊天時，它都會自動包含 README 檔案，對已有的專案有所了解。

詳見官方文件

🔧 工具管理#

🚫 停用不需要的工具#

自訂智慧代理的設定檔中，可以設定 tools 欄位，包含了啟用哪些 tools。如果您有不想使用的 tools，可以從列表中刪除。

{
 "tools": [
 "fs_read",
 "fs_write",
 "execute_bash",
 "@git",
 "@rust-analyzer/check_code"
 ]
}

比如，如果不希望 AI 修改本地檔案，可以停用 fs_write 工具和 execute_bash 工具。

詳見官方文件

✅ 信任工具的執行#

自訂智慧代理的設定檔中，可以設定 allowedTools 欄位，包含了信任哪些 tools

常見問題

Mon, 01 Jan 0001 00:00:00 +0000

Kiro CLI 常見問題#

基本使用問題#

Kiro CLI 如何查看我是付費版還是免費版？#

登入後使用 kiro-cli whoami 查看。Builder ID 是免費版，IAM Identity Center 是付費版

Kiro CLI 如何登出？#

使用 kiro-cli logout 指令進行登出。

在 Windows 上透過 WSL 的方式來使用 Kiro CLI，消耗多少資源？#

Windows 上透過 WSL 的方式來使用 Kiro CLI 使用的資源非常有限。在 Windows 上安裝 WSL 並且安裝 Kiro CLI 之後的記憶體開銷很小。

有非互動式模式嗎？#

有。使用指令：kiro-cli chat --no-interactive --trust-all-tools

可以在容器中用嗎？#

可以。參考 auto-q 專案

可以在 CI/CD 流水線裡用嗎？#

請參考相關部落格在 GitLab 中進行設定，GitHub 等其他儲存庫可參考部落格中的流程。

需要注意：由於 Amazon Q Developer CLI 升級到了 Kiro CLI，所以部落格中的檔案路徑 ~/.local/share/amazon-q/ 應為 ~/.local/share/kiro-cli

疑難排解

Mon, 01 Jan 0001 00:00:00 +0000

CLI 疑難排解#

CLI 常見錯誤及解決方案#

如何使用 GitHub/Google 登入#

執行 kiro-cli login 後即可選擇是否透過 GitHub 或 Google 登入，並彈出系統瀏覽器完成登入過程。

如果您使用沒有圖形介面的系統環境，執行 kiro-cli login 則只會顯示 Builder ID 登入方式或企業登入方式，您可以選擇 Builder ID 使用電子郵件註冊登入

執行 MCP Tool 時報錯#

報錯：Improperly formed request 或 An unexpected error occurred

通常是 MCP Tool 的描述格式不規範，特別是 input_schema 欄位，需要嚴格保證為合法的 JSON Schema

可以使用 /tools schema 子指令查看 MCP Tool 的描述，確認 input_schema 欄位是否合法

使用蘋果原生 Terminal 時當機#

建議使用 iTerm2 作為 Terminal 來使用 Kiro CLI。

如果需要排查當機原因，可以嘗試使用此腳本收集 Terminal 日誌後交給 Kiro CLI 來排查