Kilo Code 接入指南
Kilo Code 是一款运行在 IDE 中的 Coding Agent 插件,适合通过自然语言完成代码生成、代码修改和调试等开发任务。通过配置 OpenAI Compatible API,Kilo Code 可以接入 Step 模型,在编辑器内直接调用推理能力。
本文档介绍 Kilo Code 接入 Step API 的准备条件、配置方法、参数建议与基础测试流程。
概述
Kilo Code 适合在编辑器内进行自然语言编程协作。完成 API 配置后,即可在 IDE 面板中直接调用 Step 模型。
前置条件
开发环境
支持以下 IDE:
- Cursor(推荐)
- VS Code
安装 Kilo Code 插件
在 IDE Marketplace 中搜索并安装:
Kilo Code安装完成后,IDE 中将出现 Kilo Code 面板。
订阅 Step Plan
在开始配置前,请先确认当前账号已完成 Step Plan 订阅。只有在账号具备对应计划或调用权限后,后续模型调用与额度使用才会正常生效。
如需订阅或购买,请访问:platform.stepfun.com/step-plan
获取 Step API Key
访问 Step 平台控制台 创建 API Key,并妥善保存:
配置步骤
打开 Kilo Code 设置页面,配置 API Provider。
Connection 配置
填写以下参数:
API Provider:OpenAI CompatibleBase URL:https://api.stepfun.com/step_plan/v1API Key:填写 Step API KeyModel ID:填写step-3.5-flash
参数建议
推荐参数如下:
Stream: Enabled
Context Window: 256000
Include max output tokens: Off
Max Output Tokens: -1兼容性说明
在部分插件版本中,如果开启 Include max output tokens,请求里可能会自动附带以下字段:
max_tokens
max_output_tokens不同 OpenAI Compatible API 对这些字段的兼容性可能存在差异,可能导致插件请求失败并显示:
OpenAI completion error: Connection error如果遇到该问题,可以尝试:
- 关闭
Include max output tokens - 或保持
Max Output Tokens = -1,由服务端决定输出长度
测试接入
完成配置后,可以输入一个简单任务进行验证:
Create a hello world script in Python若接入成功,模型通常会返回类似内容:
print("Hello, world!")常见问题
Connection error
若出现以下错误:
OpenAI completion error: Connection error请检查:
Base URL是否填写为https://api.stepfun.com/step_plan/v1。- API Key 是否有效。
Model ID是否填写为step-3.5-flash。- 是否已关闭
Include max output tokens。
API Key 错误
若出现以下报错:
401 Incorrect API key请检查:
- Key 是否复制完整
- Key 是否属于正确环境
总结
完成 OpenAI Compatible 配置后,Kilo Code 即可在 IDE 中通过 Step 模型完成代码生成、文件编辑和项目辅助开发等任务。建议优先采用推荐参数组合,并先做一次最小任务验证。