把开发工具接入你的模型 API

01 · Prepare

开始前准备

1. 注册并登录 LLMRelayBox。
2. 确认账户有可用余额。
3. 进入“API 密钥”创建一个密钥，并妥善保存完整值。
4. 在“模型与价格”确认准备使用的模型名称。

OpenAI 兼容地址

https://llmrelaybox.top/v1

Anthropic 兼容地址

https://llmrelaybox.top

API Key

在控制台“API 密钥”页面创建，以 sk- 开头。

02 · Codex CLI

配置 Codex CLI

安装

npm install -g @openai/codex

安装完成后执行 codex --version 检查是否可用。

设置 API Key

macOS / Linux：

export OPENAI_API_KEY="你的 LLMRelayBox API Key"

Windows PowerShell：

$env:OPENAI_API_KEY="你的 LLMRelayBox API Key"

配置中转地址

编辑 ~/.codex/config.toml；Windows 一般位于 %USERPROFILE%\.codex\config.toml。

model = "gpt-5.5"
model_provider = "llmrelaybox"

[model_providers.llmrelaybox]
name = "LLMRelayBox"
base_url = "https://llmrelaybox.top/v1"
env_key = "OPENAI_API_KEY"
wire_api = "responses"

模型名称以本站“模型与价格”页面实际显示为准。保存后在项目目录执行 codex。

03 · Claude Code

配置 Claude Code

安装

npm install -g @anthropic-ai/claude-code

设置环境变量

macOS / Linux：

export ANTHROPIC_BASE_URL="https://llmrelaybox.top"
export ANTHROPIC_AUTH_TOKEN="你的 LLMRelayBox API Key"

Windows PowerShell：

$env:ANTHROPIC_BASE_URL="https://llmrelaybox.top"
$env:ANTHROPIC_AUTH_TOKEN="你的 LLMRelayBox API Key"

进入项目目录执行 claude。只有本站当前提供 Anthropic 兼容模型时，该工具才能正常调用。

04 · CC Switch

通过 CC Switch 管理配置

1. 从 CC Switch 官方发布页下载安装程序。
2. 打开 CC Switch，选择 Codex 或 Claude Code。
3. 添加“自定义供应商”。
4. 供应商名称填写 LLMRelayBox。
5. API Key 填写控制台创建的完整密钥。
6. Codex Base URL 填写 https://llmrelaybox.top/v1；Claude Code Base URL 填写 https://llmrelaybox.top。
7. 保存并启用该供应商，然后完全退出并重新启动对应开发工具。

05 · Verify

验证与常见排错

先验证 API

curl -H "Authorization: Bearer 你的 LLMRelayBox API Key" https://llmrelaybox.top/v1/models

常见问题

401

检查 API Key 是否完整、是否被禁用，以及请求头是否包含 Bearer。

402

账户余额不足或密钥额度不足，请先充值或调整密钥额度。

403

账号、分组、模型权限或上游风控限制，需要联系本站客服并提供请求 ID。

404

模型名或接口类型与渠道不兼容。Codex 应使用 Responses 接口。

429 / 503

并发达到限制、上游限流或暂时没有可调度账号，稍后重试并查看服务状态。