文件
Kimi Code
Kimi Code 將提供者設定存放在 TOML 檔案中,第三方端點只需設定其中的三個鍵:type、base_url、api_key。將其中一個指向 Kunavo,CLI 就能透過它原本使用的通訊協定,呼叫 Claude 和 GPT 的模型 ID。
Kimi Code 將供應商保存在 ~/.kimi-code/config.toml — 將 providers.<name>.base_url 設為 https://api.kunavo.com/v1,並設定 type = "openai",CLI 即可透過一組金鑰執行 Claude 與 GPT ID。
default_model = "kunavo/claude-sonnet-5"
[providers.kunavo]
type = "openai"
base_url = "https://api.kunavo.com/v1"
api_key = "sk-kn-..."
[models."kunavo/claude-sonnet-5"]
provider = "kunavo"
model = "claude-sonnet-5"
max_context_size = 200000base_url 保留 /v1 後綴。提供者文件頁明確說明:type = "openai" 的文件預設值是 https://api.openai.com/v1,而環境變數頁面的第三方端點範例是 KIMI_MODEL_BASE_URL="https://api.example.com/v1"。Kimi Code 只會附加路由,因此此處若只填網域根網址,會出現 404,而不是驗證錯誤。這與採用 Anthropic 通訊協定的用戶端正好相反;後者需要不含後綴的 https://api.kunavo.com。export KIMI_API_KEY,不會讓任何提供者取得金鑰。文件列出的優先順序是 api_key 或 api_key_env——兩者互斥,請只設定其中一個;若兩者都未設定,則使用 [providers.kunavo.env] 子表格中的金鑰;若全部都未設定,啟動時會報錯。若要避免將金鑰寫入檔案,請設定 api_key_env = "KUNAVO_API_KEY",而非 api_key;若變數未設定或值為空,請求會失敗,並顯示該變數名稱。type 表示通訊協定,不代表供應商。文件列出的類型有 kimi、anthropic、openai、openai_responses、google-genai 和 vertexai——目前的表格中沒有舊版 OpenAI 類型,因此教你設定該類型的文章已不適用。選擇 openai,再填入 Claude 模型 ID,正是預期的搭配方式:模型 ID 會在 base URL 指向的端點解析,而不是由 CLI 解析。sk-kn- 開頭),並從 $10 起新增額度——呼叫會從該餘額扣款,失敗的呼叫不會計費。之後儀表板會開啟 Kimi Code 設定。逐步操作
- 在
/app/keys建立金鑰並複製——金鑰只會顯示一次。 - 開啟
~/.kimi-code/config.toml,此檔案會在首次執行時建立。若你使用KIMI_CODE_HOME移動資料目錄,檔案會位於$KIMI_CODE_HOME/config.toml;檔名一律是config.toml。 - 新增上方的
[providers.kunavo]表格。文件為此類型列出的三個鍵,依序是type、base_url和api_key。 - 在
[models."..."]下宣告模型別名,並設定provider、model和max_context_size——三者皆為必填。-m和default_model都要使用此別名;model的值則是傳送到線上的模型 ID。別名若包含句點,請加上引號。 - 第一次設定時,請省略
capabilities。提供者文件頁指出,系統會依模型名稱前綴自動比對能力;模型表格則說明,陣列只會新增項目,不會移除項目。因此,若標籤設錯,之後編輯設定也無法取消。 - 執行
kimi,或使用kimi -m kunavo/claude-sonnet-5為單一工作階段選擇別名。若要測試端點而完全不修改設定,請設定KIMI_MODEL_NAME、KIMI_MODEL_API_KEY、KIMI_MODEL_PROVIDER_TYPE=openai和KIMI_MODEL_BASE_URL——CLI 會在記憶體中建立提供者,不會寫回任何設定。
已於 2026年9月21日 根據 Kimi Code 的提供者與模型文件頁 進行確認。第三方設定會變動;如果這裡的欄位名稱不再與你看到的內容相符,應以該頁面為準,而不是本頁。
除錯用戶端前先驗證
一個請求就能判斷失敗原因是端點、金鑰還是設定檔。如果這裡回傳 JSON,則相同的基礎 URL 與金鑰在 Kimi Code 中也能運作。
# Settles whether a failure is the endpoint, the key, or the client.
curl -sS https://api.kunavo.com/v1/models \
-H "Authorization: Bearer sk-kn-..."欄位中應填入哪個模型 ID
每個文字模型都能以模型 ID 存取——即時清單位於 GET /v1/models,帶有價格的目錄位於模型頁面。費率是每 1M 權杖的美元價格,輸入/輸出。
| 模型 ID | Kunavo 輸入/輸出 | 它在 Kimi Code 中的位置 |
|---|---|---|
claude-sonnet-5 | $1.40 / $7.00 | 預設別名——用於反覆編輯與執行的工作模型 |
claude-opus-5 | $3.50 / $17.50 | 用於規劃工作的第二個別名;規劃錯誤的代價較高 |
claude-haiku-4-5 | $0.70 / $3.50 | 要設在 [secondary_ |
gpt-5-6-sol | $2.00 / $12.00 | 同一金鑰與同一提供者表格下,來自不同模型家族的第二意見 |
常見問題
如何讓 Kimi Code 使用自訂 API 端點?
在 ~/.kimi-code/config.toml 新增提供者表格,設定 type = "openai"、指向端點的 base_url,以及你的 api_key,接著在 [models."<alias>"] 下宣告模型別名,並填入 provider、model 和 max_context_size。Kimi Code 的提供者文件說明,type = "openai" 適用於 OpenAI Chat Completions 通訊協定,以及任何與其相容的第三方服務;如有需要,可以覆寫 base_url。你也可以在 TUI 中使用 /provider 開啟提供者管理器,但其已知提供者流程會從 models.dev 目錄匯入資料;若端點不在該目錄中,手動新增會更快。
Kimi Code 的 base_url 需要以 /v1 結尾嗎?
若使用 OpenAI 相容端點,則需要。Kimi Code 只會附加路由,因此 base_url 必須是 /v1 根路徑,例如 https://api.kunavo.com/v1。文件已明確說明,無須自行推測:type = "openai" 的預設 base_url 是 https://api.openai.com/v1,而環境變數頁面的第三方範例是 https://api.example.com/v1。若缺少 /v1,會出現 404,而不是 401。
為什麼 Kimi Code 在我已匯出變數後仍顯示缺少 API 金鑰?
因為除非你明確指定要讀取哪個 shell 環境變數,否則它不會從中讀取憑證。設定檔文件指出,執行 export KIMI_API_KEY 不會讓任何提供者取得金鑰。你可以直接在 config.toml 中設定 api_key,或將變數名稱設為 api_key_env——兩者互斥,請只設定其中一個。只有前兩者都未設定時,才會查詢 [providers.<name>.env] 子表格;若三者都未設定,啟動時會報錯。
Kimi Code 能透過第三方提供者執行 Claude 模型嗎?
提供者類型代表通訊協定,不代表供應商;model 值會直接傳送至你設定的 base_url。因此,若在 openai 類型的提供者中設定 Claude ID,該 ID 會在此端點解析,而不是由 CLI 解析。Kimi Code 也提供獨立的 type = "anthropic" 提供者,支援 Anthropic Messages 通訊協定,其 base URL 是不含 /v1 後綴的網域根網址。Kunavo 尚未使用任一通訊協定,透過 Kimi Code 連線自家端點,因此請先使用上方的 curl 測試,並將首次工作階段視為測試。