Cline 接入 kkaiapi

最后更新:

配置 Cline 的 OpenAI Compatible provider、模型与能力,分别检查 Plan 和 Act,完成一个小文件修改及测试。

选择 OpenAI Compatible 并检查 Plan / Act

在 Cline 的 API Provider 中选 OpenAI Compatible,填写下面三项。上下文、最大输出和图片能力按实际模型文档设置。若 Plan 与 Act 分别配置模型,两个模式都要核对,不能只配置其中一个。

配置项值
API ProviderOpenAI Compatible
Base URLhttps://api.kkaiapi.com/v1
API Key安全粘贴自己的 KK Key
Model IDclaude-sonnet-5-5

保存后验证一次聊天请求

配置完成后用一个短任务核对实际模型 ID 与 KK 调用记录,再单独验证工具往返、图片输入等所需能力。聊天成功只能证明该聊天路径可用。

import os
from openai import OpenAI

client = OpenAI(api_key=os.environ["KKAI_API_KEY"],
                base_url="https://api.kkaiapi.com/v1", max_retries=0, timeout=120)
r = client.chat.completions.create(
    model="claude-sonnet-5-5",
    messages=[{"role": "user", "content": "请只回复 pong"}],
)
print(r.choices[0].message.content)

核对实际生效的工具路径

首次只修改一个有现成测试的小文件,检查工具调用、diff 和测试输出。两个模式各发起一次短任务,确认调用记录出现预期 ID。完整操作与能力开关见配置教程。

配置依据与能力验证

配置完成后用一个短任务核对实际模型 ID 与 KK 调用记录,再单独验证工具往返、图片输入等所需能力。聊天成功只能证明该聊天路径可用。

配置字段依据cline 官方说明;工具界面可能随版本变化,所需能力应在已安装版本中核对。

常见问题

为什么 API 请求成功,工具仍不能完成任务?

继续核对工具实际选择的 provider、模型、能力声明和运行进程的网络出口;工具调用、文件编辑和图片入口应分别验证。