RealRelay.ai
编码智能体

Cline 接入指南

用 OpenAI Compatible 提供商把适用于 VS Code 和 JetBrains 的 Cline 插件接入 RealRelay.ai：安装、填写基础地址、密钥和模型、设置模型限制并检查连接。

创建 API 密钥浏览目录
协议
OpenAI Chat Completions
基础地址
https://www.realrelay.ai/v1
官方文档
docs.cline.bot
已对照工具官方文档核对
2026-10

概览

Cline 是一个运行在编辑器中的开源编码智能体。它会规划改动、编辑文件、运行终端命令，除非你允许它直接执行，否则每一步之前都会先征求你的同意。用它的 OpenAI Compatible 提供商即可接入 RealRelay.ai，请求会发到 Chat Completions 端点 /v1/chat/completions。

  • 一个从控制台的 API 密钥页面获取的 API 密钥。

  • 末尾带 /v1 的基础地址。Cline 会在后面拼上 /chat/completions。

  • 一个与 GET /v1/models 列出的完全一致的模型 ID，例如 z-ai/glm-5.2。请选择支持工具调用、上下文至少 64K 的模型。

Cline 无法从 RealRelay.ai 读取模型的上下文窗口和输出上限。如果留空，它会假定窗口为 128,000 token。请按“配置”一节所示自行设置。

安装

从编辑器自带的扩展市场安装 Cline，无需另外下载。

  1. 1

    打开扩展视图

    在 Windows 和 Linux 上按 Ctrl+Shift+X，在 macOS 上按 Cmd+Shift+X。

  2. 2

    安装 Cline

    搜索 Cline，点击 Install。同样的步骤也适用于 Cursor、Windsurf 和 VSCodium。

  3. 3

    打开 Cline

    点击侧边栏中的 Cline 图标。

  1. 1

    打开插件市场

    进入 Settings → Plugins → Marketplace。

  2. 2

    安装 Cline

    搜索 Cline，点击 Install，然后重启 IDE。

  3. 3

    打开 Cline

    进入 View → Tool Windows → Cline。

Cline 也提供自己的付费账户和订阅。使用 RealRelay.ai 不需要这两者：在设置中选择你自己的提供商就够了。

配置

  1. 1

    打开设置

    点击 Cline 面板顶部的设置图标（⚙）。

  2. 2

    选择提供商

    在 API Provider 列表中选择 OpenAI Compatible。

  3. 3

    填写连接信息

    填入基础地址，把 sk-*** 替换为你的密钥，然后输入或选择模型 ID。

    Cline → Settings (⚙) → API Configuration
    1API Provider:  OpenAI Compatible2Base URL:      https://www.realrelay.ai/v13API Key:       sk-***4Model ID:      z-ai/glm-5.2
  4. 4

    设置模型限制

    点击 Model Configuration 展开，然后填写下列字段。请使用模型目录页上的数值；这里显示的值是安全下限，并不是模型的真实限制。

    Cline → Settings → Model Configuration
    Supports Images:      off (on only for models that accept images)Context Window Size:  200000Max Output Tokens:    32000

  • Base URL 是唯一决定请求发往何处的字段。它必须以 /v1 结尾，后面不能再有其他内容。

  • Model ID 要保留斜杠前面的部分。单独的 glm-5.2 不是 RealRelay.ai 的模型 ID。

  • Context Window Size 告诉 Cline 对话何时快满了。Max Output Tokens 限制单次回复的长度。

  • Supports Images 默认开启。对于纯文本模型请关闭它，这样 Cline 就不会给它们发送截图。

  • 保持 Use Azure Identity Authentication 关闭。RealRelay.ai 使用 API 密钥认证。

验证

  1. 1

    直接调用端点

    用你的密钥运行这条命令。如果返回的 JSON 包含 choices 数组，说明地址、密钥和模型都没问题。

    Terminal
    1curl -sS "https://www.realrelay.ai/v1/chat/completions" \2  -H "Authorization: Bearer sk-***" \3  -H "content-type: application/json" \4  -d '{"model": "z-ai/glm-5.2", "max_tokens": 16, "messages": [{"role": "user", "content": "Reply with OK"}]}'
  2. 2

    给 Cline 一个小任务

    打开一个项目目录，新建任务，发送一个会让 Cline 使用工具、但不修改任何内容的请求。

    Cline → New task
    List the files in this folder and say which one looks like the entry point. Do not change anything.
  3. 3

    检查结果

    Cline 应先请求读取该目录，然后作答。这说明模型能调用工具。该请求也会出现在控制台的用量日志中。

模型

要切换模型，打开设置并修改 Model ID。填好基础地址和密钥后，Cline 会从 RealRelay.ai 加载模型列表，你可以从中选择，也可以直接输入 ID。每次切换都要更新 Model Configuration，因为限制是跟着模型走的。

Cline 有两种模式：Plan 只读取和讨论，Act 才会做出改动。如果想用更强的模型做规划、用更快的模型做编辑，请在设置中开启 Use different models for Plan and Act modes，然后分别配置两种模式。

适合编码智能体的模型列在选择模型中。

故障排查

  • “Invalid API Key”或 401。密钥有误，或首尾带有空格。从控制台重新粘贴。

  • 404。基础地址缺少 /v1，或者已经以 /chat/completions 结尾。它应以 /v1 结尾。

  • “Model Not Found”。模型 ID 与 GET /v1/models 不完全一致。检查前缀和大小写。

  • 模型列表一直是空的。Cline 无法读取 /v1/models，通常是因为基础地址或密钥有误。先修正这两项。你仍然可以手动输入模型 ID。

  • 长任务中出现上下文报错，或对话过早被截断。Model Configuration 中的上下文窗口与模型不符。把它设为模型的真实上限。

  • 附加图片时报错。该模型只支持文本。关闭 Supports Images，或换一个支持图片的模型。

  • Plan 模式正常而 Act 模式失败，或者反过来。你开启了 Plan 和 Act 分别使用不同模型，而其中一种模式仍是旧设置。请把两种模式都配置好。

  • 模型会回答，但从不编辑文件或运行命令。Cline 发送的提示词很长，并且依赖工具调用。请从目录中选择支持工具调用的模型。