LLM Route
LLM Route 文档/快速上手
快速上手

连接 LLM Route

选择你要接入的工具，创建密钥并完成第一次模型调用。

Codex 桌面版

以下两种方案面向 Windows / macOS 的 Codex 桌面版。如果你不熟悉软件安装、API Key 和模型配置，推荐先让 WorkBuddy 帮忙操作。你只需要把任务交给它，并按提示完成必要的登录和授权。

方案一：WorkBuddy 帮我配置（推荐）先下载 WorkBuddy，复制下方提示词，让 AI 帮你推进安装、连接和验证方案二：我想自己手动配置预留约 20 分钟或更久；遇到下载、权限或连接问题，可能需要额外排查

方案一：使用 WorkBuddy 配置

不想自己研究配置？把任务交给 WorkBuddy

WorkBuddy 是可以执行本地任务的 AI 助手。先安装它，再让它按照本页文档协助安装 Codex、配置 CC Switch，并检查 LLM Route 是否连接成功。

  1. 下载并安装：前往 WorkBuddy 官网下载桌面客户端，选择与你电脑对应的 Windows 或 Mac 安装包，按安装提示完成安装。
  2. 打开并登录：启动 WorkBuddy，按界面提示登录，在新建任务的输入框中粘贴下面的提示词并发送。
  3. 按提示开启权限：允许本次配置需要的文件访问、命令执行或电脑操作权限，让 WorkBuddy 继续执行。登录、密钥输入和系统授权仍需要你配合完成。
复制后，直接粘贴给 WorkBuddy
请帮我在这台电脑上安装 Codex 桌面版，并连接到 LLM Route。请直接执行能完成的操作，不要只给我一份教程。

先阅读 https://doc.llmroute.top/connect 中从「安装 Codex」到「选择模型与验证连接」的手动步骤，按当前系统执行：
1. 检查 Windows / macOS、处理器架构，以及是否已安装 Codex 和 CC Switch。已安装的应用直接复用；修改现有配置前先备份，保留我的历史对话、其他供应商和无关设置。
2. 按文档链接下载并安装 Codex 桌面版和 CC Switch 安装版。
3. 打开 https://llmroute.top/ 的 API 密钥页面。需要登录、选择分组或输入密钥时，请打开对应页面让我完成，再继续。订阅用户选择自己的套餐分组；直接充值的用户选择「GPT 系列模型」。不要替我购买或充值，也不要在对话或完成报告中显示完整密钥。
4. 优先将密钥一键导入 CC Switch；如果失败，在 CC Switch 的 Codex 中手动添加自定义供应商。名称为 LLM Route，API 请求地址为 https://llmroute.top/v1，使用我自己的 API Key，默认模型优先选 gpt-6.1-sol，并确认该分组支持此模型；如果不支持，列出该分组可用的模型让我选择后继续。若显示 auth.json，核对 OPENAI_API_KEY 与输入的密钥一致。
5. 切换到刚配置的 LLM Route 供应商，确认显示「使用中」，然后完全退出并重新打开 Codex。
6. 在 Codex 中新建对话，选择上一步确认可用的模型（优先 GPT-6.1 Sol），发送一句「你好」，检查是否收到正常回复。若失败，继续按文档排查，不要仅凭安装完成就宣布连接成功。

执行过程中需要文件访问、运行命令或操作电脑权限时，请说明当前需要哪项授权，指导我开启后继续。系统密码、登录验证码和系统确认由我亲自完成。某一步无法自动操作时，只告诉我当前需要做的具体动作，等我完成后继续后面的步骤。
最后简要告诉我：哪些步骤已完成、是否收到 Codex 的回复，以及是否还有需要我处理的事项。

发送后跟着 WorkBuddy 的提示操作即可。如果它卡在某一步，把报错或截图继续发在同一个任务里，让它接着排查。是否配置成功，以重启 Codex 后能收到正常回复为准。

WorkBuddy 配置好了，我该怎么开始？重启 Codex，选择模型并发送一句「你好」，确认可以正常对话

WorkBuddy 安装与使用：官方快速开始。需要自己接着操作时，可以从下方手动步骤继续。

方案二：手动配置 · 1. 安装 Codex

本教程使用 Codex 桌面版。在官方下载页选择 Windows 或 macOS，下载安装后继续完成下面的连接设置。

↓ 下载 Codex 桌面版

如果官方地址无法访问，可前往 123 网盘下载。

2. 安装 CC Switch

CC Switch 用于管理 Codex 的模型连接。选择你的系统，下载并安装。

↓ 安装包（DMG）

安装包版本 v4.0.12 · 查看最新版本

3. 创建密钥并选择分组

进入 LLM Route 注册或登录，打开「API 密钥」，点击「创建密钥」。已有密钥的用户可以直接使用，但请先确认它选择了你要使用的分组。

在 API 密钥页面点击「创建密钥」

分组怎么选？按自己的购买方式选择

  • 购买了订阅套餐：在「分组」中选择与你购买的订阅套餐对应的分组。不同套餐的名称可能不同，以自己账号显示的选项为准。
  • 直接充值、按量使用：选择默认的「GPT 系列模型」（界面可能显示为「gpt 系列模型」）即可。

每个用户可选的分组可能不同，不需要和截图完全一样。请确认选中的是自己要使用的分组，再点击「创建」。如果找不到已购买套餐对应的分组，请先确认登录账号和订阅状态，再联系客服核对。

分组列表仅为示例：订阅用户选择对应套餐，充值用户选择「GPT 系列模型」

4. 添加到 CC Switch

下面两种方法任选一种。推荐先用一键导入；如果点击后没有反应、没有唤起 CC Switch，或导入失败，直接使用方法二：手动创建供应商。

方法一：一键导入（推荐）

在 LLM Route 的「API 密钥」列表中，找到刚才创建的密钥，点击该行的「导入到 CCS」。如果浏览器询问是否打开 CC Switch，允许打开，并按提示完成导入。

点击「导入到 CCS」，按提示将配置加入 CC Switch

导入成功后，直接继续第 5 步：切换供应商并重启。没有导入成功，再按下面的方法手动添加。

方法二：手动创建供应商

不需要重新创建密钥。使用上一步已经选好分组的 API Key，在 CC Switch 中手动填写配置即可。

  1. 复制自己的 API Key

    回到 LLM Route 的「API 密钥」页面，找到要使用的密钥，点击密钥右侧的复制图标。请复制完整密钥，不要手动输入列表中省略显示的内容。

    复制自己账号的完整 API Key

  2. 在 Codex 中添加「自定义配置」

    打开 CC Switch，在左侧选择 Codex，点击右上角「添加供应商」，再选择「自定义配置」。

    Codex → 添加供应商 → 自定义配置

  3. 填写连接信息并添加

    按下表填写表单。API 请求地址需要包含末尾的 /v1。

    字段填写内容
    名称LLM Route（也可以使用便于自己识别的名称）
    API Key粘贴刚才复制的完整密钥
    API 请求地址https://llmroute.top/v1
    默认模型gpt-6.1-sol（图中示例；请使用你的分组支持的模型）

    备注、官网链接、子代理模型等可选项可以留空，其余选项先保持默认。如果下方显示 auth.json，请确认其中的 OPENAI_API_KEY 与你粘贴的密钥一致，没有保留 yourapikey 占位内容。确认无误后，点击右下角「添加」。

    图中的 yourapikey 是占位示例，请替换为自己的 API Key；不要直接照抄

5. 切换供应商并重启

无论使用哪种方法，添加完成后都要回到 CC Switch 的 Codex 供应商列表，找到刚添加的 LLM Route，点击右侧的三角形「切换」按钮（部分版本显示为「启用 / Enable」）。确认该供应商显示「使用中」，然后完全退出并重新打开 Codex。

点击「切换」，确认 LLM Route 显示「使用中」，再重启 Codex

CC Switch 是配置工具，完成切换后，平时使用 Codex 不需要一直打开。

请先重启 Codex，再继续下一步

配置完成后，请完全退出 Codex 应用，再重新打开 Codex，让新的连接配置生效。接下来新建对话，选择模型并发送一条消息，确认连接成功。

6. 选择模型，发一句话试试

重启后，在哪里选择模型？

重新打开 Codex，点击「New chat / 新建对话」。在底部输入框下方打开模型与推理程度选择入口（图中为「Select effort」），点击当前模型名称，即可选择可用的模型。

日常任务推荐先用 GPT-6.1 Sol。模型列表以你的账号和分组支持的选项为准；截图中的 High 是推理程度，可以按任务需要调整。

在输入框下方选择模型与推理程度；点击图片可放大查看红框中的入口
我该怎么选择模型和推理程度？日常任务先用 GPT-6.1 Sol；查看不同任务的选择建议和价格说明

怎么确认已经连接成功？

选好模型后，在输入框中发送一句「你好」。收到正常回复，就可以开始给 Codex 安排任务了。

重启后还是无法回复？查看连接与 401 认证错误等常见问题的排查说明已经能对话了，接下来可以做什么？从一个简单任务开始，了解如何描述需求、提供材料和检查结果

Claude Code

此方式需要支持 Claude 的分组。先在控制台查看账号可用分组。若已开通，在对应分组创建密钥，打开密钥的使用说明并选择 Claude Code，按生成的配置在终端完成连接。发送一条消息验证。

Claude Code 网关接入说明

WorkBuddy 自定义模型

在支持自定义模型的版本中，打开「设置」→「模型」，新增兼容 OpenAI Chat Completions 的模型。填入 https://llmroute.top/v1/chat/completions、对应的 API Key 和分组支持的模型 ID。保存后选中该模型，发送一条消息验证。

WorkBuddy 自定义模型说明

API 与自建应用

在后端把兼容 OpenAI 的 SDK 基础地址设为 https://llmroute.top/v1，使用你的 API Key 和分组内的模型 ID 发起一次请求。按模型支持情况选择 Responses 或 Chat Completions 接口。密钥保存在后端环境变量中。