Kimi K2.5 讓代理編碼更穩

我把 Kimi K2.5 在 Claude Code、Cline、RooCode、OpenCode 的接法拆成可直接照抄的版本，順手把代理迴圈、成本控制和除錯順序講清楚。

我用代理式寫程式工具一陣子了，越用越有一種熟悉的煩躁感。模型接好了、外掛裝好了、工作流程也串起來了，表面上看起來很順，結果一跑起來就不是那回事。它會一直點頭，會一直配合，會一直把我那種半成品想法當成聖旨。更慘的是，工具層開始自己重試、自己補問、自己繞圈，最後不是把事情做完，而是把 token 和預算一起磨掉。這種狀況我看太多次了，所以我看到 Kimi K2.5 的代理支援文件時，第一個反應不是「喔很強」，而是「終於有人把話講白了」。

我這次拆的是 Kimi 代理支援頁。它不是那種只丟一個 API endpoint 給你就叫你自己想辦法的頁面，而是直接把 Claude Code、Claude Code、Cline、RooCode、OpenCode 怎麼接、怎麼驗證、怎麼控成本都寫出來。頁面還提到 K2 Vendor Verifier，而且說它已經擴到 12 家供應商。這個細節很重要，因為這整件事本質上不是「能不能呼叫模型」，而是「代理工具鏈到底穩不穩」。

先別把代理編碼當成免費試煉場

When using large models for code generation, due to the randomness and complexity of the model, multiple attempts may be required to generate code that meets expectations. Programming tools will automatically perform multiple rounds of retries and calls, which may lead to rapid token usage growth.

翻譯一下就是：你花錢的，不只有模型，還有外面那層代理工具。Claude Code、Cline、RooCode、OpenCode 這些東西都會重試、會補問、會分支、會再試一次。模型只要有一點點太積極，外層工具就會把這個積極放大成迴圈，等你發現時，帳單已經在跑了。

我之前就踩過這種坑。demo 看起來超神，真的丟到工作裡就開始燒。問題不只是回答品質，而是控制權。那種什麼都說好、什麼都照做的模型，在代理迴圈裡其實很危險，因為它會把每個錯誤決策都放大成下一輪輸入。你以為你在叫它修 bug，結果它在幫你把錯誤複製成流程。

Kimi 的文件在這點上反而很老實：要設每日花費上限、要開餘額提醒、要盯著代理是不是在無限重試。這不是行銷話術，這是有人直接承認「這玩意兒會跑掉」。我反而比較信這種寫法，因為它比較像真的用過，而不是只會畫餅。

實操上我會這樣做：在你把 Kimi K2.5 接進任何編碼助手之前，先定義失敗長什麼樣。到 Kimi Open Platform 把專案日額度先卡住，餘額提醒打開，長時間代理 session 當成 production job 看。你如果用的是 Claude Code、Cline、RooCode 或 OpenCode，不要天真地以為介面會幫你擋住失控重試，它不會。

• 先設預算，不要先談體驗。
• 把重試次數和代理迴圈當成成本的一部分。
• 長跑任務要有人盯，不要放生。

模型選擇其實是在選代理行為

Model Selection : If response speed is not a high priority, you can choose to use the kimi-k2.5 model.

也就是說，Kimi 其實在提醒你：速度和代理品質不能同時全拿。文件把 Kimi K2.5 描成一個偏 agent 能力的 MoE 基礎模型，重點不是「回得最快」，而是「在工具鏈裡比較像個正常人」。

這個差別我很有感。很多編碼助手在 demo 裡很快，可是一旦你要它看檔案、改程式、追 error、再根據結果繼續走下一步，它就開始露餡。這時候你不會只在意延遲，你會在意它能不能守住任務、能不能維持上下文、能不能不要每一步都重新發瘋。

Kimi 還把 K2 Vendor Verifier 擺出來，這點我很買單。這表示他們不是把「工具調用準不準」當感覺在講，而是想把它變成可以比較的東西。對代理編碼來說，這才是正路。你不可能只看模型名就知道它在工具鏈裡會不會亂來。

實操上，我會把 Kimi K2.5 用在那種需要反覆工具調用的場景。像是要它讀錯誤訊息、改檔案、再驗證、再修一次，這種工作就很適合。反過來，如果只是丟一句短 prompt、要它吐一段一次性的內容，那你不一定非它不可。你要的是穩，不是面子。

• 需要多輪工具調用時，再考慮 Kimi K2.5。
• 預期會重試，就先縮小預算。
• 要它做長流程時，盯住是否偏離任務。

Claude Code 的接法比我想的更像換後端

export ANTHROPIC_BASE_URL = https://api.moonshot.ai/anthropic

翻譯一下就是：Claude Code 可以把 Kimi 當成相容 Anthropic 的後端來用。你不是重寫 Claude Code，也不是改它的核心邏輯，你只是換 endpoint、換 token、再指定模型。這種做法我其實比較喜歡，因為它夠直接，也比較好除錯。

文件把 macOS、Linux、Windows 都列得很清楚。先裝 Node.js，再裝 Claude Code，接著設 ANTHROPIC_BASE_URL、ANTHROPIC_AUTH_TOKEN、ANTHROPIC_MODEL，還有預設的 Opus、Sonnet、Haiku 模型變數。它甚至把 CLAUDE_CODE_SUBAGENT_MODEL 設成 kimi-k2.5，再把工具搜尋關掉。這種寫法我看了是舒服的，因為它沒有假裝你只要點一下就會成功。

我也喜歡它叫你先在 Claude Code 裡跑 /status，再用 Tab 切思考模式。這種小提醒很土，但很有用。因為你真的會卡在那種「到底是沒接上，還是模型在裝死」的狀態裡，然後花半小時懷疑人生。

實操寫法很簡單：如果你在 Mac 或 Linux，就先照文件裝 Node 24.3.0，再裝 Claude Code，最後在啟動前把 Kimi 的環境變數 export 好。Windows 就用 PowerShell 設同樣的值。重點是要一致，所有 Claude 相關的模型變數都指向 Kimi K2.5，不然你會得到一個很難追的混搭現場。

• Base URL 指到 Kimi 的 Anthropic 相容端點。
• Auth token 用你的 Moonshot API key。
• 先跑 /status 再相信它真的接上了。

Cline 和 RooCode 不愛花俏，照規矩接就好

Select ‘Moonshot’ as the API Provider

翻譯一下就是：Cline 跟 RooCode 最舒服的方式，就是老老實實選 Moonshot，不要自作聰明去繞一圈。文件直接叫你選 Moonshot、把入口設成 api.moonshot.ai、貼上 Kimi Open Platform 的 key、選 kimi-k2.5，然後把 browser tool usage 關掉。

我在 VS Code 類外掛上吃過太多 provider mismatch 的虧了。最常見的死法就是我以為外掛會自己懂，結果它根本沒懂，最後我花二十分鐘在錯的層級除錯。Kimi 這份文件比較討喜的地方，就是它把該轉的旋鈕都直接列出來，不跟你玩猜謎。

它在 Cline 那段還提醒你可以從左側活動列或 command palette 確認外掛有沒有真的裝好。這看起來很基本，但基本檢查才是救命的。外掛沒裝對，你後面再怎麼調模型都只是白忙。

實操上，我會在 Cline 或 RooCode 裡直接選 Moonshot，endpoint 填 api.moonshot.ai，模型選 kimi-k2.5，browser tools 除非你有明確理由，不然先關掉。少一個變數，少一個出事點，這在代理編碼裡很值錢。

• Provider 選 Moonshot，不要硬繞。
• Browser tools 先關，降低干擾。
• 先確認外掛安裝成功，再談模型表現。

OpenCode 是我最想先試的路徑

$ opencode auth login

翻譯一下就是：如果你想快點看到 Kimi K2.5 到底能幹嘛，OpenCode 是最少廢話的路。先安裝、登入 Moonshot AI、再從 /models 選模型。沒有一堆環境變數儀式，也不用假裝自己在接另一家供應商。

文件給了 shell installer 和 npm 兩種安裝方式，之後就是 opencode auth login、選 Moonshot AI、輸入 key、啟動 OpenCode、用 /models 切到 Kimi K2.5。流程短到我覺得很像終於有人知道開發者不想先蓋一座祭壇才開始測試模型。

我用過太多終端工具，最怕的就是「還沒開始用，先被安裝流程打敗」。OpenCode 在這點上算是很乾脆。它不是最花俏的，但它從「我想試試看」到「我真的在用」之間的距離最短。

實操上，如果你只是想先驗證 Kimi K2.5 的手感，我會先裝 OpenCode。登入 Moonshot AI，切到 Kimi K2.5，然後直接丟一個真的 coding 任務，不要拿 Hello World 騙自己。文件也有 OpenCode 文件 可以補細節，這條路適合不想把下午耗在 client 除錯的人。

直接 API 先跑通，才知道問題在哪一層

from openai import OpenAI

client = OpenAI(
    api_key="$MOONSHOT_API_KEY",
    base_url="https://api.moonshot.ai/v1",
)

completion = client.chat.completions.create(
    model="kimi-k2.5",
    messages=[
        {
            "role": "system",
            "content": "You are Kimi, an artificial intelligence assistant provided by Moonshot AI. You are more proficient in Chinese and English conversations. You will provide users with safe, helpful, and accurate answers. At the same time, you will refuse to answer any questions involving terrorism, racial discrimination, pornography, or violence. Moonshot AI is a proper noun and cannot be translated into other languages.",
        },
        {
            "role": "user",
            "content": "Hello, my name is Li Lei, what is 1+1?",
        },
    ],
)

print(completion.choices[0].message.content)

翻譯一下就是：Kimi 不只有代理整合，它也有標準的 chat-completions 風格 API。這很重要，因為任何工具包最後都可能在某個莫名其妙的地方壞掉。到那時候，我最想要的不是再看一篇安裝教學，而是一條可以直接呼叫模型的路。

文件也有 curl 跟 Node.js 範例，這正是我想看到的平台頁面該有的東西。我不需要一篇哲學散文，我需要三件事：key 能不能用、模型有沒有回、base URL 有沒有打對。這三件事先過了，再來談代理層才有意義。

實操上，我會把直接 API 測試放在工具鏈前面。直接呼叫失敗，通常是 auth、endpoint、model name 出問題。直接呼叫成功，才去看 Claude Code、Cline、RooCode、OpenCode 的設定。這個切法很土，但真的省時間。

• 先用直接 API 排除 key 和 endpoint 問題。
• 工具層出問題時，不要先怪模型。
• 留一個最小 smoke test，以後除錯很好用。

可抄的模板

# Kimi K2.5 代理編碼模板（繁中版）

## 1) 先拿 API Key
- 到：https://platform.kimi.ai/console/api-keys
- 在預設專案建立 API key

## 2) 先把成本鎖住
- 在 Kimi Open Platform 設定每日花費上限
- 打開餘額提醒
- 長時間代理任務要盯重試次數，避免無限迴圈

## 3) Claude Code 設定
### macOS / Linux
export ANTHROPIC_BASE_URL="https://api.moonshot.ai/anthropic"
export ANTHROPIC_AUTH_TOKEN="$YOUR_MOONSHOT_API_KEY"
export ANTHROPIC_MODEL="kimi-k2.5"
export ANTHROPIC_DEFAULT_OPUS_MODEL="kimi-k2.5"
export ANTHROPIC_DEFAULT_SONNET_MODEL="kimi-k2.5"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="kimi-k2.5"
export CLAUDE_CODE_SUBAGENT_MODEL="kimi-k2.5"
export ENABLE_TOOL_SEARCH=false
claude

### Windows PowerShell
$env:ANTHROPIC_BASE_URL="https://api.moonshot.ai/anthropic"
$env:ANTHROPIC_AUTH_TOKEN="$YOUR_MOONSHOT_API_KEY"
$env:ANTHROPIC_MODEL="kimi-k2.5"
$env:ANTHROPIC_DEFAULT_OPUS_MODEL="kimi-k2.5"
$env:ANTHROPIC_DEFAULT_SONNET_MODEL="kimi-k2.5"
$env:ANTHROPIC_DEFAULT_HAIKU_MODEL="kimi-k2.5"
$env:CLAUDE_CODE_SUBAGENT_MODEL="kimi-k2.5"
$env:ENABLE_TOOL_SEARCH="false"
claude

## 4) Cline 設定
- Provider：Moonshot
- Entrypoint：api.moonshot.ai
- API key：你的 Kimi Open Platform key
- Model：kimi-k2.5
- Browser tool usage：關閉

## 5) RooCode 設定
- Provider：Moonshot
- Entrypoint：api.moonshot.ai
- API key：你的 Kimi Open Platform key
- Model：kimi-k2.5
- Browser tool usage：關閉

## 6) OpenCode 設定
curl -fsSL https://opencode.ai/install | bash
# 或
npm install -g opencode-ai

opencode auth login
# 選 Moonshot AI，輸入你的 key
opencode
# 在 OpenCode 裡：
/models
# 選擇 kimi-k2.5

## 7) 直接 API smoke test
from openai import OpenAI

client = OpenAI(
    api_key="$MOONSHOT_API_KEY",
    base_url="https://api.moonshot.ai/v1",
)

completion = client.chat.completions.create(
    model="kimi-k2.5",
    messages=[
        {"role": "system", "content": "You are Kimi, an artificial intelligence assistant provided by Moonshot AI."},
        {"role": "user", "content": "請回一句話，確認模型可用。"},
    ],
)

print(completion.choices[0].message.content)

## 8) 快速檢查
- Claude Code：跑 /status
- Claude Code：用 Tab 切思考模式
- Cline / RooCode：確認 provider 是 Moonshot，模型是 kimi-k2.5
- OpenCode：確認 /models 裡看得到 kimi-k2.5

## 9) 我會記住的事
- 先鎖預算，再談體驗
- 代理長跑時盯住重試和成本
- client 出怪時先用直接 API 排除問題
- 能用最簡單的 client 就不要硬上複雜的

這份模板是我根據 Kimi 代理支援頁整理出來的可抄版本，不是逐字照搬。原始文件裡有更完整的平台說明、範例和細節，我把它重排成比較像日常工作會用的流程，順手加了我自己的成本控管和除錯順序。其他我延伸出來的判斷，都是我自己的整理。

來源網址：https://platform.kimi.ai/docs/guide/agent-support，以及其內文連到的 K2 Vendor Verifier、Claude Code、Cline、RooCode、OpenCode。我這篇是衍生整理，不是官方原文翻譯。