開發者文檔

程式碼代理

逐步說明如何將 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 的模型。

每份指南都有各自的疑難排解章節。以下原因則是所有代理共通的。

在主控台的用量日誌中檢查該請求,或聯絡支援,並附上代理名稱、版本與錯誤訊息。