Kiro IDE on Book of Kiro

開始使用

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

開始使用 Kiro IDE#

🚀 快速上手 - 5 分鐘啟動 Kiro IDE！#

最速安裝指南（真的只要 5 分鐘）#

首先，我們來安裝 Kiro IDE。不過別緊張，和安裝普通 App 一樣簡單！

下載 Kiro IDE 造訪 https://kiro.dev/downloads 下載適合您系統的版本

安裝 IDE macOS：將下載的 Kiro.app 拖到 Applications 資料夾
Windows：雙擊下載的安裝程式執行
Linux：為 AppImage 新增執行權限後啟動

初次啟動時的設定（這裡超重要！）

🔐 登入方式選擇#

GitHub：如果你是個人開發者，選這個最輕鬆
Google：用 Gmail 帳號一鍵登入
AWS Builder ID：沒有 AWS 帳號？選這個就對了（而且完全免費）
AWS IAM Identity Center：適合在公司或團隊環境中使用

⚙️ 匯入 VS Code 設定#

選擇「Import VS Code Settings」可以直接繼承你現在的編輯器設定，包括擴充外掛、主題樣式都能原樣複用，真的很方便！

💻 啟用 Shell 整合（必選項！）#

出現提示時，請一定要點擊「Allow」！
這一步能讓 AI 直接執行終端機命令，解鎖全自動開發體驗 🚀

📂 來開啟你的第一個專案吧！#

# 如果你喜歡用終端機開啟專案的話：
cd my-project
kiro .

# 或者也可以從 Kiro 的選單列操作：
File > Open Folder > 選擇你的專案資料夾

開啟專案後，點擊左側邊欄那個 Kiro 的幽靈圖示。這就是 Kiro 的核心區域，也是你和 AI 開始對話的地方！👻

外掛管理

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

外掛管理#

外掛可以為 Kiro 提供額外的語言支援，實現跳轉到定義、跳轉到實現等功能。

從 Kiro 的外掛市集安裝#

在左側導覽列中，點擊 Extensions 圖示，介面左側顯示外掛面板，您可在面板中搜尋需要使用的外掛並安裝。

從 VSCode 的外掛市集安裝#

由於 Kiro 使用 OpenVSX Registry 管理外掛，有些 VSCode 中的外掛可能無法在 Kiro 外掛市集中找到。您可以從 VSCode 外掛市集中下載 VSIX 檔案然後手動安裝。

使用 Chrome 瀏覽器外掛下載外掛#

下載外掛最簡單的方式是安裝 Visual Studio Marketplace Downloader Chrome 瀏覽器外掛，安裝後在 Visual Studio Marketplace 會出現 Download 按鈕，點擊即可下載對應的外掛。

前往 Visual Studio Marketplace Downloader Chrome 瀏覽器外掛頁面安裝外掛。
前往 VS Code 的外掛市集。
搜尋你想要的外掛，例如：Deno。
在搜尋結果中，點擊你所需的外掛。你會前往該外掛的詳情頁。
點擊詳情頁中的 Download 按鈕即可下載外掛。

此方法下載的外掛檔案，副檔名為 .zip，重新命名副檔名為 .vsix 即可使用。

手動拼接 URL 下載外掛#

前往 VS Code 的外掛市集。
搜尋你想要的外掛，例如：Deno。
在搜尋結果中，點擊你所需的外掛。你會前往該外掛的詳情頁。
在詳情頁中，點擊 Version History。
結合外掛頁的 URL 和 Version History 中的資訊，提取出以下資訊（以 Deno 為例）：
- itemName：URL Query 中的 itemName 欄位，如 Deno 的 itemName 為 denoland.vscode-deno，並將小數點（.）前後的內容分成以下兩個欄位：
  - fieldA：denoland
  - fieldB：vscode-deno
- version：如截圖中的 3.43.3
使用提取出來的 3 個欄位的值替換下方 URL 中的同名欄位。
- 範本：https://marketplace.visualstudio.com/_apis/public/gallery/publishers/${itemName.fieldA}/vsextensions/${itemName.fieldB}/${version}/vspackage
- 範例：https://marketplace.visualstudio.com/_apis/public/gallery/publishers/denoland/vsextensions/vscode-deno/3.43.3/vspackage
在瀏覽器中輸入修改後的 URL，然後按下 Enter 鍵。瀏覽器開始下載該外掛。

在 Kiro 中安裝 VSIX 外掛#

在外掛面板選項中點擊 Install from VSIX 即可選擇本機外掛檔案進行安裝。

常見問題

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

Kiro IDE 常見問題#

重要提示：Agent 自主性設定（Autopilot vs Supervised 模式）和受信任命令管理已移至開始使用頁面，建議先閱讀該部分內容。

資料隱私與遙測#

如何關閉 Kiro IDE 的遙測功能？#

有兩種方法可以關閉遙測：

方法 1：透過設定介面

Settings → Application → Telemetry and Content → 關閉（Disabled）

方法 2：透過 settings.json 設定

{
 "telemetry": {
 "enabled": false
 },
 "usageStatisticsEnabled": false
}

如何為不同專案設定不同的隱私設定？#

Kiro 支援全域和專案級別的設定：

# 全域設定（適用於所有專案）
~/.kiro/settings.json

# 專案專屬設定（優先級更高）
.kiro/settings.json

注意：如果專案設定包含 API 金鑰等敏感資訊，建議將 .kiro/settings.json 新增到 .gitignore 檔案中。

聊天歷史記錄位置#

Kiro IDE 的聊天記錄儲存在哪裡？#

聊天記錄以 JSON 格式儲存在以下位置：

Windows: ~\AppData\Roaming\Kiro\User\globalStorage\kiro.kiroagent\<userid>\*.chat
macOS: ~/Library/Application Support/Kiro/User/globalStorage/kiro.kiroagent/<userid>/*.chat
Linux: ~/.config/Kiro/User/globalStorage/kiro.kiroagent/<userid>/*.chat

可以匯出聊天歷史記錄嗎？#

目前 Kiro 還沒有聊天會話匯出功能，但您可以直接存取上述路徑中的 JSON 檔案來取得原始聊天資料。

疑難排解

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

Kiro IDE 常見問題#

Error streaming response: Cannot read properties of undefined (reading ‘model’)#

請嘗試重新啟動 IDE 並檢查系統網路狀態

GitHub Issue: https://github.com/kirodotdev/Kiro/issues/1147

Error streaming response: EntryNotFound (FileSystemError)#

請升級至最新版 IDE，並在新建立的會話中互動。舊版本的 Kiro 建立的聊天會話可能存在此問題。

GitHub Issue: https://github.com/kirodotdev/Kiro/issues/3897

CPU/記憶體佔用過高#

確保升級到 v0.6.0 版本以上
確保設定中 Codebase Indexing 已停用

原因：Codebase Indexing 功能會對專案檔案進行索引，可能會佔用較多的 CPU 和記憶體資源，特別在專案較大時，資源佔用尤為明顯。如果不需要該功能，建議停用以提升效能。v0.6.0 版本預設停用了此功能，並在設定中提供了開關選項。

上下文選單中沒有 `#Codebase` 和 `#Repository Map` 選項#

這兩個選項需要在設定中啟用 Codebase Indexing 才能啟動。但是需要注意：啟用 Codebase Indexing 後可能會導致 CPU/記憶體佔用過高。Agentic Coding 時代基於 Local RAG 的 Codebase indexing 不再是必選項，它會消耗額外效能（CPU 和記憶體），召回效果不穩定，並且可以使用 fs_search tool 或類似的 CLI 代替，甚至效果更好。所以並不建議使用

快速鍵

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

Kiro IDE 快速鍵完全掌握指南#

🎯 必記！超實用的 Kiro 快速鍵 TOP10#

只要先記住這幾個，基本上你就能用好 Kiro 的 80% 功能了：

想做的事	Mac 快速鍵	Windows / Linux 快速鍵	會發生什麼？
把選中的程式碼新增到新的對話中	Cmd + L	Ctrl + L	將選中的程式碼直接新增到新的對話中，開始和 AI 對話
把選中的程式碼新增到目前對話	Cmd + Shift + L	Ctrl + Shift + L	將選中的程式碼直接新增到目前開啟的對話中
選中程式碼精準編輯	Cmd + I	Ctrl + I	在游標處啟動 AI，可以邊寫程式碼邊提問
命令面板	Cmd + Shift + P	Ctrl + Shift + P	開啟命令面板，存取 Kiro 所有功能
開啟檔案	Cmd + P	Ctrl + P	輸入檔案名稱的一部分就能快速開啟
儲存檔案	Cmd + S	Ctrl + S	老朋友了，必須記
專案內搜尋	Cmd + Shift + F	Ctrl + Shift + F	在整個專案裡搜尋文字內容
跳轉到定義	F12	F12	一鍵跳轉到函式或類別的定義處
修復錯誤	懸停錯誤 → Quick fix	相同	AI 會自動給出修復建議
開啟終端機	Ctrl + （反引號 `）	Ctrl + （反引號 `）	顯示或隱藏整合終端機
顯示/隱藏側邊欄	Cmd + B	Ctrl + B	顯示或隱藏側邊欄，適合想全螢幕操作時使用

💡 實用又方便的小技巧快速鍵#

# 多游標編輯（學會它效率翻 3 倍）
Option + 點擊（Mac）/ Alt + 點擊（Windows）
→ 可以在多個位置同時出現游標，同時編輯多個地方

# 移動整行程式碼（超級實用的小技巧）
Option + ↑/↓（Mac）/ Alt + ↑/↓（Windows）
→ 整行程式碼上下移動，排版修改超方便

# 複製整行（寫測試資料時超好用）
Option + Shift + ↑/↓（Mac）/ Alt + Shift + ↑/↓（Windows）
→ 直接複製目前行並插入上下位置

# 快速註解（最常用，沒有之一）
Cmd + /（Mac）/ Ctrl + /（Windows）
→ 選中程式碼一鍵註解/取消註解，除錯神技！

Kiro IDE on Book of Kiro

開始使用

開始使用 Kiro IDE#

🚀 快速上手 - 5 分鐘啟動 Kiro IDE！#

最速安裝指南（真的只要 5 分鐘）#

🔐 登入方式選擇#

⚙️ 匯入 VS Code 設定#

💻 啟用 Shell 整合（必選項！）#

📂 來開啟你的第一個專案吧！#

外掛管理

外掛管理#

從 Kiro 的外掛市集安裝#

從 VSCode 的外掛市集安裝#

使用 Chrome 瀏覽器外掛下載外掛#

手動拼接 URL 下載外掛#

在 Kiro 中安裝 VSIX 外掛#

常見問題

Kiro IDE 常見問題#

資料隱私與遙測#

如何關閉 Kiro IDE 的遙測功能？#

如何為不同專案設定不同的隱私設定？#

聊天歷史記錄位置#

Kiro IDE 的聊天記錄儲存在哪裡？#

可以匯出聊天歷史記錄嗎？#

疑難排解

Kiro IDE 常見問題#

Error streaming response: Cannot read properties of undefined (reading ‘model’)#

Error streaming response: EntryNotFound (FileSystemError)#

CPU/記憶體佔用過高#

上下文選單中沒有 #Codebase 和 #Repository Map 選項#

快速鍵

Kiro IDE 快速鍵完全掌握指南#

🎯 必記！超實用的 Kiro 快速鍵 TOP10#

💡 實用又方便的小技巧快速鍵#

上下文選單中沒有 `#Codebase` 和 `#Repository Map` 選項#