Roo Code 是強大的開源 AI 編程助手，能將自主開發能力直接帶到你的 VSCode 編輯器中。擁有超過 130 萬次安裝量，以及活躍的開發者社群，Roo Code 以其靈活性、多模型支援，以及能讓 AI 代理保持專注、提升效率的角色專屬模式脫穎而出。
在本指南中，我們將教你如何整合 Novita AI 的 LLM API 與 Roo Code，讓你能在熟悉的 VSCode 環境中，以實惠價格使用 Moonshot AI 的 Kimi、DeepSeek 等前沿模型。
為什麼選擇 Roo Code + Novita AI？
Roo Code：你專屬的 VSCode AI 開發團隊
Roo Code 不只是簡單的自動補全工具，它是一款代理式編程助手，能夠：
- 根據自然語言描述生成程式碼
- 跨多個檔案重構和除錯現有程式碼庫
- 撰寫文件，並回答你關於程式碼的問題
- 執行指令和運行測試（需經你批准）
- 透過專屬模式（Architect、Code、Debug、Ask、Test）適應你的工作流程
不同於 Cursor、Windsurf 等專有工具，Roo Code 具備以下優勢： ✅ 完全開源（Apache 2.0 授權） ✅ 與模型無關（支援 10+ 供應商，包含 OpenAI、Anthropic、Google 和 Novita AI） ✅ 隱私優先（除非你主動將程式碼傳送至外部 API，否則你的程式碼永遠不會離開你的裝置） ✅ 社群驅動（GitHub 星標數超過 22.5k，擁有活躍的 Discord 社群）
Novita AI：高性價比的 LLM 存取方案
Novita AI 為開發者提供對先進語言模型的友善存取，特色包括：
- 具競爭力的透明隨用隨付計費費率
- 豐富的模型選擇（100+ 款模型，包含 DeepSeek、Moonshot AI、Qwen 等）
- 相容 OpenAI 的 API（可無縫替換現有程式碼）
- 高可靠性、低延遲的模型服務
前置需求
開始之前，請確保你已完成以下準備：
已安裝 VSCode
從官方網站下載最新版本的 Visual Studio Code。
Novita AI 帳號與 API 金鑰
整合步驟
步驟 1：安裝 Roo Code 擴充套件
- 打開 VSCode，前往擴充套件面板。
- 在 marketplace 中搜尋「Roo Code」。
- 點擊 Roo Veterinary Inc 開發的擴充套件（ID：
RooVeterinaryInc.roo-cline）的「安裝」按鈕。 - 安裝完成後，VSCode 側邊欄會出現 Roo Code 圖示（袋鼠圖案）。
步驟 2：設定第三方供應商（Novita AI）
擴充套件安裝完成後，你需要將它連接到 Novita AI 的 API：
- 點擊側邊欄的 Roo Code 圖示開啟面板。
- 在設定畫面中，你會看到兩個選項：
- Roo Code Router（需要 Roo Code 帳號）
- 第三方供應商（使用你自己的 API 金鑰）
- 選擇「第三方供應商」。
- 填寫設定欄位：
- API 供應商：選擇 OpenAI Compatible
- Base URL：
https://api.novita.ai/openai - API Key：貼上你的 Novita AI API 金鑰（來自前置需求步驟 2）
- Model：輸入你想要的模型名稱（例如
moonshotai/kimi-k2.5）
- 🎉 備註：你可以在Novita AI 模型頁面找到完整的可用模型清單。
步驟 3：測試整合
讓我們驗證 Roo Code 是否能與 Novita AI 正常通訊：
- 在 VSCode 中打開現有專案，或建立新檔案。
- 開啟 Roo Code 面板（點擊袋鼠圖示）。
- 在聊天介面中輸入簡單的請求
- 等待 AI 回覆，你應該會看到：
- 「Thinking」指示器（API 請求進行中）
- 模型回覆（例如「你好！我現在處於 Architect 模式，準備協助你進行規劃…」）
了解 Roo Code 模式
Roo Code 最強大的功能之一就是模式系統。模式能讓 AI 專注於特定任務，並限制工具存取僅限相關功能，從而減少幻覺、防止非預期的變更。
可用模式
| 模式 | 用途 | 適用時機 |
| Architect | 規劃與設計（不修改程式碼） | 開始新功能、設計系統架構、拆解複雜任務時 |
| Code | 實作與重構 | 撰寫新程式碼、重構現有檔案、進行多檔案編輯時 |
| Ask | 問答與解釋（唯讀） | 想了解程式碼運作方式、取得快速解答、生成文件時 |
| Debug | 診斷與修復 | 追蹤錯誤、新增日誌、隔離根本原因時 |
| Orchestrator | 跨模式協調任務 | 工作橫跨多個階段或角色時，例如：先規劃、再實作、最後除錯；處理大型/複雜請求；將大型功能拆分為平行子任務；或希望 Roo 自動管理 Architect / Code / Debug 之間的交接時 |
疑難排解
錯誤：「Invalid API key」
解決方案：
- 再次檢查你從 Novita AI 複製的 API 金鑰是否正確。
- 確保金鑰前後沒有多餘的空格。
- 確認金鑰尚未過期（如有需要請重新生成）。
Roo Code 反應緩慢或無回應
解決方案：
- 檢查你的網路連線。
- 減少上下文中的檔案數量（使用
.rooignore排除大型目錄）。
結論
你已經成功在 VSCode 中整合了 Novita AI 與 Roo Code！這個強大的組合能讓你在沒有供應商鎖定的前提下，享有靈活的 AI 模型存取、高性價比的開發體驗，以及完整的隱私控制。
準備好開始開發了嗎？試著請 Roo Code 重構複雜函式、生成單元測試，或除錯棘手的錯誤。更多教學和社群支援請造訪Roo Code 官方文件並加入Discord 社群。
祝你編程愉快！ 🦘
Novita AI 是一個 AI 雲端平台，為開發者提供簡單的 API 介面部署 AI 模型，同時也提供實惠、可靠的 GPU 雲端服務，用於建構和擴展 AI 應用。
常見問題
什麼是 Roo Code？ Roo Code 是專為 VSCode 設計的開源 AI 編程助手，能為你的編輯器帶來自主開發能力。它可以生成程式碼、跨多個檔案重構、撰寫文件、除錯問題，以及執行指令，所有操作都可以透過自然語言互動完成。不同於自動補全工具，Roo Code 是一款代理式助手，具備角色專屬模式（Architect、Code、Debug、Ask、Test），能讓 AI 專注於特定任務。
Roo Code 是免費的嗎？ 是的，Roo Code 本身是免費且開源的。你可以搭配以下方式使用： - 來自 Novita AI 等供應商的自有 API 金鑰（隨用隨付計費） - Roo Code Router（Roo Code 的官方服務） - Ollama 本地模型（免費，在你的裝置上運行）
Roo Code 比 Cursor 更好嗎？ Roo Code 和 Cursor 功能相似，但各有優勢。Roo Code 完全開源且與模型無關，這表示你可以使用任何 AI 供應商（OpenAI、Anthropic、Novita AI 等），不會被單一供應商綁定。Cursor 則提供更精緻、整合度更高的體驗，但需要訂閱其服務，且模型選擇受限。如果你重視靈活性、成本控制，以及開源價值，Roo Code 是更好的選擇。
