给 OpenCode 接上 Kimi K2.5：三种方式与一些选择

Kimi K2.5 刚发布时我就注意到了，这是一个万亿参数、320 亿激活的开源多模态模型，在多项基准上压过 Claude Opus 4.5，尤其适合编程和 Agent 任务。OpenCode 最近通过 PR #10835 正式支持了它，下面是我整理出来的几种配置方式。

基准测试	Kimi K2.5	Claude Opus 4.5	GPT-4o
HLE (全集)	50.2%	43.5%	42.1%
BrowseComp	74.9%	51.5%	49.3%
编程任务	SOTA	次优	第三
视觉编码	原生支持	有限	良好

抛开跑分，Kimi K2.5 几处对写代码来说很实在的特性：原生多模态可以直接吃 UI 截图吐出组件代码，Agent Swarm 能把复杂任务拆并并行执行，上下文窗口拉到 256K tokens，而且 MIT 许可证（带商用限制条款）意味着多数个人项目都能免费用。

拿到模型之后，怎么在 OpenCode 里跑起来？我有试过三种路子，步骤和感受在下面。

方式一：OpenRouter（新手友好）

OpenRouter 是个聚合网关，省得你同时管理多个官方 API，新手用起来最省心。

1. 去 openrouter.ai 注册，用 GitHub/Google 账号就行，初始有免费额度。
2. 登录后进 Dashboard，点 Keys → Create Key，复制出来的 Key 以 sk-or- 开头。
3. 编辑 OpenCode 配置文件，路径是：
   • macOS/Linux: ~/.config/opencode/opencode.json
   • Windows: %APPDATA%\opencode\opencode.json

写入以下内容：

{
  "providers": {
    "openrouter": {
      "apiKey": "sk-or-your-api-key-here"
    }
  },
  "models": [
    {
      "name": "kimi-k2.5",
      "provider": "openrouter",
      "id": "moonshotai/kimi-k2.5"
    }
  ],
  "defaultModel": "kimi-k2.5"
}

4. 启动 OpenCode，用命令 /models 查看，/model set kimi-k2.5 切换，然后发一句'用 Python 写快速排序'检查是否正常。

方式二：Moonshot 官方 API（最稳）

追求稳定低延迟的话，官方 API 更靠谱，国内访问也有优势。

1. 访问 platform.moonshot.ai，用手机号注册。新用户一般有体验额度。
2. 控制台 → API Keys → 创建密钥，拿到 sk- 开头的 Key。
3. OpenCode 内置了对 Moonshot 的支持，配置如下：

{
  "providers": {
    "moonshot-ai-china": {
      "apiKey": "sk-your-moonshot-api-key"
    }
  },
  "models": [
    {
      "name": "kimi-k2.5",
      "provider": "moonshot-ai-china",
      "id": "kimi-k2.5"
    }
  ],
  "defaultModel": "kimi-k2.5"
}

如果你在国外，把 provider 换成 moonshot-ai 即可。

方式三：Synthetic 平台（尝鲜体验）

Synthetic 目前有免费额度，适合想快速上手不用搞 API 的朋友，但延迟和稳定性会差一些。

1. 注册 synthetic.new，拿到免费额度。
2. 在设置页找到 API Endpoint 和 Key。
3. 配置 OpenCode：

{
  "providers": {
    "synthetic": {
      "apiKey": "your-synthetic-key",
      "baseUrl": "https://api.synthetic.new/v1"
    }
  },
  "models": [
    {
      "name": "kimi-k2.5-free",
      "provider": "synthetic",
      "id": "kimi-k2.5"
    }
  ]
}

免费额度用完就得另想办法了。

怎么选？

接入方式	价格	稳定性	延迟	适合谁
OpenRouter	$0.50-2.80/M token	良好	中等	新手、想切多模型的
Moonshot 官方	约 ¥4-20/M token	最佳	最低	生产环境、国内用户
Synthetic	限时免费	一般	较高	测试体验

在国内的话直接 Moonshot 官方；在海外或者经常要切模型，OpenRouter 更灵活。

思考模式 vs 即时模式

Kimi K2.5 默认会走深度推理（思考模式），适合解复杂问题。如果想要飞快出结果，可以在 options 里关掉 thinking。

思考模式配置（默认其实是这个行为）：

{
  "models": [
    {
      "name": "kimi-k2.5-thinking",
      "provider": "moonshot-ai-china",
      "id": "kimi-k2.5",
      "options": {
        "temperature": 1.0,
        "top_p": 0.95
      }
    }
  ]
}

关闭思考用即时模式：

{
  "models": [
    {
      "name": "kimi-k2.5-instant",
      "provider": "moonshot-ai-china",
      "id": "kimi-k2.5",
      "options": {
        "temperature": 0.6,
        "thinking": false
      }
    }
  ]
}

视觉编码：从截图到组件

把 UI 截图拖给 Kimi K2.5，可以直接生成 React/Tailwind 代码。在 OpenCode 里对话时粘贴图片，模型会分析布局、颜色、字体，然后吐出组件。

比如让它生成登录表单，可能得到类似这样的骨架：

import React from 'react'
export default function LoginForm() {
  return (
    <div>Welcome Back Sign In</div>
  )
}

实际效果比你想象的好，只是长截图有时会丢细节。

几个常见问题

版本要求：OpenCode 需要 v1.9.0 以上，否则可能不支持附件处理或工具调用。

免费额度用完了？ 如果 Synthetic 不给续，就切到 OpenRouter 付费，或者趁 Moonshot 官方新用户优惠再注册一个号。

日常编程选 Kimi K2.5 还是 Claude？ 从大家反馈看，Kimi 在复杂推理、视觉编码和需要长时间思考的任务上更有优势；Claude 长文本理解和多轮对话依然强。看你的场景切换。

响应太慢？ 关掉思考模式（即时模式）、换个低延迟的 provider，或者把提问细化可以减少等待。

商业使用：模型本身是 MIT 修改版，带额外条款，建议先去 Hugging Face 页面 读清楚许可。

参考链接

• Kimi K2.5 模型页 (Hugging Face)
• Moonshot 开发者平台
• OpenCode 仓库

Kimi K2.5 在 OpenCode 里的集成目前还算顺利，视觉编码和推理能力确实让人眼前一亮，有什么问题可以去 OpenCode 的 GitHub 翻翻 PR 和 Issue。