文档

编码智能体

把 Claude Code、Codex CLI、Cursor、OpenCode、Cline 等编码智能体接入 RealRelay.ai 的分步指南，并说明每个工具需要的基础地址、密钥和模型。

开始之前

这些页面里的每个智能体都需要同样的三样东西。区别只在于填在哪里，以及该智能体接受两种基础地址形式中的哪一种。

API 密钥。在控制台的 API 密钥页面创建一个。只要智能体支持，各指南都从名为 REALRELAY_API_KEY 的环境变量读取密钥；切勿把它粘贴到会提交进仓库的文件里。
基础地址。使用 OpenAI 协议的智能体填以 /v1 结尾的地址。Claude Code 使用 Anthropic 协议，填不带 /v1 的地址，因为它会自己拼上 /v1/messages。每篇指南都会写明需要哪一种。
模型 ID。按 GET /v1/models 或模型目录列出的原样填写，包括前缀，例如 anthropic/claude-sonnet-4-6。参见模型 ID。

OpenAI-compatible (Chat Completions, Responses)

https://www.realrelay.ai/v1

Anthropic Messages (Claude Code)

https://www.realrelay.ai

每篇指南都在其标注的月份对照工具自身的文档核对过。这些工具更新很快；如果某个设置不在指南所说的位置，请以工具的文档为准。标为“实验性”的指南尚未在 RealRelay.ai 上端到端跑通。

智能体使用的协议决定了它能用好哪些模型。

Anthropic Messages（Claude Code）。以下 Claude 模型在 /v1/messages 上原生提供：
- anthropic/claude-opus-5-5
- anthropic/claude-opus-5
- anthropic/claude-sonnet-5
- anthropic/claude-fable-5
- anthropic/claude-opus-4-8
- anthropic/claude-opus-4-7
- anthropic/claude-sonnet-4-6
- anthropic/claude-opus-4-6
- anthropic/claude-haiku-5-5
- anthropic/claude-sonnet-5-5
- anthropic/claude-fable-5-1
- anthropic/claude-opus-4-5-20251101
- anthropic/claude-haiku-4-5-20251001
- anthropic/claude-sonnet-4-5-20250929
其他模型可以经协议转换访问，但它们的工具调用和扩展思考只能尽力而为。
OpenAI Responses（Codex CLI）。只有在 /v1/responses 上提供的模型可用：
- openai/gpt-5.5-pro
- openai/gpt-5.4-pro
- openai/gpt-5.3-codex
- openai/gpt-5.2-pro
- openai/gpt-5-pro
- openai/o1-pro
OpenAI Chat Completions（其他大多数智能体）。模型目录中的任意文本模型都可以。智能体通过工具调用来编辑文件，所以请选择支持工具调用、上下文窗口至少 64K token 的模型。

每篇指南都有自己的故障排查一节。下面这些原因是所有指南共通的。

在控制台的用量日志中检查该请求，或联系支持，并附上所用智能体、其版本和错误信息。