Cline 接入 apimodels.app 的配置方法
Cline 是一个开源的编程 agent,有 VS Code 扩展和命令行两种用法。它可以连接任何兼容 OpenAI 对话格式的地址,接 apimodels.app 用的就是这个能力:一把 key、一个地址,换模型只改 Model ID。
下面的界面文字是 2026 年 11 月 17 日从 Cline 源码里核对的(VS Code 扩展 4.1.26、命令行 3.0.74),以后的版本可能会改名。
在 VS Code 里配置
打开 Cline 面板,点设置图标,按下面的顺序填。
| 字段 | 填什么 |
|---|---|
| API Provider | OpenAI Compatible |
| Base URL | https://api.apimodels.app/v1 |
| OpenAI Compatible API Key | 你的 apimodels.app key |
| Model ID | 从列表里选,例如 claude-opus-5-5、qwen4-max、gpt-6-sol |
| Custom Headers | 留空 |
| Set Azure API version / Use Azure Identity Authentication | 不勾 |
模型列表会自动加载
Cline 没有「获取模型」按钮。地址和 key 填完大约半秒后,它会自己向你填的地址请求模型列表,Model ID 随之变成下拉框。如果列表没加载出来,Model ID 会保持为普通输入框,报错显示在它下面,先检查地址和 key。
列表里是这把 key 能用的全部模型,也包括图像、音频这些不是对话用的模型,要选语言模型。想用的模型不在列表里时,选列表最后的「Use custom model ID…」手动输入。
把 Model Configuration 填上
对自定义地址,Cline 用的是通用默认值:上下文窗口 128,000 token,价格是 0。价格不填的话,Cline 会把每次请求的费用都显示成 0 美元。展开 Model Configuration,按你选的模型填上实际值。
| Model ID | Context Window Size | Input Price / 1M tokens | Output Price / 1M tokens | Supports Images |
|---|---|---|---|---|
| claude-opus-5-5 | 1000000 | 2.40 | 12.00 | 开 |
| qwen4-max | 1000000 | 1.50 | 4.50 | 开 |
| gpt-6-sol | 保持默认 | 1.00 | 5.00 | 开 |
命令行的配置方法
Cline 命令行用四个参数传同样的四项内容。命令见下方代码框,把 key 和模型换成你自己的。不带参数运行 cline auth 是交互式配置。
怎么确认配好了
现在的设置界面里没有测试按钮。看两点就知道连通了:模型列表加载出来了;发一个小任务(比如「列出这个目录下的文件」)能得到回复。
限制和常见问题
在这里用 Claude 模型也选 OpenAI Compatible,不要选 Anthropic。 Cline 的 Anthropic 选项虽然有「Use custom base URL」,但模型只能从 Cline 内置的列表里选,选不了其它厂商的模型。
agent 很费 token。 Cline 每个任务都会发很长的提示词和很多次工具调用。先看前几个任务花了多少,再放手让它自己跑。
带思考的模型开口慢。 qwen4-max 是想完才开始输出,第一段内容可能要等几十秒。
不是每个模型都适合做 agent。 Cline 的界面里就有提示:不同模型表现差别大,能力弱的可能达不到预期。先从编码能力强的模型开始。
出处
字段名称、默认值和行为取自 Cline 仓库(main 分支,VS Code 扩展 4.1.26、命令行 3.0.74),2026 年 11 月 17 日核对。我们没有逐个版本测试 Cline。价格是我们当前的价格,可能调整。
调用示例
cURL
# Cline CLI: one-line setup
cline auth -p openai-compatible \
-k $APIMODELS_API_KEY \
-m claude-opus-5-5 \
-b https://api.apimodels.app/v1
# Check the endpoint and key outside Cline
curl https://api.apimodels.app/v1/models \
-H "Authorization: Bearer $APIMODELS_API_KEY"常见问题
Cline 的 Base URL 要不要带 /v1?
要带。填 https://api.apimodels.app/v1。现在的 Cline 会原样使用你填的地址,不会自动补 /v1。
为什么 Cline 里每次请求都显示 0 美元?
自定义地址的输入价和输出价默认是 0。展开 Model Configuration 填上所选模型的价格即可。这只影响 Cline 的显示,实际扣费以 apimodels.app 后台的用量记录为准。
能通过 apimodels.app 在 Cline 里用 Claude 吗?
能。API Provider 选 OpenAI Compatible,Model ID 填 claude-opus-5-5 或 claude-sonnet-5-5。不要用 Anthropic 那个选项,它的模型只能选内置列表里的。
怎么换模型?
改 Model ID,并把 Model Configuration 里的上下文窗口和价格换成新模型的。Base URL 和 key 不用动。
