在编程工具中使用 Kimi k2.5 模型

Kimi k2.5 是一款具备超强代码和 Agent 能力的 MoE 架构基础模型，我们以 Claude Code， VS Code & Cline/RooCode 为示例，说明如何使用 Kimi k2.5 系列模型。

使用注意事项

在使用大模型进行代码生成时，由于模型的随机性和复杂性，可能需要多次尝试才能生成符合预期的代码。编程工具会自动进行多轮重试和调用，这可能导致 token 用量快速增长。为了更好地控制成本和使用体验，我们建议您注意以下几点：

预算控制
- 设置日消费上限：在使用前，请前往Kimi 开放平台项目设置配置「项目日消费预算」。一旦达到预算上限，系统将自动拒绝该项目下所有 API 请求（注：由于计费延迟，限制生效可能有约 10 分钟延迟）。设置方式请见组织管理最佳实践
- 余额预警提醒：建议开启账户余额提醒功能。当账户余额低于预设金额（默认 ¥20）时，系统会通过短信通知您及时充值。
使用建议
- 持续监控：建议在编程软件运行期间保持监控，及时处理异常情况，避免因无限循环或过度重试造成不必要的资源消耗。
- 模型选择：如果对响应速度要求不高，可以选择使用 kimi-k2.5 模型。

K2 Vendor Verifier

Kimi 模型始终专注于 agentic loop，工具调用的可靠性至关重要。为此，我们推出了 K2 Vendor Verifier (K2VV) 来评测不同供应商的 Kimi API 工具调用质量，帮助您直观对比各供应商的准确性差异。 最新更新：K2VV 已扩展至 12 家供应商，开源了更多测试数据。欢迎在此处反馈您关心的测试指标。

获取 API Key

访问开放平台 https://platform.kimi.com/console/api-keys 创建获取 API Key，选择 default 默认项目。

在 Claude Code 中使用 kimi k2.5 模型

安装 Claude Code

若您已安装好 Claude Code ，可以跳过这一步

MacOS 和 Linux

# MacOS 和 Linux 上安装 nodejs
curl -fsSL https://fnm.vercel.app/install | bash

# 新开一个terminal，让 fnm 生效
fnm install 24.3.0
fnm default 24.3.0
fnm use 24.3.0

# 安装 claude-code
npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com

# 初始化配置
node --eval "
    const homeDir = os.homedir();
    const filePath = path.join(homeDir, '.claude.json');
    if (fs.existsSync(filePath)) {
        const content = JSON.parse(fs.readFileSync(filePath, 'utf-8'));
        fs.writeFileSync(filePath,JSON.stringify({ ...content, hasCompletedOnboarding: true }, 2), 'utf-8');
    } else {
        fs.writeFileSync(filePath,JSON.stringify({ hasCompletedOnboarding: true }), null, 'utf-8');
    }"

Windows

# 打开 windows 终端中的 powershell 终端
# windows 上安装 nodejs
# 右键按 Windows 按钮，点击「终端」

# 然后依次执行下面的
winget install OpenJS.NodeJS
Set-ExecutionPolicy -Scope CurrentUser RemoteSigned

# 然后关闭终端窗口，新开一个终端窗口

# 安装 claude-code
npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com

# 初始化配置
node --eval "
    const homeDir = os.homedir();
    const filePath = path.join(homeDir, '.claude.json');
    if (fs.existsSync(filePath)) {
        const content = JSON.parse(fs.readFileSync(filePath, 'utf-8'));
        fs.writeFileSync(filePath,JSON.stringify({ ...content, hasCompletedOnboarding: true }, 2), 'utf-8');
    } else {
        fs.writeFileSync(filePath,JSON.stringify({ hasCompletedOnboarding: true }), null, 'utf-8');
    }"

配置环境变量

完成 Claude Code 安装后，请按照以下方式设置环境变量使用 kimi-k2.5 模型，并启动 Claude。

MacOS 和 Linux

# Linux/macOS 启动高速版 kimi-k2.5 模型
export ANTHROPIC_BASE_URL=https://api.moonshot.cn/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

# Windows Powershell 启动高速版 kimi-k2.5 模型
$env:ANTHROPIC_BASE_URL="https://api.moonshot.cn/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

确认环境变量是否生效

在Claude Code中输入/status确认模型状态：

如何在 Claude Code 中体验 kimi-k2.5 思考能力
- 请在配置模型后，进入 Claude Code 页面后点击 Tab 按钮切换，切换成功可看到 “Thinking on” 的标识。

接下来就可以正常使用 Claude Code 进行开发了！

在 Cline 中使用 kimi k2.5 模型

安装 Cline

打开 VS Code
点击左侧活动栏中的扩展图标（或使用快捷键 Ctrl+Shift+X / Cmd+Shift+X）
在搜索框中输入 cline
找到 Cline 扩展（通常由 Cline Team 发布）
点击 Install 按钮进行安装
安装完成后，可能需要重启 VS Code

验证安装

安装完成后，您可以：

在 VS Code 左侧活动栏中看到 Cline 图标
或者通过命令面板（Ctrl+Shift+P / Cmd+Shift+P）搜索 “Cline” 相关命令来验证安装成功

官方推荐：配置 Moonshot Provider 使用 Kimi k2.5 模型

API Provider 选择 ‘Moonshot’
Moonshot Entrypoint 选择 ‘api.moonshot.cn’
Moonshot API Key 配置从 Kimi 开放平台获取的 Key
Model 选择 ‘kimi-k2.5’
Browser 勾选 ‘Disable browser tool usage’
点击’Done’，保存配置

在 cline 中体验 Kimi k2.5 模型效果

我们让 Kimi k2.5 模型写一个贪吃蛇游戏

游戏的效果

在 RooCode 中使用 Kimi k2.5 模型

安装 RooCode

打开 VS Code
点击左侧活动栏中的扩展图标（或使用快捷键 Ctrl+Shift+X / Cmd+Shift+X）
在搜索框中输入 roo code
找到 Roo Code 扩展（通常由 RooCode Team 发布）
点击 安装 按钮进行安装
安装完成后，可能需要重启 VS Code

验证安装

安装完成后，您可以：

在 VS Code 左侧活动栏中看到 RooCode 图标
或者通过命令面板（Ctrl+Shift+P / Cmd+Shift+P）搜索 “RooCode” 相关命令来验证安装成功

官方推荐：配置 Moonshot Provider 使用 Kimi k2.5 模型

API Provider 选择 ‘Moonshot’
Moonshot Entrypoint 选择 ‘api.moonshot.cn’
Moonshot API Key 配置从 Kimi 开放平台获取的 Key
Model 选择 ‘kimi-k2.5’
Browser 勾选 ‘Disable browser tool usage’

直接使用 API 调用 Kimi k2.5 模型

python
curl
node.js

from openai import OpenAI

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

completion = client.chat.completions.create(
    model = "kimi-k2.5",
    messages = [
        {"role": "system", "content": "你是 Kimi，由 Moonshot AI 提供的人工智能助手，你更擅长中文和英文的对话。你会为用户提供安全，有帮助，准确的回答。同时，你会拒绝一切涉及恐怖主义，种族歧视，黄色暴力等问题的回答。Moonshot AI 为专有名词，不可翻译成其他语言。"},
        {"role": "user", "content": "你好，我叫李雷，1+1等于多少？"}
    ]
)

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

curl https://api.moonshot.cn/v1/chat/completions \
    -H "Content-Type: application/json" \
    -H "Authorization: Bearer $MOONSHOT_API_KEY" \
    -d '{
        "model": "kimi-k2.5",
        "messages": [
            {"role": "system", "content": "你是 Kimi，由 Moonshot AI 提供的人工智能助手，你更擅长中文和英文的对话。你会为用户提供安全，有帮助，准确的回答。同时，你会拒绝一切涉及恐怖主义，种族歧视，黄色暴力等问题的回答。Moonshot AI 为专有名词，不可翻译成其他语言。"},
            {"role": "user", "content": "你好，我叫李雷，1+1等于多少？"}
        ]
   }'

const OpenAI = require("openai");

const client = new OpenAI({
    apiKey: "$MOONSHOT_API_KEY",
    baseURL: "https://api.moonshot.cn/v1",
});

async function main() {
    const completion = await client.chat.completions.create({
        model: "kimi-k2.5",
        messages: [
            {"role": "system", "content": "你是 Kimi，由 Moonshot AI 提供的人工智能助手，你更擅长中文和英文的对话。你会为用户提供安全，有帮助，准确的回答。同时，你会拒绝一切涉及恐怖主义，种族歧视，黄色暴力等问题的回答。Moonshot AI 为专有名词，不可翻译成其他语言。"},
            {"role": "user", "content": "你好，我叫李雷，1+1等于多少？"}
        ]
    });
    console.log(completion.choices[0].message.content);
}

main();

其中 $MOONSHOT_API_KEY 需要替换为您在平台上创建的 API Key。使用 OpenAI SDK 时运行文档中的代码时，需要保证 Python 版本至少为 3.7.1，Node.js 版本至少为 18，OpenAI SDK 版本不低于 1.0.0。

核心工作流

工具调用

调试与运维

集成

在编程工具中使用 Kimi k2.5 模型

使用注意事项

K2 Vendor Verifier

获取 API Key

在 Claude Code 中使用 kimi k2.5 模型

安装 Claude Code

MacOS 和 Linux

Windows

配置环境变量

MacOS 和 Linux

Windows

确认环境变量是否生效

在 Cline 中使用 kimi k2.5 模型

安装 Cline

验证安装

官方推荐：配置 Moonshot Provider 使用 Kimi k2.5 模型

在 cline 中体验 Kimi k2.5 模型效果

在 RooCode 中使用 Kimi k2.5 模型

安装 RooCode

验证安装

官方推荐：配置 Moonshot Provider 使用 Kimi k2.5 模型

直接使用 API 调用 Kimi k2.5 模型

核心工作流

工具调用

调试与运维

集成

​使用注意事项

​K2 Vendor Verifier

​获取 API Key

​在 Claude Code 中使用 kimi k2.5 模型

​安装 Claude Code

​MacOS 和 Linux

​Windows

​配置环境变量

​MacOS 和 Linux

​Windows

​确认环境变量是否生效

​在 Cline 中使用 kimi k2.5 模型

​安装 Cline

​验证安装

​官方推荐：配置 Moonshot Provider 使用 Kimi k2.5 模型

​在 cline 中体验 Kimi k2.5 模型效果

​在 RooCode 中使用 Kimi k2.5 模型

​安装 RooCode

​验证安装

​官方推荐：配置 Moonshot Provider 使用 Kimi k2.5 模型

​直接使用 API 调用 Kimi k2.5 模型

使用注意事项

K2 Vendor Verifier

获取 API Key

在 Claude Code 中使用 kimi k2.5 模型

安装 Claude Code

MacOS 和 Linux

Windows

配置环境变量

MacOS 和 Linux

Windows

确认环境变量是否生效

在 Cline 中使用 kimi k2.5 模型

安装 Cline

验证安装

官方推荐：配置 Moonshot Provider 使用 Kimi k2.5 模型

在 cline 中体验 Kimi k2.5 模型效果

在 RooCode 中使用 Kimi k2.5 模型

安装 RooCode

验证安装

官方推荐：配置 Moonshot Provider 使用 Kimi k2.5 模型

直接使用 API 调用 Kimi k2.5 模型