使用以下方式将 Kimi K2.5 连接到 OpenCode Novita AI：智能体编码指南

智能编程正在超越自动完成：现代工具可以规划任务、编辑多个文件、运行命令，并循环处理失败，直到结果真正有效。 开放代码 是一个开源的、与模型无关的编码代理，您可以在终端中运行它（也可以作为桌面应用程序或 IDE 扩展运行），这使得在您自己的环境中尝试此工作流程成为一种切实可行的方法。

什么是 OpenCode？

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

OpenCode 与 Claude Code 的比较

OpenCode 和 Claude Code 都是基于终端的 AI 编码代理，但它们走了不同的路径。

• 开放代码 是一个开源的、与提供商无关的代理：它重点支持“75岁以上”。 LLM 通过 Models.dev 提供模型（包括本地模型），并将自身定位为一个灵活的工具，可以连接到不同的模型后端。
• 克劳德·科德相比之下，Anthropic 的官方 Claude-first CLI 是一个命令行工具，用于在终端中访问 Claude 模型，此外还有一个官方生态系统，用于扩展（插件）和通过 MCP 进行工具/数据连接。

快速比较表

方面	开放代码	克劳德·科德
定位	开源的多模型终端编码代理	Anthropic 的官方 Claude-first 终端编码代理
模式/提供商选择	75年 LLM 通过 Models.dev 提供的模型，包括本地模型	基于 Claude 构建；可通过 MCP 和插件进行扩展。
GitHub 自动化	/opencode 或 /oc 评论触发器；在 GitHub Actions 运行器上运行	扩展功能主要面向插件/MCP（官方生态系统）。
定价切入点	该工具是开源的；费用取决于您选择的后端模型。	克劳德计划（专业版/极限版/团队版/企业版）

为什么选择 Kimi K2.5？

Kimi K2.5 将 原生多模态、真实工具执行和大规模代理编排 该模型采用单一开放模型，基于约 15T 混合视觉-文本标记进行训练，涵盖图像/视频理解、代码生成和可视化调试等领域。

如何安装 OpenCode

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

macOS / Linux

推荐：

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

或者（跨平台）：

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

开始时间：

开放代码

Windows

推荐：

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

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

开始时间：

开放代码

如何在 OpenCode 中使用 MiniMax M2.1

获取您的 API 密钥 Novita AI

• 第一步：创建或登录您的帐户 访问 https://novita.ai 并注册或登录。
• 步骤 2：导航至密钥管理 登录后，找到“API密钥”。
• 步骤 3：创建新密钥 点击“添加新密钥”按钮。
• 第四步：立即保存您的密钥 密钥生成后应立即复制并保存；密钥通常只会显示一次。

将您的 Novita API 密钥添加到 OpenCode

1. 启动 OpenCode：

开放代码

2. 在 OpenCode 命令提示符下运行：

/连接

3. 搜索并选择 Novita AI然后粘贴您的 Novita API 密钥。
4. 从我们的数据库中通过 UL Prospector 平台选择 基米 K2.5 （模型 ID： moonshotai/kimi-k2.5).

就这样——OpenCode会将代理请求路由到 Novita AI使用您选择的模型的 API。

打造你的第一个项目：伍尔夫溪

为了让演示更直观（也方便通过截图分享），我们将构建一个单页 Web 应用：Woolf Stream。用户上传图片，选择一些创意控件，然后应用就会调用。 Novita AI使用 Kimi K2.5（支持聊天中的图像）的 OpenAI 兼容聊天端点，生成受 20 世纪早期现代主义技巧启发的纯文本意识流散文——而不是逐字引用或模仿弗吉尼亚·伍尔夫。

我们将建造什么

• 一个单页的 Next.js 14（应用路由）演示 TypeScript + TailwindCSS
• API密钥面板 （密码输入 + 显示/隐藏，保存/清除到本地存储；绝不硬编码）
• 拖放式图片上传 （png/jpg）预览和客户端 base64 数据 URL 转换
• 控制：
  • 长度预设： 150/300/600/1000字
  • 色调滑块： 梦幻般的↔尖锐
  • 焦点下拉菜单： 感官/记忆/时间/社交凝视
• 生成流程：
  • “生成散文”按钮处于禁用状态，直到 API密钥+图片 存在
  • 加载指示器 + 错误面板 HTTP 状态 + 故障排除提示
• 输出：
  • 一张带有生成散文的阅读卡片
  • 复制按钮 + 下载 .txt
  • “显示所用提示符”折叠面板（为了提高透明度和可复现性）

切换到构建模式并执行

在 OpenCode 中，切换到 构建模式然后粘贴以下提示。

提示

使用 Next.js 14 (App Router) + TypeScript + TailwindCSS 构建单页演示。

目标：用户上传一张图片（png/jpg格式）。应用将图片发送到兼容OpenAI的聊天接口（支持图片聊天），并生成一段优美的意识流散文，其灵感源自弗吉尼亚·伍尔夫的现代主义写作手法。输出结果仅包含文本。

API 要求（严格）：

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

用户界面要求：

• 莫奈/睡莲风格的UI：柔和的粉彩色调、纸张纹理、微妙的笔触渐变背景、柔和的光晕阴影、圆润的卡片、细微的波纹悬停动画。移动端响应式设计。
• 组件：API 密钥保存/清除、拖放上传 + 预览、控件：长度（150/300/600/1000 字）、色调滑块（梦幻↔清晰）、焦点下拉菜单（感官/记忆/时间/社交凝视）、生成按钮（如果缺少密钥或图像则禁用）、加载指示器、错误面板。
• 输出：阅读卡片中渲染的散文 + 复制 + 下载 .txt + “显示使用的提示”手风琴。

多模态调用（必须）：

• 使用 POST /v1/chat/completions。
• 发送内容为数组的消息，同时满足以下两个条件：

{type:”text”, text:”…说明…”}

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

• 显示模型的文本回复。

写作限制（重要）：

• 创作受 20 世纪早期现代主义意识流（抒情节奏、内心描写、感官细节、联想跳跃、流畅的时间）启发的原创散文。
• 请勿引用或转载伍尔夫的任何文本。请勿冒充伍尔夫。请勿直接模仿伍尔夫的文字。
• 锚定图像：反映构图、光线、色彩、氛围、隐含的运动；保持主体位置。
• 输出：一篇连续的文章（最多 1-3 段）。不包含要点列表，不包含分析。

交付：

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

在本地运行

OpenCode生成项目后：

npm install npm run dev

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

• 页面渲染方式为 莫奈/睡莲 外观
• API密钥的保存/清除功能正常（仅存储在localStorage中），显示/隐藏切换功能也正常。
• 拖放上传功能正常，预览会显示选定的图片。
• “生成散文”功能已禁用，直到 API密钥+图片 存在
• 散文是 纯文本, 1-3 段而且显然 图像锚定
• 复制 + 下载 .txt 工作
• “显示使用的提示符”会显示发送的确切提示符。
• 错误（密钥错误/网络错误）显示 HTTP 状态 以及明确的提示

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

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

桌面应用

OpenCode 的桌面版适用于 macOS、Windows 和 Linux。如果您希望在长时间的代理会话中使用独立的用户界面，那么桌面应用程序非常适合您——而且它可以使用您已创建的同一提供商配置。 Novita AI.

IDE 集成

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

• VS代码
• 光标
• 捷思锐
• 帆板
• VSCodium

结语

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

Novita AI 是一个人工智能云平台，它为开发人员提供了一种使用我们简单的 API 轻松部署人工智能模型的方法，同时还提供经济实惠且可靠的 GPU 用于构建和扩展的云。

常見問題解答