> ## Documentation Index
> Fetch the complete documentation index at: https://platform.stepfun.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Cline

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

## 接入条件

* 已安装 VS Code 或 Cursor。运行下方 Python 验证示例时，还需安装 Python 3。
* [Step Plan 订阅](https://platform.stepfun.com/step-plan)有效、额度可用，且具备所用模型的调用权限。
* 已在 [StepFun 开放平台密钥管理](https://platform.stepfun.com/interface-key)页面创建 API Key。

## 安装 Cline

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

## 配置 Step Plan

### 选择 Provider

1. 打开 Cline 面板，进入设置中的 `API Configuration`。首次使用时，从 `Configure your provider` 进入。
2. 在 `API Provider` 中选择 `StepFun Step Plan (China)`。
3. 填写 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](/docs/zh/guides/models/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](/docs/zh/guides/developer/integrations/search-mcp)。该服务通过 Step Plan 端点提供 `web_search` 和 `web_fetch`。

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

```json theme={"theme":{"light":"light-plus","dark":"dark-plus"}}
{
  "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": []
    }
  }
}
```

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

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

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

## 验证接入

### 验证对话

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

### 验证工具调用

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

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

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

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

### 验证配置保存

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

## 常见问题

<AccordionGroup>
  <Accordion title="Q: 找不到 Step Plan Provider 怎么办？">
    更新 Cline 扩展；也可选择 `OpenAI Compatible`，使用 `https://api.stepfun.com/step_plan/v1` 和实际 API Key，手动填写 `step-5-preview` 或账号可用的其他模型 ID。
  </Accordion>

  <Accordion title="Q: 提示 Connection error 怎么办？">
    检查 Base URL、网络连接、API Key 和模型权限。Base URL 保留到 `/step_plan/v1`，API Key 字段不添加 `Bearer ` 前缀。查看完整错误信息，分别排查认证、模型和请求参数；仅查询模型列表成功还需继续验证实际对话请求。
  </Accordion>

  <Accordion title="Q: 返回 401 怎么办？">
    确认密钥完整、有效，没有首尾空格，且属于所选 Provider 对应站点的账号。模型连接使用 API Key 字段，MCP 则使用 `Authorization: Bearer YOUR_STEP_API_KEY`，两处填写形式不同。
  </Accordion>

  <Accordion title="Q: Cline 只回复文字，没有修改文件或执行命令怎么办？">
    确认已选择 `Act` 模式并打开目标项目。检查是否有等待确认的工具调用，按提示批准后继续；无需为此开启所有自动批准选项。若配置刚发生变化，新建任务后重试。
  </Accordion>

  <Accordion title="Q: 回复为空、被截断或推理阶段没有正文怎么办？">
    推理阶段可能暂时没有正文。若请求结束后仍无正文，检查停止原因、错误信息与输出预算；预算过小可能在正文生成前耗尽。使用 Step 5 Preview 时，先核对模型参数表中的配置，再根据具体错误调整。
  </Accordion>

  <Accordion title="Q: MCP 中没有 step-search 或对应工具怎么办？">
    确认配置合并在 `mcpServers` 下，`type` 为 `streamableHttp`，`disabled` 为 `false`，且请求头包含完整的 `Bearer ` 前缀和密钥。保存后刷新或重新连接服务，并检查连接日志。
  </Accordion>
</AccordionGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.