VS Code Kilo Code 使用教程

本教程按 VS Code 1.127.0 + Kilo Code 7.4.7 说明。JetBrains 插件的菜单结构不同，请按对应版本的字段名称配置。

1. 安装插件

打开 VS Code 扩展面板，搜索 Kilo Code，核对发布者为 kilocode 后安装。安装完成后，活动栏会出现 Kilo Code；当前扩展也注册了 Kilo Code: Settings 命令。

官方安装与 Provider 说明见 Kilo Code 文档 和 OpenAI Compatible Provider。

2. 准备 DuckMans 信息

创建专用 API Key，参见创建 API Key。

配置项	内容
Provider ID	duckmans
显示名称	DuckMans
Provider API	OpenAI Compatible（按 Chat Completions 兼容协议调用）
Base URL	https://duckmans.com/v1
API Key	YOUR_API_KEY
Model ID	DuckMans 后台当前可用模型 ID

3. 打开 Providers 设置

使用以下任一入口：

1. 点击 VS Code 活动栏中的 Kilo Code。
2. 点击 Kilo Code 面板右上角的 Settings 齿轮。
3. 进入 提供商 / Providers。
4. 在“热门提供商”中找到 自定义提供商 / Custom Provider，点击 连接。

也可以按 Cmd/Ctrl + Shift + P，执行 Kilo Code: Settings，再进入 Providers。

4. 添加 OpenAI Compatible Provider

新增自定义 Provider 后：

1. Provider ID 填 duckmans，显示名称填 DuckMans。
2. Provider API 选择界面中的 OpenAI Compatible；该选项按 OpenAI Chat Completions 兼容协议使用，不是 Responses。
3. Base URL 填 https://duckmans.com/v1。
4. API Key 填自己的 DuckMans 专用 Key。
5. Model ID 填后台当前可用的完整模型 ID。
6. 点击 提交 保存，再点击设置页顶部的 重新加载，或完整重载 VS Code 窗口。

Provider ID 填 `duckmans`，API 选择 **OpenAI Compatible**，Base URL 填 `https://duckmans.com/v1`。

将 `YOUR_MODEL_ID` 替换为后台模型 ID；不确定模型能力时，先关闭推理和图片开关。

不要选错协议

本页只验证界面中的 OpenAI Compatible，并按 Chat Completions 兼容协议理解；Provider ID 固定为 duckmans。不要选择 Responses 或 Anthropic，除非 DuckMans 与当前 Kilo Code 版本另有单独验证。

高级能力、上下文长度和价格字段先保留默认。只有后台或模型说明明确给出对应值时再修改。

5. 最小测试

打开不含敏感文件的测试项目，保持逐次审批，输入：

请只读取当前项目，列出主要目录和可能的启动命令，不要修改文件。

先填写自己的 API Key，确认只读结果和模型名称正确，再测试编辑或终端工具。

常见问题

• 找不到 Kilo Code：确认安装的是发布者 kilocode 的扩展，并重载 VS Code。
• 401：重新复制完整 API Key，确认没有把兑换码填进去。
• 403：检查 Key 分组和模型权限。
• 404：确认 Base URL 是 https://duckmans.com/v1，没有重复 /v1。
• 模型不可用：从 DuckMans 后台复制当前可用模型 ID。
• 能对话但不能改代码：检查当前模式和工具审批，不要仅凭模型名开启未经确认的高级能力。

恢复原配置

先切回原 Provider。需要清理时只删除 Provider ID 为 duckmans 的新增配置，然后运行 Kilo Code: Reload Config and Skills；不要重置其他 Provider 或整个扩展。