Cline 高级模型参数怎么填：上下文窗口、输出上限与价格填错会怎样

2026-08-07

Cline 的 Model Configuration 那几项不是在”设置模型”，而是在告诉 Cline 该怎么假设这个模型——模型本身的能力一个字都不会变，变的只是 Cline 的调度决策和账单显示。想明白这一点，后面所有”填错会怎样”的问题就都有了统一的解释路径：凡是填错，故障都不会出现在你填的那一栏，而是出现在别处——上下文突然被截、请求被服务端拒、图片贴上去没反应、界面上的花费数字和服务商后台对不上。

先把两个概念摆清楚，后面会反复用到。接入方式说的是 Cline 用什么协议、往哪个地址发请求；模型能力说的是那个模型自己能不能读图、能不能吃下 20 万 token。这两件事在 Cline 界面上是挨着的，但性质完全不同：接入方式填错，请求发不出去，报错立刻可见；模型能力填错，请求照常发出去，问题要等到某个具体场景才浮出来。这篇只讲后者。

一、Model Configuration 解决的是什么问题

先看 Cline 接第三方模型的整体形状。按官方文档（截至 2026-08-07），API Provider 选 OpenAI Compatible，必填三项：Base URL 填服务商给的 API 端点，API Key 填服务商给的密钥（也可以勾选使用 Azure 托管身份认证 Azure managed identity），Model 选择或输入具体的模型 ID。这里说的 OpenAI 兼容端点，是指服务商把自家接口做成了和 OpenAI 那套请求/响应格式一样的形状，客户端不用改代码就能对接。文档明确提示：Base URL 这里不会是 https://api.openai.com/v1，那是官方 OpenAI API 的地址。文档给的 v0 Quickstart 示例是 Base URL 填 https://api.v0.dev/v1（含 /v1），Model ID 填 v0-1.0-md。

三项填完，请求就能通了。但 Cline 此刻对这个模型仍然一无所知——它不知道这个模型的窗口有多大，不知道能不能读图，也不知道一次调用要花多少钱。这些信息，OpenAI 兼容协议本身并不负责传递。用官方模型时这些是内置的；换成任意一个 OpenAI 兼容端点，就得你来补。

Model Configuration 区就是补这个缺口的地方。官方文档列出的可自定义高级项一共六个：Max Output Tokens、Context Window size、Image Support、Computer Use、Input Price、Output Price。前两个是容量，中间两个是能力开关，后两个是记账参数。

要注意，“需要手填上下文窗口”不是 Cline 独有的设计。同样按官方文档，Roo Code 的 Context Window、Zed 的 max_tokens、aider 的 .aider.model.metadata.json 里的 max_input_tokens / max_output_tokens，都是这个位置的东西。谁做的都不是”探测”，而是”你告诉我”。

二、两项容量参数：Context Window size 与 Max Output Tokens

这两项容易混，但它们管的是完全不同的两头。

Context Window size 是上下文窗口的大小，也就是这个模型单次请求里能容纳的 token 总量上限——系统提示、你贴进去的文件、历史对话、模型正在生成的内容，全都挤在这一个池子里。Cline 拿这个数干什么？官方文档只把它列为一项可自定义参数，没有逐条写明内部怎么用它，所以下面这段是按字段语义推出来的机制判断，实际行为以官方文档和你看到的响应为准：它是 Cline 判断”这轮还能往上下文里塞多少”的依据。你把窗口填大了，Cline 会觉得还有余量，继续往里塞；真正的上限却在服务端那边，于是请求被服务端拒掉，或者内容被上游截断。你把窗口填小了，请求不会失败，但 Cline 会提前开始削减上下文，表现是模型”忘性大”、反复问你刚说过的事。

Max Output Tokens 管的是另一头：单次响应最多允许生成多少 token。这个数偏小，最典型的症状是长回答被拦腰砍断——生成一个大文件的 diff 到一半就停了，看起来像模型”写着写着不写了”。这个数填得超过服务端允许的上限，则可能在请求阶段就被拒。

去哪儿查这两个数？只有一个可靠来源：你所用服务商的官方文档里，那个具体模型 ID 对应的规格说明。别从模型名字推——同一个模型名在不同服务商那里配的窗口可以不一样，同一系列的不同尺寸更是各填各的。这两个概念本身的取舍，站内另有两篇专门写：窗口该按什么标准选，见上下文长度怎么选；输出长度在 API 侧怎么控、被截断了怎么办，见API 输出长度控制。这篇只管 Cline 这个界面里这两栏该填什么、填错怎么暴露。

三、两项能力开关：Image Support 与 Computer Use

Image Support 是这个模型能不能接收图片输入。Computer Use 是另一类能力开关，同样在文档列出的自定义项里。

这两栏的关键认知是：开关只影响客户端敢不敢发，不影响模型会不会做。 文档同样只列出了这两个开关，没写明打开与关闭后客户端各做什么，下面是按字段语义推的：关着，Cline 就不会把图片当作可用的输入通路，你截个图贴进去也走不通；硬开而模型实际不支持，请求会打到服务端，然后由服务端来拒绝或者忽略——报错信息来自上游，长什么样取决于服务商，Cline 界面上看到的可能只是一个语焉不详的失败。所以这两栏应当按服务商文档对该模型 ID 的说明如实填，不要”先开着试试”。

顺带说清一个常被和 Image Support 混在一起的东西：原生工具调用（function calling）。它指的是模型按结构化格式输出”我要调用哪个工具、参数是什么”，由客户端执行后把结果回灌——编程 Agent 的读文件、改文件、跑命令基本都架在这个机制上。它和”能不能读图”是两回事，各家在配置上的处理也不同。按 Roo Code 官方文档的说法（这是该文档的原话，不是本文的断言）：

“Roo Code uses native tool calling exclusively. This is the only supported tool protocol — there is no XML-based fallback.”

也就是说在那个产品里，不支持原生工具调用的模型直接用不了，其文档建议先查服务商文档确认该模型是否支持工具调用。Continue 那边把它放在 capabilities.tool_use，Zed 的 capabilities 对象里含 tools 与 parallel_tool_calls。各家字段名不通用，别互相套。想横向看各家 OpenAI 兼容端点的差异，参考OpenAI 兼容端点与编辑器接自定义 API。

四、两项记账参数：Input Price 与 Output Price

Input Price 与 Output Price 是最容易被当成”可填可不填”的两栏，也是最容易造成误解的两栏。

有一件事是确定的：计价权不在客户端这边。真正扣费的是服务商后台按自己的计价规则算出来的账，你在本地表单里填的数字不可能改变对方的账单。官方文档只把这两栏列为可自定义项，未逐条说明用途；按字段语义推，它们的作用是让 Cline 在本地把 token 用量换算成金额显示给你看。填错的表现因此很特别：一切正常，只有数字是假的。 填成 0 或留空，界面上花费一直趴着不动，你会误判”这么用完全不费钱”；填成另一档模型的价格，界面数字和服务商后台账单对不上，月底对账时你会怀疑是被多扣了。

所以这两栏值得认真填，理由不是省钱，而是保住一个可用的观测面——没有它，你在 Cline 里做的所有”这个任务值不值得用大模型”的判断都失去了参照。单价本身怎么读、按什么单位换算，见模型单价怎么看。

这两栏要填的单价从哪来，可以先看本站的大模型 API 价格对比表：那是一张各家输入价与输出价的横向对照表，每一行都带厂商官方定价页的链接与核对日期，另附分档、缓存、Batch 折扣的读表说明。它是一张表，不是替你算账的工具——不会按你的用量算总额，也不保证比厂商官网更新得快。真要往 Cline 这两栏里填数，最终仍以你所用服务商官方定价页当天的数字为准。

五、六项速查表

下表里的字段名逐字取自 Cline 官方文档（核对日期 2026-08-07）。需要说明的是：文档列出了这些可自定义项，但没有逐条写明填错之后会怎样；“填错的表现”一列是按字段语义推出来的机制判断，供你排查时对号入座，实际行为以官方文档与你所用服务商的响应为准。

配置项	它是什么	填错的典型表现	数值该从哪儿来
Base URL	服务商给的 API 端点	请求根本发不出去，立刻报错	服务商官方文档（文档提示这里不会是 `https://api.openai.com/v1`）
API Key	服务商给的密钥；也可勾选 Azure managed identity	鉴权失败	服务商控制台
Model	具体的模型 ID	模型不存在类报错	服务商官方文档的模型 ID
Context Window size	该模型单次请求可容纳的 token 总量	填大了请求被服务端拒或内容被截；填小了历史被提前削减，模型显得忘性大	服务商文档中该模型 ID 的规格
Max Output Tokens	单次响应最多生成多少 token	填小了长输出中途停住；填大了可能在请求阶段被拒	同上
Image Support	该模型能否接收图片输入	关着则图片通路不可用；硬开而模型不支持则由服务端拒绝	同上
Computer Use	文档列出的能力自定义项之一	与实际能力不符时，失败由上游返回	同上
Input Price	本地换算花费用的输入单价	界面花费数字失真，与服务商账单对不上	服务商官方定价页
Output Price	本地换算花费用的输出单价	同上	同上

六、边界与代价：这套做法放弃了什么

手填模型元数据是有代价的，值得说清楚。

放弃了自动同步。 你填的是一份静态快照。服务商调整了某个模型的窗口上限、上线了新的输出上限、改了价格，你这边不会有任何提示，六项参数会安静地过期。相比之下，Kilo Code 的做法是凭据有效时从 /v1/models 端点自动拉取模型列表（自动检测失败可手动填模型 ID）——那条路省事，但换来的是你对填什么的控制权变小。两种取向没有高下，只是把维护成本放在了不同位置。

它不校验你填的数。 这几栏不是”申报后由 Cline 验证”，而是”申报后 Cline 照单全收”。所以它管不了填错，只能靠你自己和服务商文档对齐。

它明确不管这几件事：不管服务商实际怎么计费，不管模型的真实能力，不管上游的限速与配额，也不管服务商是否对某些参数有特殊要求。跨产品的一个具体例证：Kilo Code 官方文档明确提醒，Azure GPT-5 不要用通用的 OpenAI 兼容 provider，要用它原生的 azure provider，因为 Azure 会拒绝 max_tokens 参数。这类上游侧的参数约定，在通用兼容层里是看不见的。

不适用的场景也有：如果你接的是自家网关且网关本身会改写请求体，那么 Cline 这边填的容量参数与实际打到模型的参数可能不一致，此时应以网关的行为为准去调；如果你要在团队里统一分发配置，界面表单形态的产品（Cline / Roo Code / Kilo Code）本身不像配置文件那样便于进版本库——把配置文件化的路子，是 Continue 的 config.yaml、Zed 与 Gemini CLI 的 settings.json 那一类形态。

七、避坑清单

坑一：把 Base URL 按官方 OpenAI 的地址填。 为什么会踩：习惯了 OpenAI 官方 SDK 的默认值，看到”OpenAI Compatible”就以为地址也一样。怎么避：Cline 文档专门提示了这里不会是 https://api.openai.com/v1，端点一律从服务商文档抄，一个字符都别改。

坑二：/v1 到底带不带，凭感觉猜。 为什么会踩：各家形态确实不统一——Cline 文档的 v0 示例是含 /v1 的 https://api.v0.dev/v1；Kilo Code 文档明确接受 https://api.provider.com/v1 和 https://api.provider.com/v1/chat/completions 两种；goose 那边是 OPENAI_HOST 与 OPENAI_BASE_PATH 拆成两段的设计。见得多了反而容易乱套。怎么避：只认你这家服务商文档里那一行完整字符串，别参考别家产品的示例。

坑三：把别家产品的字段名套到 Cline 头上。 为什么会踩：搜索时容易搜到别的产品的教程。怎么避：记住 base URL 这个东西在各家的名字都不一样——Cline / Roo Code / Kilo Code 的界面里叫 Base URL，Continue 叫 apiBase，Zed 叫 api_url，goose 叫 OPENAI_HOST，Crush 的命令行参数是 --base-url。名字对不上就说明你在看别家的文档。

坑四：上下文窗口按模型名字推。 为什么会踩：同一个模型名在不同服务商那里配的窗口可以不同，凭印象填很容易偏。怎么避：以你实际调用的那个服务商文档里、那个模型 ID 的规格为准。

坑五：能力开关”先开着看看”。 为什么会踩：开关就在眼前，试错成本看起来很低。怎么避：开关与实际能力不符时，失败发生在服务端，返回的错误信息可能很难和这一栏对应上，排查反而更费时间。按文档如实填。

坑六：价格栏留空。 为什么会踩：它不影响功能，很容易被跳过。怎么避：留空等于主动关掉花费观测，后面所有关于成本的判断都没了参照。填上，并且在服务商调价后回来更新。

坑七：填完就当永久有效。 为什么会踩：这六项是静态快照，过期时不会有任何提示。怎么避：把”复核模型参数”挂到你换模型、换服务商、或者发现界面花费数字和账单对不上这三个触发点上，别指望定期想起。

数据来源与核对日期

本篇涉及的产品事实，来源如下，核对日期均为 2026-08-07：

Cline 官方文档 OpenAI Compatible 配置页：https://docs.cline.bot/provider-config/openai-compatible —— API Provider 选项、Base URL / API Key / Model 三项必填、Azure managed identity、Model Configuration 区可自定义的六项（Max Output Tokens、Context Window size、Image Support、Computer Use、Input Price、Output Price）、v0 Quickstart 示例值。
Roo Code 官方文档 OpenAI Compatible 页：https://roocodeinc.github.io/Roo-Code/providers/openai-compatible —— 文中引用的 native tool calling 英文原句、Context Window 手填项。
Kilo Code 官方文档 OpenAI Compatible 页：https://kilo.ai/docs/providers/openai-compatible —— Base URL 接受的两种形态、/v1/models 自动拉取模型列表、Azure GPT-5 相关提醒。
Continue 官方文档 reference 页：https://docs.continue.dev/reference —— config.yaml、apiBase、capabilities.tool_use。
Zed 官方文档：https://zed.dev/docs/ai/configuration —— api_url、max_tokens、capabilities 中的 tools / parallel_tool_calls。
aider 官方文档高级模型设置页：https://aider.chat/docs/config/adv-model-settings.html —— .aider.model.metadata.json 里的 max_input_tokens / max_output_tokens。
goose 官方文档 providers 页：https://goose-docs.ai/docs/getting-started/providers/ —— OPENAI_HOST 与 OPENAI_BASE_PATH。
Crush 项目 README：https://raw.githubusercontent.com/charmbracelet/crush/main/README.md —— --base-url 命令行参数。

上面记录的是核对日当天官方文档页面的内容，各家产品的字段名与界面都可能变动，实际配置以官方文档最新版为准。

本篇没有写这些内容，原因一并说明：

任何价格数字、免费额度、订阅档位、限速数值：这类数字变动频繁，本次未做核实，写出来就是给你一个会过期的锚点。Input Price / Output Price 该填多少，请从你所用服务商的官方定价页抄。
完整模型清单与各模型的窗口、输出上限：同上，且同一模型名在不同服务商处的配置可能不同，列清单等于制造误导。请查服务商文档中该模型 ID 的规格。
产品版本号、发布日期、公司背景与产品间的归属关系：本次未核实，不做推断。
Cline 界面菜单的逐级层级：官方文档未逐级写明的路径，本篇不凭印象补写。

需要动手配之前，请以各产品官方文档为准，本篇只负责把每一栏在管什么、错了会从哪儿冒出来讲清楚。

延伸阅读：同一组里的 Cline 接自定义 OpenAI 兼容 API、Roo Code 接自定义 OpenAI 兼容 API；接完之后照接完自定义模型别急着干活逐项过一遍，才算真接通。