跳到主要内容

在 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 中设置​

  1. 打开 Cline 的设置。
  2. 把 API Provider(API 提供商)设为 OpenAI Compatible。
  3. 把 Base URL 设为 https://api.oceantoken.ai/v1。
  4. 把你的 OceanToken API Key 粘贴到 API Key。
  5. 把 Model ID 设为下表中的一个模型,例如 openai/gpt-5.5。Cline 加载的列表包含你的 API Key 能用的所有模型,包括图像、视频和语音模型。请选择文本模型。
  6. 在 Model Configuration(模型配置)下:
    • 如果模型的 图像 列为「是」,打开 Supports Images(支持图像);其他模型关闭它。
    • 把 Context Window Size 设为表中该模型的上下文窗口。
    • 把 Max Output Tokens 设为 32000。
    • Reasoning Effort(推理强度)可选。Cline 会以 reasoning_effort 把它发送给模型。
  7. 开始一个简短的任务,例如「列出这个文件夹里的文件」,检查设置是否正确。

设置 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 上的页面,从 价格 一列点进去。模型页列出了所有模型。

提示缓存​

Cline 每一轮都会发送同样的长提示,所以 缓存输入 价格和输入价格一样重要。

  • GPT、DeepSeek、Qwen 和 GLM 模型会自动缓存提示中重复的部分。从任务的第二轮起,这部分按缓存输入价格计费。

  • Claude 只在请求要求缓存时才缓存,而 Cline 的 OpenAI Compatible 提供商不会发出这个要求。在这个提供商上,Claude 的每一轮都按完整的输入价格计费。使用 Claude 时,请改用 Cline 的 Anthropic 提供商,它会要求缓存:

    1. 把 API Provider 设为 Anthropic。
    2. 把你的 OceanToken API Key 粘贴到 API Key。
    3. 打开 Use custom base URL(使用自定义基础地址),填入 https://api.oceantoken.ai/v1。
    4. 把 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 相同的模型提供,价格也相同。
    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。