文件

文件

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。

~/.kimi-code/config.toml
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 = 200000
base_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。
匯出 shell 變數並不會讓提供者取得金鑰。 Kimi Code 自己的設定檔文件說得很清楚:在終端機執行 export KIMI_API_KEY,不會讓任何提供者取得金鑰。文件列出的優先順序是 api_key 或 api_key_env——兩者互斥,請只設定其中一個;若兩者都未設定,則使用 [providers.kunavo.env] 子表格中的金鑰;若全部都未設定,啟動時會報錯。若要避免將金鑰寫入檔案,請設定 api_key_env = "KUNAVO_API_KEY",而非 api_key;若變數未設定或值為空,請求會失敗,並顯示該變數名稱。
Kunavo 尚未使用此用戶端連線自家端點。 上方區塊是根據 Kimi Code 目前的文件整理而成,並非來自實際連線紀錄:目前沒有 Kimi Code 的串流或工具呼叫測試紀錄,因此第一次實際請求應視為測試,而不是確認。此頁發布的是設定方式,不代表已通過驗證。
type 表示通訊協定,不代表供應商。文件列出的類型有 kimi、anthropic、openai、openai_responses、google-genai 和 vertexai——目前的表格中沒有舊版 OpenAI 類型,因此教你設定該類型的文章已不適用。選擇 openai,再填入 Claude 模型 ID,正是預期的搭配方式:模型 ID 會在 base URL 指向的端點解析,而不是由 CLI 解析。
還沒有金鑰?建立 Kunavo 帳戶,建立金鑰(以 sk-kn- 開頭),並從 $10 起新增額度——呼叫會從該餘額扣款,失敗的呼叫不會計費。之後儀表板會開啟 Kimi Code 設定。

逐步操作

  1. 在 /app/keys 建立金鑰並複製——金鑰只會顯示一次。
  2. 開啟 ~/.kimi-code/config.toml,此檔案會在首次執行時建立。若你使用 KIMI_CODE_HOME 移動資料目錄,檔案會位於 $KIMI_CODE_HOME/config.toml;檔名一律是 config.toml。
  3. 新增上方的 [providers.kunavo] 表格。文件為此類型列出的三個鍵,依序是 type、base_url 和 api_key。
  4. 在 [models."..."] 下宣告模型別名,並設定 provider、model 和 max_context_size——三者皆為必填。-m 和 default_model 都要使用此別名;model 的值則是傳送到線上的模型 ID。別名若包含句點,請加上引號。
  5. 第一次設定時,請省略 capabilities。提供者文件頁指出,系統會依模型名稱前綴自動比對能力;模型表格則說明,陣列只會新增項目,不會移除項目。因此,若標籤設錯,之後編輯設定也無法取消。
  6. 執行 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 的提供者與模型文件頁 進行確認。第三方設定會變動;如果這裡的欄位名稱不再與你看到的內容相符,應以該頁面為準,而不是本頁。

這是簡短版本。完整指南——模型選擇、實際工作階段費用,以及失敗情況——請參閱 Kimi Code 與 Claude 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 權杖的美元價格,輸入/輸出。

模型 IDKunavo 輸入/輸出它在 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_model] 下、供子代理使用的低成本別名
gpt-5-6-sol$2.00 / $12.00同一金鑰與同一提供者表格下,來自不同模型家族的第二意見
計費方式是從預付餘額按權杖計費,沒有月費——請參閱 billing。在重複的上下文中——這是編輯器或聊天用戶端傳送內容的大部分——提示快取 對帳單的影響比模型選擇更大。

常見問題

如何讓 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 測試,並將首次工作階段視為測試。