将Kimi K2.5连接到OpenCode与Novita AI：智能编码指南

智能编码已经超越了自动补全：现代工具可以规划任务、编辑多个文件、运行命令，并在失败时反复循环直到结果实际可用。OpenCode 是一款开源、模型无关的编码智能体，您可以在终端中运行（也可作为桌面应用或IDE扩展），这使得它在您自己的环境中尝试这一工作流程非常实用。

💡在本指南中，您将：

• 通过 Novita AI的API 将 Kimi K2.5 连接到 OpenCode
• 安装OpenCode，并在您偏好的界面（终端/桌面/IDE）中准备就绪
• 构建一个小型演示项目

什么是OpenCode？

OpenCode 是一款开源AI编码智能体，可在多种开发者环境中运行——最常见的是基于终端的界面（CLI + TUI），但也可作为桌面应用或IDE扩展。

OpenCode 与 Claude Code 对比

OpenCode 和 Claude Code 都是基于终端的AI编码智能体，但它们选择了不同的路径。

• OpenCode 是开源、提供商无关的智能体：它强调支持“通过 Models.dev（包括本地模型）的75+ LLM提供商”，并将其定位为一种灵活的工具，可以连接到不同的模型后端。
• Claude Code 则是 Anthropic 官方的 Claude 优先CLI——一个在终端中访问 Claude 模型的命令行工具——外加用于扩展（插件）以及通过MCP连接工具/数据的官方生态系统。

快速对比表格

方面	OpenCode	Claude Code
定位	开源、多模型终端编码智能体	Anthropic 官方 Claude 优先终端编码智能体
模型/提供商选择	通过 Models.dev 提供75+ LLM提供商，包括本地模型	围绕Claude构建；通过MCP + 插件扩展
GitHub 自动化	/opencode 或 /oc 注释触发；在GitHub Actions运行器上执行	扩展侧重于插件/MCP（官方生态系统）
定价入口	工具开源；成本取决于您选择的模型后端	Claude计划（Pro/Max/Team/Enterprise）

为什么选择 Kimi K2.5？

Kimi K2.5 在单个开放模型中集成了原生多模态、真实工具执行和大规模智能体编排。基于约15T混合视觉-文本标记进行训练，涵盖图像/视频理解、代码生成和视觉调试。

立即尝试 Kimi M2.5！

来源：Kimi

实际要点

• 在智能体基准测试中领先于 GPT-5.2、Claude 4.5 Opus 和 Gemini 3 Pro： 在图表中，Kimi K2.5 在智能体评估套件中领先：HLE-Full 50.2，BrowseComp 74.9，DeepSearchQA 77.1。在 BrowseComp 上，K2.5 领先于 GPT-5.2 (65.8)、Claude 4.5 Opus (57.8) 和 Gemini 3 Pro (59.2)——对于需要浏览、证据收集和迭代优化的长期任务非常有用。
• 具有多语言优势的竞争性仓库级编码： K2.5 达到 SWE-Bench Verified 76.8 和 SWE-Bench Multilingual 73.0。虽然 Claude 4.5 Opus 在 Verified（80.0）上略高，Gemini 3 Pro 也以 80.9 领先，但 K2.5 保持强劲竞争力，并在多语言环境中脱颖而出——领先于 GPT-5.2 (72.0) 并远超 Gemini 3 Pro (65.0)——这对于混合语言仓库中的多文件补丁至关重要。
• 面向开发者工作流程（文档、图表、UI）的更强图像理解： 在图像基准测试中，K2.5 始终处于顶级水平：MMMU Pro 78.5，MathVision 84.2，OmniDocBench 1.5 88.8——支持阅读技术PDF、解读图表以及将视觉需求转化为代码等实际任务。
• 在真实产品迭代中有帮助的视频推理： 对于视频任务，K2.5 取得了 VideoMMMU 86.6 和 LongVideoBench 79.8 的成绩，表明其具有更强的长上下文视频理解能力——有助于分析产品演示、调试UI录制或从导览中提取需求。

如何安装 OpenCode

OpenCode 提供了几种安装选项。最快的是单行安装脚本，最便携的是安装 npm 包。

macOS / Linux

推荐：

curl -fsSL https://opencode.ai/install | bash

或者（跨平台）：

npm install -g opencode-ai
# 或者
bun add -g opencode-ai

启动：

opencode

Windows

推荐：

npm install -g opencode-ai
# 或者
bun add -g opencode-ai

curl | bash 需要 bash 环境（WSL 或 Git Bash）。在 PowerShell/CMD 中，请使用 npm/bun。

启动：

opencode

如何在 OpenCode 中使用 MiniMax M2.1

在 Novita AI 上获取您的 API 密钥

• 步骤 1：创建或登录您的账户 访问 [https://novita.ai](https://novita.ai) 并注册或登录。
• 步骤 2：导航到密钥管理 登录后，找到“API Keys”。
• 步骤 3：创建新密钥 点击“Add New Key”按钮。
• 步骤 4：立即保存您的密钥 生成后立即复制并存储密钥；通常只显示一次。

获取 API 密钥

将您的 Novita API 密钥添加到 OpenCode

1. 启动 OpenCode：

opencode

2. 在 OpenCode 提示符中，运行：

/connect

3. 搜索并选择 Novita AI，然后粘贴您的 Novita API 密钥。
4. 选择 Kimi K2.5（模型ID：moonshotai/kimi-k2.5）。

就这样——OpenCode 将使用您选择的模型通过 Novita AI 的 API 路由智能体请求。

构建您的第一个项目：Woolf Stream

为了让演示立即可视化（并且易于在截图中分享），我们将构建一个单页 Web 应用：Woolf Stream。用户上传一张图像，选择一些创意控制选项，应用调用 Novita AI 的兼容 OpenAI 的聊天端点（支持图像聊天），使用 Kimi K2.5 生成受20世纪早期现代主义技巧启发的文字意识流散文——而不直接引用或模仿弗吉尼亚·伍尔夫。

我们将构建什么

• 一个单页 Next.js 14（App Router）演示，使用 TypeScript + TailwindCSS
• API 密钥面板（密码输入 + 显示/隐藏，保存/清除到 localStorage；永不硬编码）
• 拖放图像上传（png/jpg），带预览和客户端 base64 数据 URL 转换
• 控制选项：
  • 长度预设：150 / 300 / 600 / 1000 字
  • 语气滑块：梦幻 ↔ 锐利
  • 焦点下拉菜单：感官 / 记忆 / 时间 / 社交凝视
• 生成流程：
  • 在 API 密钥 + 图像 都存在之前，“Generate Prose”按钮处于禁用状态
  • 加载指示器 + 错误面板，显示 HTTP 状态码 + 故障排除提示
• 输出：
  • 包含生成散文的阅读卡片
  • 复制按钮 + 下载 .txt
  • “显示使用的提示”折叠面板（透明度和可复现性）

切换到构建模式并执行

在 OpenCode 中，切换到 Build 模式，然后粘贴下面的提示。

提示

使用 Next.js 14（App Router）+ TypeScript + TailwindCSS 构建一个单页演示。

目标：用户上传一张图像（png/jpg）。应用将图像发送到兼容 OpenAI 的聊天端点（支持图像聊天），并生成一段美丽的意识流散文段落，受弗吉尼亚·伍尔夫的现代主义技巧启发。输出仅为文本。

API 要求（严格）：

• 兼容 OpenAI 的自定义基础 URL：https://api.novita.ai/openai
• 模型：moonshotai/kimi-k2.5
• 用户输入自己的 API 密钥（密码字段 + 显示/隐藏）。仅存储在 localStorage 中。永不硬编码。
• 请求包含 Authorization: Bearer {userKey}。

UI 要求：

• Monet / Water Lilies 氛围 UI：柔和粉彩调色板、纸张纹理、微妙笔触渐变背景、柔和辉光阴影、圆角卡片、微小波纹悬停动画。移动端响应式。
• 组件：API 密钥保存/清除、拖放上传 + 预览、控制选项：长度（150/300/600/1000 字）、语气滑块（梦幻↔锐利）、焦点下拉菜单（感官/记忆/时间/社交凝视）、Generate 按钮（如缺少密钥或图像则禁用）、加载指示器、错误面板。
• 输出：渲染在阅读卡片中的散文 + 复制 + 下载 .txt + “显示使用的提示”折叠面板。

多模态调用（必须）：

• 使用 POST /v1/chat/completions。
• 发送 content 为数组的消息，其中包含 BOTH：

{type:“text”, text:“…instructions…”}

{type:“image_url”, image_url:{url:“data:image/png;base64,…”}}

• 显示模型的文本响应。

写作约束（重要）：

• 创作受20世纪早期现代主义意识流启发的原创散文（抒情节奏、内在性、感官细节、联想跳跃、流动时间）。
• 不要引用或复制任何伍尔夫文本。不要声称是伍尔夫。没有直接的模仿句子。
• 锚定于图像：反映构图、光线、色彩、情绪、暗示的动态；保留主体位置。
• 输出：一个连续的段落（最多1-3段）。没有项目符号，没有分析。

交付：

• 完整的可运行代码 + 文件树。
• 注入 base_url 和用户密钥的 API 包装器。
• 客户端图像 -> base64 数据 URL。
• 清晰的错误信息，包含 HTTP 状态码和故障排除提示。

本地运行

OpenCode 生成项目后：

npm install
npm run dev

打开 Next.js 打印的本地 URL（通常是 http://localhost:3000）并确认：

• 页面以 Monet / Water Lilies 外观呈现
• API 密钥保存/清除功能正常（仅存储在 localStorage 中），显示/隐藏切换正确
• 拖放上传有效，预览显示所选图像
• 在 API 密钥 + 图像 都存在之前，“Generate Prose”按钮处于禁用状态
• 散文为纯文本，1-3 段，并且明确锚定于图像
• 复制 + 下载 .txt 功能正常
• “显示使用的提示”显示实际发送的提示
• 错误（坏密钥/网络问题）显示 HTTP 状态码和清晰提示

演示：Woolf Stream

超越终端的 OpenCode：桌面应用 + IDE 集成

OpenCode 通常在终端中使用，但您也可以将其作为桌面应用（Beta）或在 IDE 内部运行——在这两种情况下，您都可以继续使用 Novita AI 的兼容 OpenAI 的 API。界面会改变，但模型/提供商的设置保持不变：选择 minimax/minimax-m2.1。

桌面应用

OpenCode 的桌面版本适用于 macOS、Windows 和 Linux。如果您喜欢在较长的智能体会话中使用独立 UI，桌面应用是一个很好的选择——并且它可以使用您已为 Novita AI 创建的相同提供商配置。

IDE 集成

OpenCode 为以下环境提供官方集成流程：

• VS Code
• Cursor
• Zed
• Windsurf
• VSCodium

结论

OpenCode 让您轻松采用智能体工作流程，而无需锁定单一供应商。使用 Novita AI 上的 Kimi K2.5，您将获得一个实用的设置，用于仓库级迭代和多模态开发任务——可从终端（或桌面/IDE）使用相同的 API 配置。

获取 API 密钥

Novita AI 是一个AI云平台，为开发者提供通过我们简单API部署AI模型的简单方式，同时还提供经济实惠且可靠的GPU云用于构建和扩展。

常见问题解答

什么是 OpenCode？

OpenCode 是一个开源AI编码智能体框架，允许 LLM 在真实开发环境中编写、运行和调试代码，加速端到端构建。

谁是 OpenCode 的所有者？

OpenCode 不像 Claude 或 Gemini 那样由大型AI实验室拥有。它是一个由 OpenCode 团队/社区维护的开源项目，开发由 opencode.ai 的创建者领导。没有专有的“模型所有者”——该项目设计为提供商无关，独立于任何单个 LLM 供应商。

OpenCode 比 Claude 更好吗？

OpenCode 并不严格上“比”Claude Code 好——它们是不同的。OpenCode 是开源且模型无关的，如果您想要灵活性并能够在单个智能体工作流程中运行多个模型（例如通过 Novita AI 的 Kimi K2.5），它是一个更好的选择；而 Claude Code 是 Anthropic 官方的、以 Claude 优先的 CLI，如果您完全致力于 Claude 生态系统，它提供最流畅的体验。

OpenCode 安全吗？

是的，OpenCode 不会存储您的任何代码或上下文数据，因此可以在隐私敏感的环境中运行。

OpenCode 免费吗？

OpenCode 是那些让您驻足思考的罕见开源工具之一。它目前在 GitHub 上拥有超过 80k 星——尝试过后，这种势头是合理的。将其视为与 Claude Code 类似的AI编码智能体，但完全免费且开源。