# 稳流 WenRelay 接入说明（面向用户与安装助手）

更新时间：2026-11-10。优先接入：Codex、Claude Code。网站：https://app.wenrelay.shop/ 。交互向导：https://app.wenrelay.shop/brand/start.html 。帮助中心：https://app.wenrelay.shop/brand/help.html 。

稳流提供模型 API 调用额度，不提供第三方工具会员。当前为受邀试点，模型美元价格已公开，注册需要限额邀请，充值按测试账号放行。用户应已有账号、可用模型和额度；不要更改平台权限来绕过这个前提。

## 给安装助手的执行要求

1. 先询问用户要使用哪个工具和操作系统；检查是否已有安装、配置、提供商和凭据。
2. 只使用下方官方安装入口。展示拟执行的安装命令和配置差异，再按用户授权执行。不要静默安装其他软件。
3. 保留原有配置，优先项目级或临时会话配置；合并稳流提供商，不整文件覆盖。不要删除其他提供商或更换用户的默认模型，除非明确要求。
4. 不在对话、日志、共享文件或公开链接里收集 API Key。让用户在客户端凭据界面填写，或在本机终端隐藏输入；展示结果时遮盖密钥。
5. 模型 ID 从用户账号可用目录中选取，不能凭空猜测。不要启用未知的上下文长度、图片或工具能力。
6. 先检查地址和配置，实际模型请求可能消耗额度，运行前说明范围。不要为了验证反复调用付费模型或执行模型返回的文件操作。
7. 结束时说明实际完成项、版本、测试结果和未验证范围。配置写入成功不代表已经通过真实模型调用。

## 统一准备

- API Key 在 https://app.wenrelay.shop/keys 创建；账号密码不是 API Key。
- 模型目录：https://app.wenrelay.shop/pricing 。只使用该账号/Key 可用的完整模型 ID。
- 钱包：https://app.wenrelay.shop/wallet 。调用记录：https://app.wenrelay.shop/usage-logs 。
- OpenAI 兼容 Base URL：`https://api.wenrelay.shop/v1`。
- Anthropic Messages 根地址：`https://api.wenrelay.shop`，最终请求路径 `/v1/messages`。
- 同一个工具不要重复添加 `/v1/v1`。根地址与 SDK 基址不同，按下方工具说明填写。

## Codex（优先，CLI）

官方安装：https://developers.openai.com/codex/cli 。第三方网关：https://developers.openai.com/codex/enterprise/connect-to-a-gateway 。配置规则：https://developers.openai.com/codex/config-file/config-advanced 。上述 Codex 资料于 2026-11-10 核对。

按官方页面选择操作系统和安装方式，重新打开终端运行 `codex --version`。稳流使用 `https://api.wenrelay.shop/v1`，协议为 **Responses**；选择账号已开放、支持 Responses 且 Codex 能识别其能力的精确模型 ID。自定义别名可能需要单独的 Codex 模型目录；普通 `/v1/models` 列表不等于 Codex 能力元数据。

交互向导默认显示 Codex，按 macOS Zsh、Linux Bash、Windows PowerShell 生成当前会话命令：隐藏输入 `WENRELAY_API_KEY`，通过 CLI `--config` 指定 `model_provider=wenrelay`，并配置以下提供商字段：

```toml
name = "WenRelay"
base_url = "https://api.wenrelay.shop/v1"
env_key = "WENRELAY_API_KEY"
wire_api = "responses"
requires_openai_auth = false
```

以上是 `[model_providers.wenrelay]` 的字段说明；直接使用向导生成的完整命令即可，不要把这段片段覆盖到已有配置文件。会话命令不会修改 `config.toml` 或写入真实 Key，也不会关闭 Codex 原有审批和沙箱保护。初次验证关闭联网搜索，确认提供商/模型后先做一次简短问题或只读代码解释，并在稳流核对请求和扣费。

如需持久配置，按官方文档在用户级配置中合并，先保留原有配置。Codex 0.134.0 起，CLI profile 使用 `~/.codex/<profile-name>.config.toml` 独立文件，不再读取旧的 `[profiles.<name>]` 写法。桌面应用和 IDE 不一定继承终端环境变量，需按官方网关文档单独处理；本页不把 CLI 会话配置等同于所有客户端均已验收。

## Claude Code（优先，CLI）

安装：https://code.claude.com/docs/en/quickstart 。网关设置：https://code.claude.com/docs/en/llm-gateway-connect 。

使用 `ANTHROPIC_BASE_URL=https://api.wenrelay.shop`、`ANTHROPIC_AUTH_TOKEN=用户的稳流Key`、`ANTHROPIC_MODEL=账号可用的Claude模型ID`。Base URL 不加 `/v1`。向导按 Windows PowerShell、macOS Zsh、Linux Bash 生成临时终端配置，隐藏输入 Key；不会修改全局 settings.json。已有 settings.json 中的同名变量可能优先生效，先检查冲突。

从设置变量的同一终端启动 `claude`，运行 `/status` 核对根地址和凭据来源，再做短消息验证。桌面启动的编辑器不一定继承终端环境；VS Code 扩展需按官方文档另行配置。本指引仅覆盖 Claude Code CLI 和 Claude 模型，不宣称所有高级功能已完成客户端验收。

## Cherry Studio

官方下载：https://www.cherry-ai.com/ 。官方配置文档：https://docs.cherryai.com.cn/pre-basic/providers/providers 。

在“设置 → 模型服务”添加 OpenAI 兼容服务，名称填写“稳流”。Cherry Studio 通常自动拼接 `/v1/chat/completions`，API 地址填根地址 `https://api.wenrelay.shop`，在客户端粘贴稳流 Key。获取模型列表并将需要的模型添加进列表，打开服务商启用开关。再选择模型检测或发送短消息。

向导提供可下载的文本配置清单，不假装这是 Cherry Studio 的一键导入文件。不同版本的最终 URL 预览若有差异，优先检查 `/v1` 是否重复。

## Cline（VS Code）

官方扩展：https://marketplace.visualstudio.com/items?itemName=saoudrizwan.claude-dev 。官方配置文档：https://docs.cline.bot/provider-config/openai-compatible 。

安装 VS Code 与 Cline，在 API Provider 选择 `OpenAI Compatible`。Base URL 填 `https://api.wenrelay.shop/v1`；Key 在客户端填写，Model ID 使用完整可用型号。上下文上限等按具体模型确认。首次验证使用测试项目，逐项确认任何文件操作。

向导提供文本清单，无客户端原生一键导入承诺。

## OpenCode

安装：https://opencode.ai/docs/ 。自定义提供商：https://opencode.ai/docs/providers/#custom-provider 。配置：https://opencode.ai/docs/config/ 。

向导生成标准 `opencode.json`，在测试项目根目录使用；存在同名配置时只合并 `provider.wenrelay`。示例：

```json
{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "wenrelay": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "WenRelay",
      "options": {"baseURL": "https://api.wenrelay.shop/v1"},
      "models": {"YOUR_MODEL_ID": {"name": "YOUR_MODEL_ID"}}
    }
  }
}
```

替换 `YOUR_MODEL_ID` 后启动 OpenCode。输入 `/connect` → Other → 提供商 ID `wenrelay`，在其凭据界面填写 Key；再输入 `/models` 选择 WenRelay 模型。此模板走 Chat Completions，未含 API Key、默认模型设置或权限放宽。

## 验证与常见错误

- 无 Key 访问 `/v1/models` 返回 401 只能证明网络到达鉴权层，不能证明凭据有效。
- 有 Key 获取模型列表不等于每个模型推理都可用；需要小范围真实请求验证。
- 401：确认完整稳流 Key、启用状态和地址，勿用网页密码。
- 404 / 无模型 / 无渠道：核对完整模型 ID、账号权限和 `/v1` 路径。
- 429：降低并发，按响应提示等待，不循环猛重试。
- 502/503：检查供给或账号可用组；不能直接推断为本地网络封锁。
- 流式中断：比较网页模型体验与客户端，核对超时、连接和上游状态。

## 支持方式

网站帮助中心无需 Telegram。机器人 https://t.me/wenrelay_assistant_bot 支持常见问题关键词和指令自动应答，不提供 AI 自由聊天或人工在线接线。绑定后可用 `/balance`、`/usage` 查自己的账户；`/invite` 说明限额邀请规则，`/topup`、`/keys` 打开网站入口，`/support` 提供售后邮箱。机器人不自行发放注册名额，也不处理资金变更。
