Cline

Cline 是运行在 VS Code、Cursor 等编辑器中的编码 Agent，支持 Plan / Act 工作模式、文件编辑和终端命令执行。通过 Step Plan Provider，可在编辑器中使用 Step 模型完成开发任务。

接入条件

已安装 VS Code 或 Cursor。运行下方 Python 验证示例时，还需安装 Python 3。
Step Plan 订阅有效、额度可用，且具备所用模型的调用权限。
已在 StepFun 开放平台密钥管理页面创建 API Key。

安装 Cline

在编辑器扩展市场中搜索并安装 Cline，扩展标识为 saoudrizwan.claude-dev。

配置 Step Plan

选择 Provider

打开 Cline 面板，进入设置中的 API Configuration。首次使用时，从 Configure your provider 进入。
在 API Provider 中选择 StepFun Step Plan (China)。
填写 API Key，并选择 step-5-preview。其余连接参数按下表确认。

配置项	填写值
`API Provider`	`StepFun Step Plan (China)`。
`Base URL`	`https://api.stepfun.com/step_plan/v1`，使用预设时确认已填入该地址。
`API Key`	Step API Key，不包含 `Bearer` 前缀或首尾空格。部分界面将该字段显示为 `OpenAI Compatible API Key`。
`Model ID`	`step-5-preview`。

如果当前版本没有 Step Plan 预设，选择 OpenAI Compatible，手动填写同一 Base URL、API Key 和 Model ID。Cline 自动追加 /chat/completions，完整请求路径为 /step_plan/v1/chat/completions。

确认模型参数

展开 MODEL CONFIGURATION。以下配置适用于 Step 5 Preview；使用预设时，核对已有值即可。

配置项	设置	说明
`Supports Images`	开启	允许发送图像输入。
`Context Window`	`1000000`	客户端使用的上下文窗口。
`Max Output Tokens`	`65536`	为推理和正文保留输出预算，避免设为过小值。
`Input / Output Price / 1M`	保留默认	用于 Cline 的成本估算，实际用量以平台记录为准。
`Temperature`	保留默认	无需为接入单独设置。
`Reasoning Effort`	保留默认，或选择 `High`	需要较高推理强度时再调整。Step 5 Preview 支持 `low`、`medium`、`high`。

切换到其他模型时，按对应模型规格调整上下文与输出预算。配置完成后保存，并新建任务。

接入 StepSearch MCP

需要联网搜索或获取网页内容时，可配置 StepSearch。该服务通过 Step Plan 端点提供 web_search 和 web_fetch。

在 Cline 面板打开 MCP Servers，进入 Configure，选择 Configure MCP Servers。
在打开的 cline_mcp_settings.json 中合并以下配置，保留其他 MCP 服务，将 YOUR_STEP_API_KEY 替换为实际密钥：

{
  "mcpServers": {
    "step-search": {
      "type": "streamableHttp",
      "url": "https://api.stepfun.com/step_plan/v1/mcp/web_search/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_STEP_API_KEY"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

保存后，在 MCP Servers 面板检查 step-search 是否已连接，并确认工具列表包含 web_search 和 web_fetch。
新建任务，请 Cline 使用其中一个工具完成搜索或网页抓取，核对工具调用记录与返回结果。

type 必须使用 Cline 的 streamableHttp 写法；省略该字段会使用兼容旧版的 SSE 传输。autoApprove: [] 保留逐次确认，首次调用时按提示批准即可。

MCP 配置中的 API Key 以明文保存。请使用 Cline 的用户配置文件，不要将真实密钥提交到代码仓库或分享给他人。任何获得该密钥的人都可能以您的权限发起请求并消耗额度。

验证接入

验证对话

新建任务并输入 请只回复 OK。，预期返回 OK。

验证工具调用

在独立测试目录中创建 README.md，内容为 Cline Step Plan test，然后在编辑器中打开该目录。
在 Cline 中选择 Act 模式，发送以下指令：

读取 README.md，创建 hello.py，使其打印 "Hello, world!"。
使用本机可用的 Python 解释器运行 hello.py，并报告执行命令和实际输出。
不要修改 README.md 或其他已有文件。

按提示批准必要的文件与命令操作，核对读取、编辑和执行记录。确认 hello.py 实际生成，输出为 Hello, world!，且 README.md 未被修改。

自动批准是可选设置，手动批准也可完成上述验证。

验证配置保存

重启编辑器后，检查 Provider 与模型选择是否保留，并重新发起一次简短对话。

常见问题

Q: 找不到 Step Plan Provider 怎么办？

更新 Cline 扩展；也可选择 OpenAI Compatible，使用 https://api.stepfun.com/step_plan/v1 和实际 API Key，手动填写 step-5-preview 或账号可用的其他模型 ID。

Q: 提示 Connection error 怎么办？

检查 Base URL、网络连接、API Key 和模型权限。Base URL 保留到 /step_plan/v1，API Key 字段不添加 Bearer 前缀。查看完整错误信息，分别排查认证、模型和请求参数；仅查询模型列表成功还需继续验证实际对话请求。

Q: 返回 401 怎么办？

确认密钥完整、有效，没有首尾空格，且属于所选 Provider 对应站点的账号。模型连接使用 API Key 字段，MCP 则使用 Authorization: Bearer YOUR_STEP_API_KEY，两处填写形式不同。

Q: Cline 只回复文字，没有修改文件或执行命令怎么办？

确认已选择 Act 模式并打开目标项目。检查是否有等待确认的工具调用，按提示批准后继续；无需为此开启所有自动批准选项。若配置刚发生变化，新建任务后重试。

Q: 回复为空、被截断或推理阶段没有正文怎么办？

推理阶段可能暂时没有正文。若请求结束后仍无正文，检查停止原因、错误信息与输出预算；预算过小可能在正文生成前耗尽。使用 Step 5 Preview 时，先核对模型参数表中的配置，再根据具体错误调整。

Q: MCP 中没有 step-search 或对应工具怎么办？

确认配置合并在 mcpServers 下，type 为 streamableHttp，disabled 为 false，且请求头包含完整的 Bearer 前缀和密钥。保存后刷新或重新连接服务，并检查连接日志。

工具接入

迁移

文本与推理

请求与上下文

Agent 与工具

文件与知识

视觉理解

语音

开发工具

示例与 Cookbook

错误与排障

接入条件

安装 Cline

配置 Step Plan

选择 Provider

确认模型参数

接入 StepSearch MCP

验证接入

验证对话

验证工具调用

验证配置保存

常见问题

​接入条件

​安装 Cline

​配置 Step Plan

​选择 Provider

​确认模型参数

​接入 StepSearch MCP

​验证接入

​验证对话

​验证工具调用

​验证配置保存

​常见问题

接入条件

安装 Cline

配置 Step Plan

选择 Provider

确认模型参数

接入 StepSearch MCP

验证接入

验证对话

验证工具调用

验证配置保存

常见问题