想使用自己的 AI 模型進行程式開發，又不想面對複雜設定嗎？Droid 的 CLI 支援外部 API，讓您能連接符合工作流程的自訂模型。本指南將說明如何設定 API、解決常見問題，以及在 Droid 中使用 Kimi。繼續閱讀即可開始。
什麼是 Droid？
Droid 是一款 AI 程式開發工具，可協助開發人員撰寫程式碼、解決錯誤，並更有效率地處理開發工作。它支援內建 AI 模型，也讓使用者透過 CLI 連接自訂模型，提供更大的彈性。無論您需要快速協助，還是更個人化的設定，它都適用於不同的程式開發工作流程。
如何在 Droid 中使用內建 AI 模型？
內建 AI 模型讓您能輕鬆開始使用 Droid 進行程式開發，因為無需先連接任何外部 API。安裝應用程式後，您可在平台內選擇模型，開始使用 AI 協助進行程式碼分析、功能開發、錯誤修正與程式碼審查。以下說明如何開始使用 Droid：
步驟 1：安裝並開啟 Droid
首先，在您的裝置上下載 Factory App 並完成安裝。接著開啟應用程式，登入您的帳戶。如此即可在應用程式中使用 Droid 及其內建 AI 功能。
步驟 2：將 Droid 連接至您的專案資料夾
將工作目錄設為您想處理的程式碼庫。這會將 Droid 與您的本機專案連接，使其能讀取檔案、理解程式碼結構，並在掌握更多脈絡的情況下協助您的開發工作。
步驟 3：選擇內建模型並開始輸入提示詞
開啟模型選擇器，從 Droid 提供的內建 AI 模型中選擇一個。選好模型後，您就能開始輸入提示詞，例如請它分析程式碼庫、修正錯誤、審查程式碼或開發功能。
如何將 Droid 連接至外部 API？
將 Droid 連接至外部 API，您就能使用偏好的模型，不再侷限於內建選項。設定是在 Droid CLI 中進行，您只需在設定檔中新增自訂模型；儲存後，該模型便會出現在 /model 選單中。以下以 Kimi 為簡單範例，讓您了解從 API 金鑰到選擇模型的完整設定流程：
步驟 1：從 Moonshot AI 取得 Kimi API 金鑰
首先，從 Moonshot AI 建立或複製您的Kimi API 金鑰。您需要這把金鑰，因為 Droid 會用它連接 Kimi API，並透過您的帳戶傳送請求。建議將金鑰儲存為 MOONSHOT_API_KEY 等環境變數，以便在設定檔中安全使用。
步驟 2：開啟 Droid 設定檔
接著，開啟在 Droid CLI 中新增自訂模型的設定檔。在 macOS 上，檔案路徑為 ~/.factory/settings.json。在 Windows PowerShell 上，請使用 %USERPROFILE%\.factory\settings.json。這是 Droid 讀取自訂模型設定的主要檔案。
步驟 3：將 Kimi 新增為自訂模型
在 settings.json 中，於 customModels 陣列下新增 Kimi。這會告訴 Droid 要使用哪個模型、應呼叫哪個 API 端點、採用哪種供應商格式，以及要用哪個 API 金鑰進行驗證。如果檔案中已有其他設定，請不要全部取代，只要將此模型物件加入既有的 customModels 陣列即可。
步驟 4：儲存檔案並重新啟動 Droid
新增設定後，請儲存檔案並重新啟動 Droid CLI。這可確保 Droid 重新載入更新後的設定，並正確識別新加入的自訂模型。
步驟 5：在 Droid 中使用 /model 選擇 Kimi 模型
開啟 Droid CLI 並執行 /model 指令。你的 Kimi 設定現在應會出現在「自訂模型」區塊中。從清單中選取它，讓 Kimi 成為本次程式設計工作階段的使用中模型。
步驟 6：執行任務
選取 Kimi 後，就可以開始在 Droid 中用它處理實際工作。你可以嘗試請它審查程式碼、修正錯誤，或解釋程式碼庫等提示詞。Droid 會透過 Kimi API 傳送請求，並使用該模型執行任務。
使用 Kimi API 的優點
將 Kimi 連接至 Droid 後，它不再只是 CLI 中的外部模型，而會成為能融入日常開發流程的實用程式設計助理，無論是小型程式設計工作或較大型的工程任務都能協助處理。以下是使用 Kimi API 的一些優點：
提升開發效率
Kimi 可在你工作時協助產生程式碼、解釋邏輯並提出修正建議，讓你更快完成日常程式設計任務。如此一來，處理簡單的開發支援需求時，無須在多個工具之間切換。在 Droid 中使用 Kimi，日常程式設計工作會更容易快速處理。
撰寫更可靠的程式碼
Kimi 可以審查你的程式碼、指出潛在問題，並在小錯誤演變成更大問題前協助改善結構。當你希望邏輯更清晰、程式碼更容易維護時，這類及早回饋相當實用。長期下來，它能協助你建立更容易測試、更新及理解的程式碼。
處理多樣的開發任務
Kimi 不僅能從零開始撰寫程式碼，也能協助重構、撰寫程式碼文件、理解不熟悉的專案，以及支援各類任務中的功能開發。對於希望由單一 AI 模型協助處理工作流程多個環節的開發者來說，這是靈活的選擇。
連接 API 時的常見錯誤排除
在 Droid 中連接外部 API 金鑰通常很簡單，但細小的設定錯誤仍可能造成問題。多數問題來自設定檔、供應商名稱、API 金鑰或模型伺服器設定，而非 Droid 本身。好消息是，只要知道該從何處檢查，這些錯誤通常很容易修正。
模型未顯示在選擇器中
檢查
~/.factory/settings.json的 JSON 語法；若使用舊版格式，則檢查config.json系統會透過檔案監看自動偵測設定變更
確認自訂模型設定中已填寫所有必要欄位
「Invalid provider」錯誤
確認 provider 值完全符合
anthropic、openai或generic-chat-completion-api檢查 provider 欄位是否有拼字錯誤，並確認大小寫是否正確
驗證錯誤
確認你的 API 金鑰有效，且仍有可用額度
檢查 API 金鑰是否具備該供應商所需的正確權限
確認 base URL 與供應商文件中的 API 端點一致
無法連接本機模型
確認本機模型伺服器正在執行，例如
ollama serve確認 base URL 正確，且供應商若有要求，URL 中包含
/v1/確認模型已經拉取，或可在本機使用
速率限制或配額錯誤
檢查供應商的 API 速率限制與使用配額
從供應商儀表板監控用量，確認是否已達限制
結語
在 Droid 中使用自訂 API，能讓你更自主地運用 AI 建置、測試及改善程式碼。完成設定後，就能更容易依照符合需求的模型調整程式設計流程。無論你選擇內建選項或連接外部模型，Droid 都提供彈性的方式將 AI 導入開發工作。若想從簡單的自訂設定開始，不妨在 Droid 中試試 Kimi。它是讓日常程式設計工作更順暢、更有效率的實用選擇。