Skip to content

在第三方 Coding Agent 中使用

Kimi Code 权益支持在主流 Coding Agent 中使用——例如 Claude Code、Roo Code、OpenCode 等;也可以配合 OpenClaw、Hermes 等通用 Agent 框架。让你在自己习惯的工具里自由调用 Kimi Code 的 AI 能力。

本文档将展示 Claude Code 与 Roo Code 的配置方法

开始之前

  • 确保你已经订阅 Kimi 会员并开通 Kimi Code 权益。
  • 获取 API Key:
    1. 进入 Kimi Code 控制台
    2. 点击「新建 API Key」,输入名称后确认;
    3. 复制生成的 Key 并妥善保存(关闭弹窗后无法再次查看完整 Key)。

Kimi Code 控制台

Claude Code

Claude Code 是 Anthropic 推出的命令行编程助手。通过配置环境变量将其接入 Kimi 的 API 端点,你就能在 Claude Code 中直接调用 Kimi Code 的 AI 能力,在熟悉的终端交互里获得 Kimi Code 的编程体验。

安装 Claude Code

安装方式请参考 Claude Code 官方文档

执行脚本,跳过登录流程

安装完成后,不要直接启动 Claude。先在终端执行以下脚本,跳过 Anthropic 默认的登录流程:

sh
node --eval "
// enable third party model support and fast mode
const claudeJsonFilePath = path.join(os.homedir(), '.claude.json');
if (fs.existsSync(claudeJsonFilePath)) {
    const content = JSON.parse(fs.readFileSync(claudeJsonFilePath, 'utf-8'));
    fs.writeFileSync(claudeJsonFilePath, JSON.stringify({ ...content, penguinModeOrgEnabled: true, hasCompletedOnboarding: true }, null, 2), 'utf-8');
} else {
    fs.writeFileSync(claudeJsonFilePath, JSON.stringify({ penguinModeOrgEnabled: true, hasCompletedOnboarding: true }), 'utf-8');
}

// delete old model id
const claudeSettingsJsonFilePath = path.join(os.homedir(), '.claude', 'settings.json');
if (fs.existsSync(claudeSettingsJsonFilePath)) {
    const content = JSON.parse(fs.readFileSync(claudeSettingsJsonFilePath, 'utf-8'));
    if (typeof content === 'object' && typeof content.env === 'object') {
        for (const element of [
            'ANTHROPIC_MODEL',
            'ANTHROPIC_SMALL_FAST_MODEL',
            'CLAUDE_CODE_SUBAGENT_MODEL',
            'ANTHROPIC_DEFAULT_FABLE_MODEL',
            'ANTHROPIC_DEFAULT_FABLE_MODEL_NAME',
            'ANTHROPIC_DEFAULT_OPUS_MODEL',
            'ANTHROPIC_DEFAULT_OPUS_MODEL_NAME',
            'ANTHROPIC_DEFAULT_SONNET_MODEL',
            'ANTHROPIC_DEFAULT_SONNET_MODEL_NAME',
            'ANTHROPIC_DEFAULT_HAIKU_MODEL',
            'ANTHROPIC_DEFAULT_HAIKU_MODEL_NAME',
        ]) {
            delete content.env[element];
        }
        fs.writeFileSync(claudeSettingsJsonFilePath, JSON.stringify(content, null, 2), 'utf-8');
    }
}
"

设置环境变量后启动

sh
export ANTHROPIC_BASE_URL=https://api.kimi.com/coding/
export ANTHROPIC_API_KEY=你的API Key
export CLAUDE_CODE_AUTO_COMPACT_WINDOW=262144

claude
powershell
$env:ANTHROPIC_BASE_URL="https://api.kimi.com/coding/"
$env:ANTHROPIC_API_KEY="你的API Key"
$env:CLAUDE_CODE_AUTO_COMPACT_WINDOW="262144"

claude

启动后若提示是否使用该 API key,确认使用即可。随后按照指引选择你信任的项目文件夹,完成授权即可。

Claude Code 授权访问项目文件

启动后验证

启动后输入 /status,如果返回信息中显示 Base URL 为 https://api.kimi.com/coding/,则配置成功。此时即使模型名称仍显示为 Claude 模型,实际调用的仍是 Kimi Code 的 API。

Claude Code 状态检查

注意

调用最新模型 K2.7 Code 需要开启 Thinking 模式,否则请求会被路由到 K2.6。开启 Thinking 的快捷键——macOS 为 Option+T,Windows 和 Linux 为 Alt+T

切换到高速版

高速版输出速度约为普通版的 5–6 倍、额度消耗约为普通版的 3 倍,需订阅 Allegretto 及以上档位会员。有两种开启方式:

方式一:/fast on 命令

启动 Claude Code 后,输入 /fast on,出现下面的情况即为开启成功:

❯ /fast on
  ↳ ⚡ Fast mode ON · $10/$50 per Mtok

Claude Code 开启 Fast 模式

方式二:/config 命令

输入 /config 打开配置面板,在 Config 标签下开启 Fast mode(以及 Thinking mode)即可。

Claude Code Config 面板

开启后就可以体验高速版了。

Roo Code

Roo Code 是 VS Code 中的一款 AI 编程插件,支持通过 OpenAI Compatible 协议接入 Kimi 模型,在编辑器内完成代码生成、重构与多文件协作等任务。

安装 Roo Code

在 VS Code 中点击 安装 Roo Code

在侧边栏打开 Roo Code

安装完成后,点击 VS Code 左侧活动栏中的 Roo Code 图标(袋鼠图标)打开面板。

Roo Code 面板

配置 Kimi Code 模型

  • 新用户:首次使用时直接选择「第三方提供商(3rd-party Provider)」进入配置。
  • 老用户:打开 Roo Code 面板后进入设置页,点击 Configuration Profile 旁的「+」新增配置。

创建配置

模型配置信息按如下方式填写:

配置项设置值说明
API ProviderOpenAI Compatible选择第三方兼容提供商
Base URLhttps://api.kimi.com/coding/v1Kimi Code API 入口
API Key你的 Kimi Code API Key从控制台获取
Model IDkimi-for-coding / kimi-for-coding-highspeed普通版 / 高速版(高速版需 Allegretto 及以上会员)

模型配置

其余选项按如下方式设置:

选项设置值说明
Enable streaming启用流式输出
Include max output tokens包含最大输出 token 数
Enable Reasoning EffortMedium(推荐)推理强度
Max Output Tokens32768最大输出 token 数
Context Window Size262144上下文窗口大小
Image Support支持图像处理

其中 Max Output Tokens 和 Context Window Size 用于告知 Roo Code 模型的能力范围,不填可能导致输出截断或上下文不足。

模型配置补充

切换配置(老用户)

配置完成后,老用户需在 Roo Code 面板中切换到新保存的 Kimi Code 配置。

切换配置

保存配置后新建会话即可使用。