在 Cline 中使用 OceanToken
Cline 通过它的 OpenAI Compatible 提供商在 OceanToken 上运行。你要给它提供基础地址(Base URL)、API Key 和模型 ID。Cline 的工具照常可用:读取和编辑文件、运行命令、流式输出回复;在接受图像输入的模型上,还能使用截图。以下步骤已于 2026-10-18 用 Cline CLI 3.0.73 测试过。Cline 的 VS Code 扩展使用相同的提供商代码。
开始之前
为 Cline 创建一个 API Key,并给它设置 消费上限。智能体会发出大量请求,消费上限决定了这个 API Key 最多能花多少钱。如何把 API Key 保存在环境变量中并检查它,见开始之前。
在 VS Code 中设置
- 打开 Cline 的设置。
- 把 API Provider(API 提供商)设为 OpenAI Compatible。
- 把 Base URL 设为
https://api.oceantoken.ai/v1。 - 把你的 OceanToken API Key 粘贴到 API Key。
- 把 Model ID 设为下表中的一个模型,例如
openai/gpt-5.5。Cline 加载的列表包含你的 API Key 能用的所有模型,包括图像、视频和语音模型。请选择文本模型。 - 在 Model Configuration(模型配置)下:
- 如果模型的 图像 列为「是」,打开 Supports Images(支持图像);其他模型关闭它。
- 把 Context Window Size 设为表中该模型的上下文窗口。
- 把 Max Output Tokens 设为
32000。 - Reasoning Effort(推理强度)可选。Cline 会以
reasoning_effort把它发送给模型。
- 开始一个简短的任务,例如「列出这个文件夹里的文件」,检查设置是否正确。
设置 Cline CLI
保存一次提供商设置:
cline auth openai-compatible -k "$OCEANTOKEN_API_KEY" -b https://api.oceantoken.ai/v1 -m openai/gpt-5.5
然后检查:
cline "Reply with the single word OK"
cline auth 会把 API Key 保存在 Cline 的设置文件里。想在某一次运行中换用别的模型,加上 -m <model id>;用 --thinking low、medium 或 high 设置推理强度。
推荐模型
这些模型都用 Cline 的工具测试过。把上下文窗口的数值填进 Context Window Size。Max Output Tokens 保持 32,000:一轮编程对话很少需要更多,而较小的上限能限制单次回复的最高费用。每个模型的价格见它在 oceantoken.ai 上的页面,从 价格 一列点进去。模型页列出了所有模型。
| 模型 ID | 上下文窗口 | 最大输出 | 图像 | 价格 |
|---|---|---|---|---|
anthropic/claude-sonnet-5.5 | 1,000,000 | 128,000 | 是 | 在官网查看 |
anthropic/claude-opus-5.5 | 1,000,000 | 128,000 | 是 | 在官网查看 |
anthropic/claude-haiku-4.5 | 200,000 | 64,000 | 是 | 在官网查看 |
openai/gpt-5.5 | 922,000 | 128,000 | 是 | 在官网查看 |
deepseek/deepseek-v4-pro | 1,048,576 | 393,216 | 否 | 在官网查看 |
deepseek/deepseek-v4.1-flash | 1,048,576 | 943,718 | 是 | 在官网查看 |
qwen/qwen3.8-flash | 983,616 | 131,072 | 是 | 在官网查看 |
z-ai/glm-5.3 | 1,048,576 | 943,718 | 否 | 在官网查看 |
提示缓存
Cline 每一轮都会发送同样的长提示,所以 缓存输入 价格和输入价格一样重要。
-
GPT、DeepSeek、Qwen 和 GLM 模型会自动缓存提示中重复的部分。从任务的第二轮起,这部分按缓存输入价格计费。
-
Claude 只在请求要求缓存时才缓存,而 Cline 的 OpenAI Compatible 提供商不会发出这个要求。在这个提供商上,Claude 的每一轮都按完整的输入价格计费。使用 Claude 时,请改用 Cline 的 Anthropic 提供商,它会要求缓存:
- 把 API Provider 设为 Anthropic。
- 把你的 OceanToken API Key 粘贴到 API Key。
- 打开 Use custom base URL(使用自定义基础地址),填入
https://api.oceantoken.ai/v1。 - 把 Model 设为
claude-sonnet-5-5、claude-opus-5-5或claude-haiku-4-5。这些是 Anthropic 自己的模型名称。OceanToken 把它们作为与anthropic/claude-sonnet-5.5、anthropic/claude-opus-5.5和anthropic/claude-haiku-4.5相同的模型提供,价格也相同。 - Adaptive Thinking 保持 None。如果你希望 Claude 先思考再回答,请使用上面的 OpenAI Compatible 设置。
每个请求的费用(包括缓存输入)都可以在控制台的日志中查看。
故障排查
| 你看到的 | 怎么处理 |
|---|---|
Invalid API key. Check the key, or create one in the OceanToken console. | API Key 有误、已被撤销,或带了多余的空格。重新粘贴一次,或新建一个。 |
Unknown model '…'. GET /v1/models lists the models your key can use. | 模型 ID 要完全按照模型页的写法填写,前面带上发布方(写 deepseek/deepseek-v4-pro,而不是 deepseek-v4-pro)。使用 Anthropic 提供商时,请用 Anthropic 的名称,例如 claude-sonnet-5-5。 |
刚附加图片就出现 This model does not accept image input. 或 The upstream model provider returned an error. | 这个模型只能读文本。为它关闭 Supports Images,或选择 图像 列为「是」的模型。 |
Insufficient balance - please add credit to continue. | 充值。如果你还有余额,请调低 Max Output Tokens:只有当你的余额足以支付这次回复可能产生的最高费用时,请求才会开始。 |
使用 Anthropic 提供商时出现 reasoning part 0 not found | 把 Adaptive Thinking 设为 None,或使用 OpenAI Compatible 设置。 |
| 模型列表里有几百个模型 | 它列出了你的 API Key 能用的所有模型。直接输入上表中的模型 ID。 |