準備工作

在使用 Kimi Code 之前，你需要了解幾個基礎概念。這些知識能幫助你更順暢地安裝和使用 Kimi Code。

終端是什麼

終端是一個透過輸入文字命令來操作電腦的視窗。

你可以把它理解為一個"文字版的檔案管理器"：在終端裡，你透過輸入命令（如 ls、cd、mkdir）來檢視資料夾內容、切換目錄、建立檔案等，而不是用滑鼠點選圖示。

怎麼開啟終端

怎麼檢視自己的作業系統

• macOS：點選螢幕左上角的蘋果圖示 → "關於本機"
• Windows：按 Win + Pause/Break 鍵，或右鍵點選"此電腦" → "屬性"
• Linux：在終端中執行 uname -a 或 cat /etc/os-release

PowerShell 是什麼

PowerShell 是 Windows 上常用的終端工具，功能比普通命令提示符（CMD）更強大。本文提供的 Windows 安裝命令需要在 PowerShell 中執行。

Windows 上有兩個不同的"命令列"工具，不要混淆：

提示：Kimi Code CLI 的安裝命令需要在 PowerShell 中執行，CMD 中可能無法正常執行。

工作目錄

Kimi Code CLI 啟動時會以你當前所在的資料夾作為工作目錄，工作目錄用於確定專案上下文與工作區範圍，不應把它理解為對所有命令和工具的完整隔離邊界。具體審批行為取決於許可權模式，見互動與輸入。

啟動前先確認終端的當前路徑：

• 終端提示符通常會顯示當前目錄，如 ~/projects/my-app$
• 輸入 pwd（macOS/Linux）或 Get-Location（PowerShell）可檢視完整路徑
• 用 cd 資料夾名 進入目標專案目錄後再執行 kimi

示例：假設你的專案在 ~/Documents/my-project，啟動流程是：

1. 開啟終端
2. 輸入 cd ~/Documents/my-project
3. 輸入 kimi 啟動

命令怎麼執行

在終端或 PowerShell 中執行命令很簡單：

1. 複製命令：從文件中複製命令文字
   • macOS/Linux：curl -fsSL https://code.kimi.com/kimi-code/install.sh | bash
   • Windows：irm https://code.kimi.com/kimi-code/install.ps1 | iex
2. 貼上到終端：在終端視窗中按右鍵或 Cmd/Ctrl + V 貼上
3. 按下回車：按 Enter 鍵執行命令
4. 等待完成：終端會顯示執行過程和結果

注意：在終端中，Ctrl+C 通常是中斷當前命令，而不是複製。複製請用 Cmd/Ctrl + Shift + C，貼上用 Cmd/Ctrl + Shift + V，或直接用滑鼠右鍵選單。

提示：如果命令執行過程中需要輸入密碼，終端不會顯示任何字元（這是正常的安全機制），直接輸入後回車即可。

CLI 是什麼

CLI 是 Command-Line Interface（命令列介面）的縮寫，意思是透過輸入文字命令來使用工具，而不是透過圖形介面點選按鈕。

Kimi Code CLI 就是一個命令列工具：你在終端中輸入 kimi 啟動它，然後透過文字命令與 AI 互動，讓它幫你閱讀程式碼、修改檔案、執行命令等。

網路環境

使用 Kimi Code 需要能夠訪問 Kimi 的伺服器。如果你的網路環境有以下限制，可能需要調整：

• 公司/學校網路：部分內網環境可能限制訪問外部 API。如有代理，可在配置中設定代理地址。
• VPN/代理：如果使用了全域性代理，確保代理不會攔截或干擾到 api.kimi.com 或 api.moonshot.cn 的請求。
• 防火牆：檢查系統或路由器防火牆是否阻止了終端程式的網路訪問。

安全注意事項

Kimi Code CLI 是一個功能強大的 AI Agent，它可能會：

• 讀取你電腦上的檔案內容
• 修改你的程式碼和配置檔案
• 執行Shell 命令（如安裝依賴、執行測試）

在使用時請注意：

• 不要在敏感目錄中啟動：避免在包含密碼、金鑰、個人隱私檔案的目錄中執行 Kimi Code CLI。
• 仔細審查操作：Kimi Code 提供“始終詢問”“必要時詢問”“完全自動”三檔許可權模式。使用前確認當前模式，並仔細審查需要批准的操作。
• 先理解再執行：如果你不確定某個操作的影響，可以讓 Kimi Code 先解釋清楚這個操作會做什麼，再決定是否繼續。
• 備份重要程式碼：在對重要專案使用 Kimi Code 之前，建議先提交程式碼到版本控制（如 Git），以便隨時回退。

建議：初次使用時，可以在一個測試專案或副本專案中熟悉 Kimi Code CLI 的工作方式，熟悉後再用於正式專案。