Agents relay 一键配置 Claude Code / Codex / OpenCode

两步就好:拿到 key,再把一段 prompt 交给你电脑上正在用的 AI 助手,它会替你把客户端配好。

1买套餐,拿 key

在 购买页 选套餐。买好后到 API 密钥 页确认有一把启用中的 key。

Claude 套餐对应「Claude 分组」的 key,给 Claude Code 用;ChatGPT 套餐对应「OpenAI 分组」的 key,给 Codex 用。OpenCode 两种都能用。

截图前遮住 key:要把 key 页、终端或配置文件截图发给别人(包括 AI 助手)时,先把 key 遮住。key 露出去了就到 API 密钥 页删掉它,重新建一把。
Cover your key before taking a screenshot. If a key was exposed, delete it on the API Keys page and create a new one.

目前可用 Claude 模型:Opus 5.5(默认)、Sonnet 5、Haiku 4.5;Sonnet 5.5 待上游开通;Fable 不提供。
Claude models available now: Opus 5.5 (default), Sonnet 5, Haiku 4.5; Sonnet 5.5 awaits upstream; Fable is not offered.

2下载配置文件,复制 prompt 给你的 agent

正在读取你的 key…
没登录,或在别的电脑上?手动粘贴 key 生成文件

只有一种就只填一个。

key 只在你的浏览器里使用:配置文件是在本机生成的,这个页面不会把 key 发到任何地方。文件里有 key,别发给别人。

把这段 prompt 发给你电脑上的 AI 助手

Claude Code、Codex、OpenCode,或者你正在用的其它编程助手都可以。它只会移动配置文件、运行一条配置命令,不会读取你的 key。

请帮我把这台电脑上的 AI 编程客户端(Claude Code / Codex / OpenCode)接到 agentsrelay 的包月套餐。严格按下面的步骤做,不要自己改任何配置文件。

【安全规则,必须遵守】
- 我已经在 agentsrelay 网站下载了配置文件 agentsrelay-config.json,里面有我的 API key。不要用 cat、type、Get-Content、编辑器或任何其他方式读取、打印、搜索这个文件的内容,也不要把它贴进对话。你只需要移动它、运行配置命令。
- 不要向我要 key。如果我把 key 贴进了对话,提醒我去 agentsrelay.net 的「API 密钥」页删掉这把 key,重新建一把。
- 配置命令的输出里不会出现 key(只显示末 4 位),可以放心转告我。

【第 1 步:看系统和已装的客户端】
判断这是 macOS、Linux 还是 Windows(Windows 下用 PowerShell)。分别运行 claude --version、codex --version、opencode --version,告诉我装了哪几个。
如果三个都没装,问我想用哪个,然后安装(需要 Node.js 18 或更新版本;没有 Node.js 就先停下,告诉我去 https://nodejs.org 下载安装 LTS 版):
  Claude Code:npm install -g @anthropic-ai/claude-code
  Codex:npm install -g @openai/codex
  OpenCode:npm install -g opencode-ai
如果下载很慢或超时,在同一条命令末尾加上 --registry=https://registry.npmmirror.com 再试一次。

【第 2 步:把配置文件移到固定位置(只移动,不读内容)】
配置文件默认在下载目录:macOS / Linux 是 ~/Downloads/,Windows 是 %USERPROFILE%\Downloads\。文件名是 agentsrelay-config.json;如果下载过多次,可能叫 agentsrelay-config (1).json 之类,用修改时间最新的那个。只用 ls / dir 看文件名,不要打开文件。
  macOS / Linux:mkdir -p ~/.config/agentsrelay && mv "<找到的文件>" ~/.config/agentsrelay/agentsrelay-config.json && chmod 600 ~/.config/agentsrelay/agentsrelay-config.json
  Windows:New-Item -ItemType Directory -Force "$HOME\.config\agentsrelay" | Out-Null; Move-Item -Force "<找到的文件>" "$HOME\.config\agentsrelay\agentsrelay-config.json"
找不到就问我文件放在哪里(只问路径)。

【第 3 步:运行配置命令(只运行这一条)】
  macOS / Linux:curl -fsSL https://agentsrelay.net/onboard/agentsrelay-setup.sh | sh
  Windows:irm https://agentsrelay.net/onboard/agentsrelay-setup.ps1 | iex
它会先备份原有配置,再合并写入(保留我原来的设置),然后实际调用一次接口,最后启动客户端问一句话验证。大约 1 到 3 分钟。如果提示缺少 Python,按提示问我要不要安装,装好后重新运行这一条。

【第 4 步:把结果告诉我】
把输出里「== 结果 ==」后面的内容转告我(要我截图给你的话,提醒我截图前先遮住 key)。如果有 [失败] 或 [注意],照着输出里的说明告诉我该怎么做,不要自己去改配置文件。
需要撤销时,运行:
  macOS / Linux:python3 ~/.config/agentsrelay/agentsrelay-setup.py --restore
  Windows:python "$HOME\.config\agentsrelay\agentsrelay-setup.py" --restore
最后提醒我:新开一个终端窗口,再运行 claude、codex 或 opencode。

或者:自己在终端里跑一条命令(粘贴 key,输入时不显示)

在 Ubuntu(WSL)/ Linux / macOS 的终端里运行(需要 Python 3.8+ 和 curl):

配置电脑上已装的 Claude Code / Codex / OpenCode
curl -fsSL https://agentsrelay.net/onboard/agentsrelay-setup.sh | sh -s -- --paste

只配一个就在末尾加 --only codex 或 --only claude,脚本只会问那一组的 key。WSL 里配的是 Ubuntu 里的客户端,和 Windows 那边互不影响。

Agent J 用户:在 Ubuntu 里跑 agentj.app/install.sh,选中转、粘 key 即可。
Agent J users: run agentj.app/install.sh in Ubuntu, choose the relay, and paste your key.

在 PowerShell 里运行(需要 Python 3.8+):

配置电脑上已装的 Claude Code / Codex / OpenCode
& ([scriptblock]::Create((irm https://agentsrelay.net/onboard/setup.ps1))) --paste

只配一个就在末尾加 --only codex 或 --only claude。

粘贴 key 时屏幕上不显示任何字符,是正常的,粘完直接回车。输出里只显示 key 末 4 位;截图前仍请确认屏幕上没有露出完整 key。
The key is hidden while you paste it. Output only shows the last 4 characters; still check that no full key is on screen before taking a screenshot.

备选:不下载文件,在终端里粘贴 key

把这段 prompt 发给 AI 助手。它会下载配置脚本,然后请你在自己的终端里运行一条命令、粘贴 key(输入时不显示)。

请帮我把这台电脑上的 AI 编程客户端(Claude Code / Codex / OpenCode)接到 agentsrelay 的包月套餐。这次不用配置文件,key 由我自己在终端里粘贴。严格按下面的步骤做。

【安全规则,必须遵守】
- 不要向我要 key,也不要把 key 写进任何命令或文件。如果我把 key 贴进了对话,提醒我去 agentsrelay.net 的「API 密钥」页删掉这把 key,重新建一把。
- 配置脚本的输出里不会出现 key(只显示末 4 位)。

【第 1 步:看系统和已装的客户端】
判断这是 macOS、Linux 还是 Windows(Windows 下用 PowerShell)。分别运行 claude --version、codex --version、opencode --version。三个都没装就问我想用哪个,用 npm install -g @anthropic-ai/claude-code / @openai/codex / opencode-ai 安装(需要 Node.js 18+;下载慢就在命令末尾加 --registry=https://registry.npmmirror.com)。

【第 2 步:下载配置脚本】
  macOS / Linux:mkdir -p ~/.config/agentsrelay && curl -fsSL https://agentsrelay.net/onboard/agentsrelay-setup.py -o ~/.config/agentsrelay/agentsrelay-setup.py
  Windows:New-Item -ItemType Directory -Force "$HOME\.config\agentsrelay" | Out-Null; Invoke-WebRequest -UseBasicParsing https://agentsrelay.net/onboard/agentsrelay-setup.py -OutFile "$HOME\.config\agentsrelay\agentsrelay-setup.py"

【第 3 步:让我自己运行粘贴命令】
这一步需要我在自己的终端窗口里输入 key,你的命令行看不到输入框。请把下面这条命令原样发给我,让我复制到一个新的终端窗口里运行,按提示粘贴 key(输入时不显示,属于正常现象),运行完把输出贴回给你(截图前先遮住 key)。只配 Codex 就在命令末尾加 --only codex,只配 Claude Code 就加 --only claude,脚本只会问那一组的 key:
  macOS / Linux:python3 ~/.config/agentsrelay/agentsrelay-setup.py --paste
  Windows:python "$HOME\.config\agentsrelay\agentsrelay-setup.py" --paste
(如果提示没有 python3,告诉我怎么安装 Python 3。)

【第 4 步:看结果】
我贴回输出后,把「== 结果 ==」后面的内容解释给我。如果有 [失败] 或 [注意],照输出里的说明告诉我下一步,不要自己改配置文件。撤销用同一个脚本加 --restore。
备选:手动配置

把 <Claude key> / <OpenAI key> 换成你自己的 key。改之前先备份原文件;已有内容要保留,只加下面这些字段。

Claude Code

~/.claude/settings.json(Windows:%USERPROFILE%\.claude\settings.json)的 env 里加下面几项(后四项是默认模型;已有的模型设置能用就不用改):

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://agentsrelay.net",
    "ANTHROPIC_AUTH_TOKEN": "<Claude key>",
    "ANTHROPIC_MODEL": "claude-opus-5-5",
    "ANTHROPIC_DEFAULT_FABLE_MODEL": "claude-opus-5-5",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-5",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-4-5-20251001"
  }
}

顶层的 "model": "fable" 请删掉(本站不提供 Fable)。

~/.claude.json 里加 "hasCompletedOnboarding": true。之前登录过官方账号的,先在 Claude Code 里运行 /logout。

Codex

~/.codex/config.toml 最上面加两行(已有的 model_provider / model 改成这两行),文件末尾加一段:

model_provider = "agentsrelay"
model = "gpt-6-sol"

[model_providers.agentsrelay]
name = "agentsrelay"
base_url = "https://agentsrelay.net/v1"
wire_api = "responses"
env_key = "AGENTSRELAY_OPENAI_KEY"

然后设置环境变量 AGENTSRELAY_OPENAI_KEY:macOS / Linux 在 ~/.zshrc 或 ~/.bashrc 加 export AGENTSRELAY_OPENAI_KEY='<OpenAI key>';Windows 运行 [Environment]::SetEnvironmentVariable('AGENTSRELAY_OPENAI_KEY','<OpenAI key>','User')。新开终端生效。

OpenCode

~/.config/opencode/opencode.json 的 provider 里加两段(key 用环境变量,变量名 AGENTSRELAY_CLAUDE_KEY / AGENTSRELAY_OPENAI_KEY,设置方法同上):

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "agentsrelay-claude": {
      "npm": "@ai-sdk/anthropic",
      "name": "agentsrelay Claude",
      "options": {
        "baseURL": "https://agentsrelay.net/v1",
        "apiKey": "{env:AGENTSRELAY_CLAUDE_KEY}"
      },
      "models": { "claude-sonnet-5": {}, "claude-opus-5-5": {}, "claude-haiku-4-5-20251001": {} }
    },
    "agentsrelay-openai": {
      "npm": "@ai-sdk/openai",
      "name": "agentsrelay OpenAI",
      "options": {
        "baseURL": "https://agentsrelay.net/v1",
        "apiKey": "{env:AGENTSRELAY_OPENAI_KEY}"
      },
      "models": { "gpt-6-sol": {}, "gpt-5.6-sol": {} }
    }
  }
}

Claude 这一段的 baseURL 要带 /v1。使用时选 agentsrelay-claude/claude-sonnet-5 这类模型。

撤销 / 常见问题
  • 撤销:macOS / Linux 运行 python3 ~/.config/agentsrelay/agentsrelay-setup.py --restore;Windows 运行 python "$HOME\.config\agentsrelay\agentsrelay-setup.py" --restore。每运行一次回退一次配置。
  • 提示 key 无效:到 API 密钥 页确认 key 是启用状态、分组对应你买的套餐。
  • Claude Code 仍要求登录:在 Claude Code 里运行 /logout,再新开终端。
  • 目前可用 Claude 模型:Opus 5.5(默认)、Sonnet 5、Haiku 4.5;Sonnet 5.5 待上游开通;Fable 不提供。中转线最高 Opus 5.5:配置脚本会把默认模型设成 Opus 5.5,在 Claude Code 里选 Fable 也会用 Opus 5.5(按 Opus 计费)。
    Claude models available now: Opus 5.5 (default), Sonnet 5, Haiku 4.5; Sonnet 5.5 awaits upstream; Fable is not offered. The relay tops out at Opus 5.5: the setup script sets Opus 5.5 as the default, and choosing Fable in Claude Code also uses Opus 5.5 (billed as Opus).
  • Codex / OpenCode 找不到 key:key 存在环境变量里,要新开一个终端窗口才生效;从图形界面启动的应用可能读不到,改从终端启动。