RealRelay.ai
编码智能体

Kilo Code 接入指南

把 RealRelay.ai 作为 OpenAI 兼容的自定义提供商，接入 VS Code 中的 Kilo Code 和 Kilo CLI：添加提供商、设置 token 限制、检查连接并切换模型。

创建 API 密钥浏览目录
协议
OpenAI Chat Completions · OpenAI Responses
基础地址
https://www.realrelay.ai/v1
官方文档
kilo.ai
已对照工具官方文档核对
2026-10
实验性. 尚未在 RealRelay.ai 上端到端跑通。步骤依据该工具的官方文档；如果某一步失败，请带上错误信息联系支持。

概览

Kilo Code 是一个开源编码智能体。它既可以作为 VS Code 扩展运行，也可以作为终端应用 Kilo CLI 运行；当前的扩展基于 CLI 构建，并与其共用配置。你用 OpenAI Compatible API 把 RealRelay.ai 添加为自定义提供商后，Kilo 会把请求发到 Chat Completions 端点 /v1/chat/completions。

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

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

  • 一个与 GET /v1/models 列出的完全一致的模型 ID，例如 z-ai/glm-5.2。该模型需要支持工具调用。

本指南为实验性：它依据 Kilo 的文档编写，但尚未在 RealRelay.ai 上端到端跑通。自定义提供商表单中没有 token 限制字段，所以下面有一步需要手动编辑配置文件。

安装

  1. 1

    打开扩展视图

    按 Ctrl+Shift+X（macOS 上为 Cmd+Shift+X），搜索“Kilo Code”。

  2. 2

    安装当前版本

    点击 Install 旁边的箭头，选择 Install Pre-Release Version。Kilo 通过 Marketplace 的这个渠道发布当前版本的扩展，并推荐所有人使用。

使用 Open VSX Registry 的编辑器（如 VSCodium）可以在扩展视图中以同样的名称找到 Kilo Code。你也可以从 Kilo 的 GitHub releases 下载 .vsix，然后使用 Install from VSIX… 安装。

npm
npm install -g @kilocode/clikilo --version

如果 kilo --version 输出了版本号，说明安装成功。

配置

  1. 1

    打开自定义提供商表单

    在 Kilo Code 中打开 Settings（齿轮图标），进入 Providers 标签页，滚动到底部，点击 Custom provider。

  2. 2

    填写字段

    基础地址和密钥有效时，Kilo 会从 RealRelay.ai 获取模型列表。只勾选你打算使用的模型，或者手动输入 ID。点击 Submit。

    Kilo Code → Settings → Providers → Custom provider
    1Provider ID:   realrelay2Display name:  RealRelay.ai3Provider API:  OpenAI Compatible4Base URL:      https://www.realrelay.ai/v15API key:       sk-***6Models:        z-ai/glm-5.2
  3. 3

    在配置文件中添加 token 限制

    Kilo 会把提供商保存在全局配置中。打开 ~/.config/kilo/kilo.jsonc（或同一目录下的 kilo.json），找到 provider.realrelay.models，为每个模型添加限制：

    ~/.config/kilo/kilo.jsonc → provider.realrelay.models
    1"z-ai/glm-5.2": {2  "name": "z-ai/glm-5.2",3  "tool_call": true,4  "limit": {5    "context": 200000,6    "output": 320007  }8}
  1. 1

    把密钥存进环境变量

    配置从 REALRELAY_API_KEY 读取密钥，这样文件本身不含任何机密。

    ~/.zshrc · ~/.bashrc
    export REALRELAY_API_KEY="sk-***"
    Windows PowerShell
    [Environment]::SetEnvironmentVariable("REALRELAY_API_KEY", "sk-***", "User")
  2. 2

    把提供商添加到 kilo.jsonc

    修改后重启 CLI。项目目录中的 kilo.jsonc 会覆盖全局文件。

    ~/.config/kilo/kilo.jsonc
    1{2  "$schema": "https://app.kilo.ai/config.json",3  "provider": {4    "realrelay": {5      "npm": "@ai-sdk/openai-compatible",6      "name": "RealRelay.ai",7      "env": ["REALRELAY_API_KEY"],8      "options": {9        "baseURL": "https://www.realrelay.ai/v1"10      },11      "models": {12        "z-ai/glm-5.2": {13          "name": "z-ai/glm-5.2",14          "tool_call": true,15          "limit": {16            "context": 200000,17            "output": 3200018          }19        }20      }21    }22  },23  "model": "realrelay/z-ai/glm-5.2"24}

  • Provider ID（realrelay）是你给提供商起的名字，只能包含小写字母、数字、连字符和下划线。模型引用以它开头，例如 realrelay/z-ai/glm-5.2。

  • Provider API 选 OpenAI Compatible，等同于文件中的 "npm": "@ai-sdk/openai-compatible"。两者都发送 Chat Completions 请求。

  • limit.context 是模型的上下文窗口，limit.output 是最大输出。不设置时两者都为 0：Kilo 会关闭自动压缩，并把输出上限设为 32,000 token。

  • env 指定保存密钥的变量名。在 VS Code 中，你输入的密钥与配置文件分开存储。

验证

  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

    在 VS Code 中检查

    RealRelay.ai 现在应出现在已连接的提供商中。在模型选择器中选择它的一个模型，发一条简短消息。该请求会出现在控制台的用量日志中。

  3. 3

    在 CLI 中检查

    第一条命令应把你的模型列为 realrelay/…。第二条会发送一条消息并打印回复。

    Terminal
    kilo models realrelaykilo run -m "realrelay/z-ai/glm-5.2" "Reply with OK"

模型

在 VS Code 中，通过模型选择器选择模型。要添加或移除模型，在 Providers 标签页中点击 RealRelay.ai 旁边的 Edit provider。在 CLI 中，使用 /models，或者用 kilo -m 加 realrelay/ 和模型 ID 启动。每个添加的模型都需要自己的 limit 条目。

这些示例中的限制是安全的起始值。请把它们设为模型目录页上的真实数值。

少数 OpenAI 模型在 Responses 端点 /v1/responses 上提供。请用 OpenAI Responses API 把它们添加为第二个自定义提供商，其余模型仍使用第一个提供商：

Kilo Code → Settings → Providers → Custom provider
1Provider ID:   realrelay-responses2Display name:  RealRelay.ai (Responses)3Provider API:  OpenAI Responses4Base URL:      https://www.realrelay.ai/v15API key:       sk-***6Models:        openai/gpt-5.3-codex
~/.config/kilo/kilo.jsonc → provider
1"realrelay-responses": {2  "npm": "@ai-sdk/openai",3  "name": "RealRelay.ai (Responses)",4  "env": ["REALRELAY_API_KEY"],5  "options": { "baseURL": "https://www.realrelay.ai/v1" },6  "models": {7    "openai/gpt-5.3-codex": {8      "name": "openai/gpt-5.3-codex",9      "tool_call": true,10      "limit": { "context": 400000, "output": 128000 }11    }12  }13}

哪些模型适合智能体、哪些模型在 Responses 端点上提供，请见选择模型。

故障排查

  • 填入基础地址后没有出现任何模型。URL 或密钥有误，导致获取模型列表失败。修正后点击 Fetch models，或者手动输入模型 ID。

  • “Invalid API Key”或 401。在提供商表单中重新输入密钥。在 CLI 中，请确认启动 kilo 的终端里设置了 REALRELAY_API_KEY，并检查已保存的凭据：

    Terminal
    kilo auth list

  • 404。基础地址缺少 /v1，或者路径有拼写错误。请使用以 /v1 结尾的地址。

  • “Model Not Found”。模型 ID 必须与 GET /v1/models 完全一致，包括斜杠前面的部分。

  • 对话不断变长，直到请求被拒绝。该模型没有 limit.context，所以压缩处于关闭状态。按“配置”一节添加限制。

  • 回复中断，并提示响应可能不完整。模型达到了 limit.output。把它调高，最多到模型的真实上限。

  • Responses 提供商下的模型报错。只有“选择模型”中列出的模型在 /v1/responses 上提供。请把其他模型移回 OpenAI Compatible 提供商。