适用场景
Cline 是面向 VS Code 的 AI 编程助手。它支持 OpenAI Compatible provider，因此可以直接把天池 Token 配成一个自定义模型供应商，用于代码理解、编辑、命令执行确认和项目级 Agent 任务。
接入时需要准备：
| 配置项 | 值 |
|---|---|
| API Provider | OpenAI Compatible |
| Base URL | https://a.skypool.xyz/v1 |
| API Key | Consumer API Key，例如 stc-... |
| Model ID | 平台模型名，例如 gemma4:26b |
在 Cline 设置里配置
打开 VS Code 中的 Cline 面板，进入设置页面，按下面的方式填写：
| 字段 | 填写内容 |
|---|---|
| API Provider | 选择 OpenAI Compatible |
| Base URL | https://a.skypool.xyz/v1 |
| API Key | Consumer API Key |
| Model | gemma4:26b，或你要使用的平台模型 ID |
注意：Cline 的 Base URL 应填写到 /v1，不要填写完整的 /v1/chat/completions。Cline 会根据 OpenAI 兼容协议自动拼接聊天接口路径。
模型能力配置
Cline 允许为自定义模型补充上下文长度、最大输出、图片能力和工具能力。建议先按保守值配置，再根据模型页说明调整：
| 能力项 | 建议 |
|---|---|
| Context Window | 按模型页的上下文长度填写；不确定时先填 32768 或 128000 |
| Max Output Tokens | 先填 4096 或 8192 |
| Image Support | 只有目标模型支持图片输入时再启用 |
| Computer Use / Tool Use | 需要让 Cline 执行工具或代码编辑任务时启用 |
| Input / Output Price | 可按平台模型页价格填写，用于本地成本估算 |
验证连接
保存配置后，在 Cline 对话里发送一个小任务：
请阅读当前打开文件，并用三句话说明它的作用。如果 Cline 能返回结果，并且天池 Token 控制台的活动记录里出现对应请求，说明接入成功。
也可以先用同一个 Key 和模型跑通 curl：
curl -X POST "https://a.skypool.xyz/v1/chat/completions" \ -H "Authorization: Bearer <consumer_api_key>" \ -H "Content-Type: application/json" \ --data-raw '{ "model": "gemma4:26b", "messages": [ { "role": "user", "content": "请返回一句简短的接入成功提示。" } ], "max_tokens": 64, "stream": false }'排查清单
| 现象 | 处理方式 |
|---|---|
| 认证失败 | 检查 API Key 是否复制完整，是否填在 OpenAI Compatible API Key 字段 |
| 模型不存在 | 检查 Model ID 是否与平台模型列表完全一致 |
404 | 检查 Base URL 是否为 https://a.skypool.xyz/v1，不要加 /chat/completions |
| 输出很短 | 调高 Max Output Tokens |
| 工具调用不稳定 | 确认模型适合工具调用，并在 Cline 模型配置中启用对应能力 |