Roo Code 是一款 AI 編碼工具，可以幫助你集中管理編碼任務並連接外部服務。學會如何將 API 連接到 Roo Code，能幫助你串接 Kimi API 等工具，讓工作流程更順暢。這是為 Roo Code 增添更多 AI 功能、使其在不同開發任務中更實用的簡單方法。繼續閱讀，了解具體的操作步驟。
什麼是 Roo Code？
Roo Code 是一款為 VS Code 打造的開源 AI 編碼代理，能幫助開發者更高效地撰寫、編輯與管理程式碼。它直接運作於你的 IDE 之中，因此你無需離開日常的開發環境就能使用 AI 支援。Roo Code 可以協助生成程式碼、除錯、重構、更新文件，並回答有關你專案的問題。
Roo Code 能為你做些什麼？
在連接 API 之前，先了解 Roo Code 為何實用會有所幫助。它不僅僅是 VS Code 中的基本編碼助手。它能處理各種開發任務，支援日常編碼工作，並在開發過程中節省時間。以下更詳細地介紹 Roo Code 能為你做些什麼：
根據描述生成程式碼
Roo Code 可以將簡單的自然語言提示轉換成實際的程式碼，讓你更快建立功能。你只需用簡單的文字描述所需內容，它就會根據你的需求生成程式碼。這對建立函式、小型工具或啟動新的專案模組都很有幫助。
重構與除錯程式碼
它可以檢查現有程式碼、清理並改善結構，同時不改變程式碼的主要用途。Roo Code 還能協助找出錯誤、修正問題，並就有問題的部分提出更好的寫法建議。這讓提升程式碼品質、更快解決問題變得更容易。
撰寫與更新文件
Roo Code 可以幫助你為專案建立文件，包括設定指南、說明文字和程式碼註解。當程式碼有變動時，它也能更新舊的文件，讓專案文件保持實用且清晰。這節省了時間，也讓專案資訊保持條理。
回答有關程式碼庫的問題
如果你正在處理一個大型專案，Roo Code 可以幫助說明檔案、函式，以及程式碼庫中各部分之間的連結方式。你不必手動逐一檢查，而是可以直接提問，更快獲得答案。這讓理解陌生的程式碼變得更容易。
執行終端機命令
Roo Code 還能在你的工作流程中執行終端機命令，這對安裝套件、執行腳本或處理專案設定步驟等任務很有幫助。這能讓更多開發工作集中在同一個地方進行，也讓重複性任務更容易處理。
如何將外部 LLM 連接到 Roo Code？
Roo Code 可以透過其 API 設定連接外部 LLM，讓你在 VS Code 中使用自己選擇的模型。具體步驟可能因服務商而略有不同，但整體流程大致相同。以下步驟以 Kimi 為例，讓你了解整個設定過程是如何從頭到尾進行的：
注意： 根據 Roo Code 官方文件，Roo Code 擴充功能已於 2026 年 5 月 15 日下架。如果你已經安裝了它，或是正在使用某個分支版本，設定方式基本上仍然如下。
第 1 步：取得你的 Kimi API 金鑰
前往 Kimi API 平台，登入你的帳號，並建立一組新的 API 金鑰。金鑰出現後，將其複製並妥善保存，因為在設定 Roo Code 時你會需要貼上它。這組金鑰能將 Roo Code 連接到你的 Kimi 帳號，讓它能向模型發送請求。
第 2 步：開啟 Roo Code 設定
開啟 VS Code，並從側邊欄點選 Roo Code 面板。接著點擊齒輪圖示，開啟設定區塊。這裡存放著 Roo Code 用於外部 LLM 連接的服務商、API 金鑰、基礎網址及模型設定。
第 3 步：選擇 API 服務商
在 Roo Code 設定中，找到 API Provider 欄位。如果看到 Moonshot 選項，請選擇它，因為這是直接連接 Kimi API 最簡單的方式。這會告訴 Roo Code 在發送提示詞與接收回應時應使用哪個服務。
第 4 步:貼上你的 Kimi API 密鑰
選好供應商後,把你的 Kimi API 密鑰貼到 Moonshot API key 欄位中。如果 Roo Code 要求填寫 base URL,也要一併確認。對於全球版 Kimi API,正確的 base URL 是:https://api.moonshot.ai/v1
這一步會把你的 Roo Code 設定連結到 Kimi API 端點,讓擴充功能可以與模型溝通。
第 5 步:選擇 Kimi 模型
接著,從模型欄位中選擇一個 Kimi 模型,如有需要也可以手動輸入。若是用於開發工作,kimi-k2.7-code 是不錯的選擇,因為它專為程式編寫任務打造。選定後,Roo Code 就會用這個模型來處理提示詞、程式碼協助以及與專案相關的請求。
第 6 步:如果沒有 Moonshot 選項,改用 OpenAI Compatible
有些 Roo Code 版本或分支可能不會顯示 Moonshot 作為供應商選項。這種情況下,選擇 OpenAI Compatible,並手動輸入 Kimi API 的相關資訊。請使用以下數值:
API 供應商:OpenAI Compatible
Base URL:https://api.moonshot.ai/v1
API Key:你的 Kimi API 密鑰
Model ID:kimi-k2.7-code
第 7 步:儲存並測試
儲存設定後,向 Roo Code 發送一個簡單的請求,例如:
如果 Roo Code 能正常回覆,就代表你的 Kimi API 連線已經成功。
使用 Kimi API 的好處
Kimi API 能處理常規的程式編寫任務,並提供實用的程式碼協助,幫助軟體開發變得更有效率。看看下面這些好處,了解它能如何改善你的工作流程:
減少重複的手動工作
自動化常見任務,例如撰寫樣板程式碼、解釋函式功能、排查錯誤,藉此加快開發速度。這有助於減少編寫程式時那些瑣碎卻耗時的工作,讓你能把更多時間花在功能建置與問題解決上。
提升程式碼品質與一致性
分析現有的實作方式,找出潛在的改進空間,並在整個開發過程中支援更好的編碼實踐。這有助於讓你的程式碼在不同檔案和專案區塊中保持乾淨、易讀且一致。
提升工作流程的靈活性
使用 Kimi 進行程式碼生成、專案探索、重構、文件撰寫等多種開發活動,而不需要改變你原本的工作流程。它讓你用同一套設定就能支援不同的程式編寫任務,使日常開發更順暢、更容易管理。
排查 Roo Code API 整合問題
即使設定已經完成,一些小的配置錯誤仍可能導致連線無法正常運作。當你的 Roo Code API 設定沒有按預期回應時,問題通常與 API 密鑰、base URL、模型名稱或工具設定有關。檢查以下這些常見問題,能幫助你更快修復連線,讓 Roo Code 重新正常運作:
無效的 API 密鑰:重新產生並重新貼上
錯誤或過期的 API 密鑰,是連線失敗最常見的原因之一。如果 Roo Code 無法驗證你的請求,回到供應商的控制台,產生一組新的密鑰,再重新貼到正確的 API key 欄位中。同時也要確認密鑰前後沒有多餘的空格。
錯誤的 Base URL:複製正確的端點
Base URL 必須與供應商正確的 API 端點一致,否則 Roo Code 無法得知該把請求送往何處。即使 URL 中有一個小錯誤,也可能導致連線中斷。從供應商的官方文件中複製正確的端點,取代設定中原有的內容。
不支援的模型 ID:使用完全正確的名稱
如果模型 ID 輸入有誤,或所選模型不受你的設定支援,請求可能會失敗或回傳錯誤。請從供應商的文件中確認模型名稱,並在 Roo Code 設定中使用完全一致的拼寫,包括連字號、版本名稱以及特定於程式編寫的模型標籤。
工具呼叫失敗:啟用原生工具呼叫
如果工具呼叫功能被關閉,或目前的設定不支援該功能,某些功能可能無法正常運作。這種情況下,請檢查 Roo Code 或供應商的設定,如果模型支援,就啟用原生工具呼叫。這有助於解決動作、指令或結構化工具回應無法正常運作的問題。
速率限制錯誤:檢查餘額與模型
當你達到請求次數上限、使用了限制較嚴格的模型,或遇到帳戶使用限制時,可能會出現速率限制錯誤。請檢查你的供應商帳戶,看看餘額、配額或目前模型的限制是否是問題所在。切換到另一個受支援的模型,在某些情況下也有幫助。
結語
了解如何把 API 密鑰連接到 Roo Code,能讓你更輕鬆地把外部 AI 支援帶入程式編寫工作流程,而不會增加額外的複雜度。一旦正確完成設定,Roo Code 在 VS Code 中就能更靈活地應對各種開發任務。關鍵在於一開始就要使用正確的供應商設定、模型資訊和 API 配置。如果你想要更順暢的編碼體驗,Kimi 是值得一試的選項。試著搭配 Roo Code 使用,看看它如何融入你的工作流程。