在 Cline 和 Roo Code 里接入阶跃星辰：Base URL 与参数怎么填
数据截至 2026-08，价格与限额以各官网为准。本文只讲计费与接入机制，不列具体价格数字。
Cline 和 Roo Code 在阶跃星辰这边走的是同一条路：都选 OpenAI Compatible 这个 Provider，都填同一个 Base URL。真正会让你卡住的是两件事——第一，Step Plan 有一个专用地址，跟普通 API 的地址长得很像但不是同一个，两份指南在「Connection error」的排查清单里都把它排在第一项；第二，Roo Code 的官方指南里多出一节「兼容性说明」，讲的是插件某些版本在开启某个开关后会自动往请求里塞额外字段，Cline 那份指南里没有这一节。所以这两个工具的排查清单本来就不一样，别拿一份清单去套另一个。
配之前，账号侧有两件事必须先做完
阶跃星辰的 Cline 指南和 Roo Code 指南，在「前置条件」里写的是同一套要求：确认当前账号已完成 Step Plan 订阅，然后到平台控制台创建 API Key。官方的措辞是，只有在账号具备对应计划或调用权限之后，后续的模型调用与额度使用才会正常生效。
快速开始那一页把顺序说得更明确：建议先确认已订阅或开通 Step Plan，再创建 API Key，最后才接入具体工具。为什么把订阅这一步放在最前面，官方在同系列的 Open Code 接入指南里给了一个可以对照的例子：那一页的常见问题中单列了一条报错 400 you have no active step plan subscription，官方给出的解释是当前账号尚未订阅 Step Plan，需要到订阅页开通后重试；同一页 401 Incorrect API key 的排查清单里，第三条也是「控制台对应账号是否已订阅 Step Plan」。
要说清楚的是，这两条写在 Open Code 那份指南里，Cline 和 Roo Code 两份指南的常见问题都没有收录它们。但它提示的排查方向是通用的：账号侧的订阅状态本身就是一个独立的检查项，跟插件里填了什么没有关系。与其把插件配完再回头怀疑账号，不如按官方给的顺序，先确认订阅、再创建 Key、最后才动插件设置——三步各自可以独立验证，出问题时也容易切开看是哪一段断了。
另外官方在创建 Key 的地方反复提醒：妥善保存，不要直接写入代码仓库。这一条在 IDE 插件场景下尤其值得当回事：插件把配置存到哪里、会不会跟着项目目录或者账号同步一起走，取决于你用的 IDE 与插件版本，阶跃的接入指南对此没有说明，所以更稳妥的做法是直接按「Key 不进仓库」这条硬规矩来管。关于 Key 该怎么存、怎么轮换，可以看API Key 安全管理的通用做法。
Cline 这边：四个字段，一个都不能错
打开 Cline 的设置页，按官方指南填 Connection 部分：
API Provider选OpenAI CompatibleBase URL填https://api.stepfun.com/step_plan/v1API Key填你在阶跃平台创建的那把 KeyModel ID填一个具体的模型标识
官方指南在 Model ID 这一项上用的是占位写法，然后在下面的说明里给出可填的取值：step-3.7-flash、step-3.5-flash-2603 或 step-3.5-flash。快速开始那一页则单独给了一条建议：首次接入时优先用 step-3.7-flash 完成验证。两处不矛盾，前者是可选范围，后者是首次验证的推荐项。
环境要求上，官方写的是支持 Cursor 和 VS Code 两种 IDE，并建议使用最新版本。安装完插件后 IDE 左侧会出现 Cline 面板。
验证方式官方也给了具体动作：在面板里输入一个最小任务，比如让它用 Python 写一个 hello world 脚本；官方的措辞是若接入成功，模型通常会返回类似的打印语句。先跑最小任务再上真实项目，这个建议在 Cline 和 Roo Code 两份指南的总结部分都出现了。
Roo Code 这边：多了一节「参数建议」
Roo Code 的 Connection 配置和 Cline 完全同构，同样是 OpenAI Compatible 加同一个 Base URL 加 Key 加 Model ID。有一处细微差别值得留意：Roo Code 指南在模型取值的说明里列的是 step-3.5-flash-2603 或 step-3.5-flash，Cline 指南列的三项里还包含 step-3.7-flash。以官方文档当前版本为准，别凭印象在两个工具间互相套用取值。
真正多出来的是「参数建议」这一节。官方推荐的组合是：流式开启、上下文窗口按官方给出的推荐值填（Roo Code 指南写的是 256000，属于结构性参数，以官方文档当前版本为准）、Include max output tokens 关闭、Max Output Tokens 保持 -1。
前两项容易理解，后两项是这篇文章里最值钱的部分，值得单开一节讲。
那个「Include max output tokens」开关到底会做什么
官方在 Roo Code 指南里给的说法是有限定条件的，照抄限定条件很重要：在部分插件版本中，如果开启 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。阶跃在同系列的 Kilo Code 指南里对第二条多补了半句解释——保持 -1 意味着由服务端决定输出长度。
值得强调的是，这一节只出现在 Roo Code 和 Kilo Code 的指南里，Cline 的指南里没有对应内容。所以如果你在 Cline 里遇到连接错误，官方给的排查方向本来就不包含这个开关。
两种报错，两张不同的检查清单
Connection error（Cline 版），官方列的检查顺序是三项：Base URL 是否填成了 https://api.stepfun.com/step_plan/v1、API Key 是否有效、Model ID 是否存在。
OpenAI completion error: Connection error（Roo Code 版），官方列的是四项：前三项与 Cline 同构，第四项是上下文窗口是否设置为足够大的值，官方在这一项后面还附了推荐值，与「参数建议」那一节给的是同一个。这一项被官方放进这条报错的排查清单里，意味着按官方给出的排查框架，上下文窗口在 Roo Code 这边属于要核对的范围；而 Cline 那份清单里压根没有这一项。这就是两份清单不能互相套用的直接证据——不是我们主观觉得它们不一样，是官方本来就写了不一样的检查顺序。
401 Incorrect API key，两份指南都要求先确认 Key 是否复制完整。差别在第二条：Cline 指南写的是确认 Key 是否属于当前中文站账号环境，并在括号里标了 .com；Roo Code 指南的措辞更笼统，只说是否属于正确的 Step 环境。同一类错误在两份文档里的表述精度不一样，遇到 401 时按 Cline 那条更具体的说法去核对更省事。
至于 401 之外的状态码，阶跃的错误码页把常见几项都列了：400 对应请求参数格式不正确（官方在这一格里列了图片无法下载、图片数量超限、模型不支持视频输入、模型不存在或无权限、参数值不合法这几种可能）、402 对应余额不足、404 对应请求路径不正确、429 对应请求超出速率限制、451 对应请求或响应内容未审核通过、500 与 503 分别对应服务端问题与负载过高。404 这一项在插件场景下值得多看一眼：错误码页给它的原因就是请求路径不正确，而 Cline 和 Roo Code 的 Connection 配置里，四个字段中与请求路径直接相关的只有 Base URL。至于 Base URL 填错具体会落到哪个状态码，官方概述页的常见问题只把「Base URL 是否使用了专用地址」标为第三方工具接入报错的常见问题点，并没有给出对应的错误码，所以别把两者硬画成等号，先按官方的检查顺序逐项核对更稳。429 的通用应对思路可以参考遇到 429 该怎么处理。
额度这一侧会怎么影响插件里的体验
Step Plan 是订阅制，官方把它的计费单位统一成 Credit，调用任意模型时用量都换算成 Credit 从当月额度里扣减。额度按月一次性发放到「月池」，月内任意时段消耗，月末清零、不结转到下一周期。当月用尽后可以加购加油包补充，加油包有独立的有效周期，与套餐到期时间相互独立。具体的档位、单价与各档额度请以官方定价页为准，本文不列数字。
有两条机制对排查很有用。一是扣费顺序：当账户里同时存在月池 Credit 和加油包 Credit 时，官方说明是按到期时间先后消耗，优先扣减先到期的那一份。二是限速口径：官方在常见问题里明确写了，Step Plan 不适用开放平台按累计充值金额划分的阶梯限速，用量由所订阅档位的月度 Credit 额度来管理。这意味着在插件里持续跑长任务时，你要盯的是 Credit 余量而不是充值阶梯。想把这件事做成日常习惯，可以看API 成本监控该怎么搭。
还有一类额度报错只出现在特定场景下，限定条件不能丢：官方在错误码页里写明，这一组是使用企业套餐的项目密钥调用时才会返回的——组织 Credit 账户余额不足返回 402 并带错误标识 insufficient_credit；项目达到当期 Credit 上限返回 429 并带 project_credit_limit_exceeded；成员在项目内达到当期上限返回 429 并带 member_project_credit_limit_exceeded。官方特别提醒，额度上限与速率限制返回的状态码同为 429，收到 429 时要以错误标识来区分是哪一种，光看状态码分不出来。
至于个人订阅的 Step Plan Key 与组织项目 Key 在插件里能否混用，官方文档里没有找到相关说明，别自己推断。
还是不通，该把什么交给官方
阶跃的故障排查指南给出了明确的取证清单。用 Chat API 这条链路时，官方要你提供两样东西：响应头 Header 里的 X-Trace-Id 字段，以及生成结果里的 id——官方在那一页贴了一段 chat.completion 的示例响应，指的就是最外层那个 id。这份清单是按 API 调用的口径写的，Cline 和 Roo Code 两份接入指南里都没有说明这两个值在插件界面的什么位置能看到。
所以真要走到联系官方这一步，一个可行的做法是：用插件里那套完全相同的 Base URL、API Key 和 Model ID，在插件之外单独发一次最小的 Chat API 请求，把响应头和响应体原样保留下来。这样交上去的信息与官方清单是逐项对得上的，也比只贴一张写着 Connection error 的截图更容易被定位。另外官方也提醒，在联系之前可以先看一遍异常事件处理建议那一页，很多常见问题在那里已经给了处理办法。
最后：被官方标成「常见问题点」的那一个字段
如果只让我留一句提醒，那就是 Base URL。阶跃的 Step Plan 有一个专用地址 https://api.stepfun.com/step_plan/v1，官方在概述页里专门用括号强调了它区别于普通 API 的 https://api.stepfun.com/v1，并在常见问题里把「Base URL 是否使用了专用地址」列为第三方工具接入报错的常见问题点。Cline 和 Roo Code 都属于 OpenAI 兼容那一侧，用带 /v1 的这个。
另外有一个例外要记住方向别搞反：官方说明里，Anthropic 兼容的 Messages API 那一侧用的是不带 /v1 的 https://api.stepfun.com/step_plan，这条是给 Claude Code 手动编辑配置文件时的 ANTHROPIC_BASE_URL 用的，官方解释是 Claude Code 会在调用时自动拼接 /v1/messages。这个例外不适用于 Cline 和 Roo Code，别把两边的地址互换。
改完配置之后，官方在快速开始那一页的常见检查项里还留了容易被忽略的最后一条：工具是否已经保存配置并完成重启。官方只是把它列成一项检查，没有解释背后的机制，我们也不替它补。能说的只是它摆放的位置：这份「常见检查项」一共四条，前三条分别是 API Key 是否正确且属于正确环境、Base URL 是否与工具协议匹配、Model ID 是否填写正确，重启这一条是并列的第四条，官方没有给它加「可选」「顺带」之类的限定词。
落到操作顺序上就是：先把保存配置、重启工具这一步做掉，再回头逐项怀疑填写内容。顺序反过来的话，你可能会在一份其实已经改对的配置上反复改写 Base URL 和 Model ID，白白多绕好几圈。