什麼是基洛代碼？
Kilo AI 的 Kilo Code 是一款開源 AI 編碼代理，可在 VS Code、JetBrains 和 CLI 中使用，並具有可設定的模型提供者。
本 Kilo Code 設定指南使用其 OpenAI 相容的提供者控制項來連接 TokenHub。從唯讀任務開始，然後使用支援工具的模型驗證編輯和命令。 Kilo Code 在 VS Code、JetBrains 和 CLI 中公開相關工作流程，但這些用戶端之間的設定範圍可能有所不同。確認您實際使用的用戶端中的活動設定檔和提供程序，然後比較代表性儲存庫任務的模型品質、工具可靠性、延遲、上下文長度和成本。
Kilo Code 可以透過 TokenHub 的 OpenAI compatible 相容 API 中轉模型請求。本文保留官方安裝方式，並只替換 API key、Base URL 和模型 ID。
本指南使用的 TokenHub endpoint 是 https://us-api.tokenhub.com/v1/chat/completions。
何時使用
適合先在小型倉庫或測試專案中驗證。先讓工具讀檔、解釋程式碼或產生方案，再逐步開啟修改和自動化任務。
安裝或開啟工具
先依照 Kilo Code 官方文件 安裝或開啟工具。版本不同時，請以官方文件目前的入口為準。
對於 CLI 工具，先確認可執行檔可用，再加入 TokenHub 憑證：
# open the tool, then open its model or provider settings準備 TokenHub 憑證
建立 TokenHub API key，並在 TokenHub 模型列表中選擇一個適合這個工具的模型。
export TOKENHUB_API_KEY="sk-..."請將金鑰保存在本機 shell、IDE 的密鑰儲存或工具的安全 API key 欄位中，不要提交到程式碼倉庫。
設定 TokenHub 服務商
在工具的模型、供應商、API Keys 或 OpenAI Compatible 設定頁面中填入下列值。
服務商填寫值
| 欄位 | 填寫值 |
|---|---|
| 供應商 | OpenAI Compatible 或 Custom |
| Base URL | https://us-api.tokenhub.com/v1 |
| API Key | TOKENHUB_API_KEY 的值 |
| 模型 | gpt-4.1 或其他 TokenHub 模型 ID |
設定檔位置
| 欄位 | 填寫值 |
|---|---|
| Provider settings | Kilo Code → Providers → Custom provider |
| Provider API | OpenAI Compatible |
| Required fields | Provider ID, Base URL, API Key, Model ID |
Save the custom provider in Kilo Code, let it fetch /v1/models when available, or add the TokenHub model ID manually. Verify a chat request before enabling agent edits.
如果工具將 chat、edit、apply 和 fast model 分開，第一次測試先全部使用同一個 TokenHub 模型。確認可用後，再依成本、延遲和推理能力拆分。
臨時環境變數只用於排錯
外掛擁有自己的設定 schema 時，優先使用設定 UI。UI 會把同樣的值寫入使用者設定檔，也能避免猜測不同版本可能變動的私有 key。
臨時變數適合確認 Key、網路和模型名。驗證通過後，請把同樣的值寫回上方的持久設定。
驗證連線
先使用唯讀提示測試，確認模型能讀取上下文且不會改動檔案。成功後再測試編輯、Apply 或 Agent 任務。
閱讀目前專案的 README，請用三句話總結。不要修改任何檔案。提示成功後，回到 TokenHub 請求記錄確認模型名稱、endpoint、token 用量和計費分組。
常見問題
| 現象 | 處理方式 |
|---|---|
| 401 或驗證失敗 | 確認 TOKENHUB_API_KEY 有效，且保存在同一個 terminal、IDE 或用戶端設定檔中。 |
| 404 或找不到模型 | 使用 TokenHub 工作區中存在，且符合所選協議的模型 ID。 |
| endpoint 不正確 | Base URL 必須與上方一致。OpenAI 相容工具通常需要 /v1；Claude 相容工具通常不需要。 |
| 請求逾時 | 檢查到 https://us-api.tokenhub.com 的網路、代理設定，以及工作區 allowlist。 |
| 工具使用了其他模型 | 重新檢查 chat、edit、apply、fast 或 autocomplete 等所有模型欄位。 |
如何選擇推薦模型？
Kilo Code 自訂 API 常見問題解答
為什麼 Kilo Code 無法讀取 TokenHub 型號清單？
自動模型發現失敗並不一定意味著 API 不可用。從 TokenHub 複製準確的型號 ID 並手動輸入。
如果聊天可以工作但 Tab 補全功能不行怎麼辦？
Chat 和 Tab 可以使用不同的模型槽。為Tab配置一個低延遲、相容完成的模型並單獨驗證。
為什麼IDE無法讀取TOKENHUB_API_KEY？
從桌面圖示啟動的 IDE 可能不會繼承終端機環境變數。使用 Kilo Code 的安全 API 金鑰欄位完成初始驗證。
Kilo Code CLI 和 IDE 擴充是否共用一種模型配置？
它們可以使用相同的 TokenHub 模型，但配置範圍和設定檔可能不同。驗證每個用戶端中的基本 URL、金鑰、模型和活動設定檔。
如果 Kilo Code 可以聊天但不能編輯程式碼怎麼辦？
確認模型支援本機工具呼叫和結構化參數，然後檢查編輯權限和命令批准。基本文字產生不會驗證代理工具鏈。
參考資料
本頁設定依據 TokenHub 教學與官方資料，最後驗證日期為 2026-09-04。
