两步就好:拿到 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
你还没登录,或者登录已过期。
会在新标签页打开;登录后回到这里,列表会自动出现。
Claude 分组的 key (Claude Code / OpenCode)
OpenAI 分组的 key (Codex / OpenCode)
没有找到启用中的 key。先去 API 密钥 页建一把(分组选你买的套餐对应的分组)。
没登录,或在别的电脑上?手动粘贴 key 生成文件
只有一种就只填一个。
key 只在你的浏览器里使用:配置文件是在本机生成的,这个页面不会把 key 发到任何地方。文件里有 key,别发给别人。
已下载 agentsrelay-config.json(在你的「下载」文件夹)。接着复制下面的 prompt。
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):
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+):
& ([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 存在环境变量里,要新开一个终端窗口才生效;从图形界面启动的应用可能读不到,改从终端启动。