连接模型，开始工作。
先选择 Claude、GPT 或国产模型，再按你使用的软件查看接入配置。
快速开始
- 登录并准备余额。使用已有账号登录控制台，确认账号和余额；购买卡密后，到兑换页完成兑换。
- 创建一把 API Key。进入密钥管理，新建并复制 Key。可用型号以 Key 的实际范围为准。
- 配置客户端并发送消息。在客户端步骤选择软件，填好地址和 Key，发送“只回复 OK”，然后在用量记录查看费用。
Windows 使用 WorkBuddy：复制一条 Windows 命令，添加当前 Key 可用的 Chat 型号 →
复制 API 地址
创建账号、创建 Key、获取模型列表不产生模型调用费用；客户端发送消息或执行任务会按实际用量计费。
账号与 API Key
使用已有账号登录；需要开通账号时请联系客服。初始余额为 0 时，先兑换充值额度再发起模型请求。
创建与管理 Key
- 打开密钥管理，点击新建，填写一个自己容易识别的名称。
- 选择页面提供的综合服务范围，按需设置消费上限和有效期，然后保存。
- 复制 Key，在客户端的 API Key 字段粘贴。密钥页的「使用」也提供地址与配置。
同一把综合 Key 可以同时配置 GPT 和 Claude。客户端中的不同“模型服务商”只是协议配置，使用同一个账户余额，不需要分别充值或更换计费分组。
Key 额度是这把 Key 的消费上限，不会增加账户余额。不要在截图、群聊或代码仓库里公开完整 Key；泄露时先在密钥页停用，再替换客户端配置。
选择模型
在模型广场比较型号和价格，复制完整 Model ID。模型名必须精确匹配，例如 gpt-6.1-sol 或 claude-sonnet-5，不能使用自己起的显示名称。
| 模型 | 协议 | 完整请求路径 |
|---|---|---|
GPT，例如 gpt-6.1-sol | OpenAI Responses | POST /v1/responses |
Claude，例如 claude-sonnet-5、claude-opus-5 | Anthropic Messages | POST /v1/messages |
GPT 原生使用 Responses，Claude 原生使用 Messages。WorkBuddy 等 Chat 客户端只使用当前 Key 已开放、且支持 /v1/chat/completions 的型号；原生 Responses / Messages 专属型号不能当作 Chat 型号安装。具体以当前 Key 的目录与模型详情显示的协议为准。模型价格、输入输出及缓存价格以模型广场当前显示为准。
地址与协议
API 根地址与网页登录地址不同。按客户端使用的协议复制下方 Base URL，/v1 只加一次。
OpenAI SDK / Codex / DSH
Base URL 以 /v1 结尾，客户端追加 /responses。
Anthropic SDK / Claude Code / DSH
Base URL 使用根地址，客户端追加 /v1/messages。
| 要求完整接口 URL 时 | 填写 |
|---|---|
| Responses | |
| Messages | |
出现 404 或 /v1/v1/… 时，检查客户端是否自动补路径。Base URL 字段不要填完整 /responses 或 /messages 路径。
配置客户端
选你使用的软件，完成对应步骤即可。所有示例使用同一把本站 API Key。
使用 Claude Code 或 Codex 时，可以把本站连接直接导入 CC Switch，无需逐项填写地址和查询脚本。先安装你要使用的客户端，以及 CC Switch 4.0.10 或更新版本。
Lanjunex Logo当前 Key 的可用型号Key 可用额度查询
- 选择已有 Key。点击上方按钮，登录后选择本次要使用的 Key。不同分组使用各自对应的 Key。
- 选择客户端。Claude Code 会带入该 Key 获准的 Claude 型号；Codex 选择一个页面列出的 GPT 型号。
- 在本机确认。按浏览器提示打开 CC Switch，核对线路名与地址，再确认导入。
- 查看 Logo 与额度。卡片应显示 Lanjunex 标志和当前 Key 的可用额度。确认无误后，在对应客户端开始对话。
导入配置和查询额度不产生模型调用费用。重复导入会新增配置，已有线路请先检查。卡片显示的是 Key 可用额度；给账号增加余额不会自动提高 Key 自身限额。
未弹出 CC Switch 时，确认软件已安装，再点击导入并允许浏览器打开它。出现“额度没查到”时，先检查查询是否使用本站 /v1/usage 及对应 Key，不要选择其他站点的通用余额模板。
WorkBuddy · Windows 一键接入
先安装 WorkBuddy，准备好本站API Key。模型会自动添加，不用手填地址或型号。
- 退出 WorkBuddy。右键 Windows 右下角托盘图标，选择「退出」。
- 打开 Windows 命令窗口并运行命令。按 Windows 键搜索「命令提示符」或「PowerShell」，普通打开（无需管理员）。复制下方完整命令，粘贴后按回车。
Windows · CMD / PowerShell
powershell.exe -NoProfile -Command "irm https://lanjunex.com/connect-workbuddy.ps1 | iex" - 粘贴已有 Key。按提示粘贴本站 API Key，再按回车。输入时不显示字符或显示星号都正常。
- 重开 WorkBuddy 并试用。看到
SETUP COMPLETE后重开软件，在「自定义模型」中选择型号名（例如gpt-6-luna），发送“只回复 OK”确认连接。
运行配置命令不收费；开始对话或任务后按模型用量计费。查看用量。
遇到问题、更新型号或手动配置
提示 WorkBuddy 仍在运行：关闭窗口不等于退出软件。请右键右下角托盘里的 WorkBuddy 图标，选择「退出」，回到命令窗口按回车重新检查；输入 Q 可取消。本脚本不会强行结束进程。
查看安装结果：两个配置目录的临时文件权限和内容都会先检查，通过后才保存。SETUP COMPLETE 表示本次型号全部同步；SETUP PARTIAL 表示只有列出的型号同步，跳过的型号仍使用原来的 Key 或来源。停止时会说明原文件未改、已恢复或恢复未完成。
更换 Key：同型号已有本站旧 Key 时，输入 R 可将两个目录中符合条件的同名条目切换到新 Key，并备份原配置；直接回车或输入 K 保留旧条目。其他供应方、自定义标签和不重合的型号保持原样，不会默默覆盖。
反馈报错：结束后输入 C 可复制脱敏排错摘要，包含脚本版本、PowerShell 版本、失败阶段和恢复状态，不含 Key、完整用户路径或原始响应。请只发送 WORKBUDDY DIAGNOSTIC BEGIN 到 END 的摘要，不要发送配置文件或备份。
Windows 权限报错：若提示 Set-Acl 或 SeSecurityPrivilege，请完全退出 WorkBuddy，再运行上方同一条命令获取新版脚本，无需管理员权限。开头应显示 20261026-r8；看到 SETUP COMPLETE 后再重开软件。
对话提示余额不足时，请先到兑换页补充余额；不是安装失败，也不代表 Key 无效。
没有显示模型时，先确认命令已显示 SETUP COMPLETE，并完全退出后重开 WorkBuddy。Key 可用型号发生变化后，退出 WorkBuddy，再运行上面的同一条命令；本地清单不会自行实时更新。
思考强度：新版按精确型号声明推理能力，重新运行同一命令会更新旧配置。已确认兼容的 GPT、Claude 5/5.1及5.5、Opus 4.7/4.8、Haiku 4.5，以及 deepseek-v4.1-flash-1017、glm-5.3、kimi-k3、qwen3.8-flash 会开放强度控件；只安装当前 Key 目录实际返回的型号，不增加调用权限。运行结束会逐目录列出强度开启和保持关闭的型号，不会替你固定选择最高强度。
各型号支持的档位不同，客户端显示控件也不代表所有档位都通用。GLM-5.3 的常见档位由现有兼容转换承接；DeepSeek、Qwen 按其接口规则映射。Fable 5/5.1、Opus 4.7/4.8/5、Sonnet 5 已按自适应思考转换；Haiku 4.5 按预算控制强度，受你设置的输出上限限制，不会自动抬高上限。Kimi K3 的 medium 映射为 high，xhigh 映射为 max；它和 Fable 不支持关闭思考，不能选 none。非法档位会返回明确参数错误。MiMo 及 MiniMax M3 的思考开关不能直接当成强度分档，未知型号也保持关闭。这表示当前接入的强度控制限制，不表示这些模型没有思考能力。
脚本只更新 supportsReasoning 能力声明，不注入 thinking.type、固定强度或其他生成参数。模型默认行为仍取决于客户端请求与上游规则；原接口、Key、型号 ID、价格及其他能力偏好保持。
模型列表只显示型号，不加站点前缀。已安装旧版的用户，退出 WorkBuddy 后重跑同一命令即可更新名称；原模型 ID、Key 与接口保持。
命令免费读取 GET /v1/models?endpoint=chat_completions，只添加当前 Key 已开放的 Chat 兼容型号。原生 Messages / Responses 专属型号不会作为 Chat 型号安装。它会备份旧配置、保留其他供应方或其他 Key 的条目，并同步这把 Key 先前由命令添加的型号；配置及备份包含 Key，请勿外发。查看脚本全文。
没有可添加的型号时，请到密钥管理核对当前 Key 的范围；这不代表 Key 无效。目录查询失败时查看 HTTP 状态与提示，网络、权限或服务暂不可用也不能一概判断为 Key 无效。同名型号来自其他供应方或自定义标签时会保留并跳过；本站旧 Key 按上面的切换选项处理。网络下载失败时请先确认可打开本站，不要关闭证书校验。
手动添加：设置 → 模型 → 添加模型 → 自定义 / Custom。只填写这把 Key 当前开放且支持 Chat Completions 的型号，保存后在对话中选中。
| 字段 | 填写内容 |
|---|---|
| 完整接口 URL | |
| API Key | 当前使用的本站 Key |
| 模型 ID | 这把 Key 当前开放的 Chat Completions 型号 ID |
| 能力 | 按具体型号能力选择；不要仅凭目录推断图片输入或推理开关 |
手工配置参考 WorkBuddy 官方模型配置及腾讯官方配置字段（2026-10-24）。
DeepSeek Harness · 终端输入 Key 自动接入
运行命令后只需输入现有 Key，脚本会自动识别、配置并启动 DSH Web。
适用于已经安装 DSH 的客户。脚本优先使用现有 Node.js 22 或更新版本，缺少时尝试已安装官方桌面版自带的 Node；不会另外安装运行环境。Windows 和 macOS 都只需在终端隐藏输入一次现有本站 Key；脚本自动识别本机已有安装、完成连接配置并启动 DSH，不再要求手动打开网页、填写端口或粘贴启动地址。不另建账号或充值，不自动下载、安装或升级 DSH。
- 按系统运行一条命令。Windows 打开命令提示符（CMD）或 PowerShell，macOS 打开终端。
- 只输入现有本站 Key。粘贴到隐藏输入提示后按回车；输入时不显示字符是正常现象。自动识别或启动失败时会停止并给出提示，不会改用未确认的安装或覆盖原配置。
Windows · CMD / PowerShell
powershell.exe -NoProfile -Command "irm https://lanjunex.com/connect-dsh.ps1 | iex"macOS · 终端
curl -fsS https://lanjunex.com/connect-dsh.sh | bash脚本只添加当前 Key 已开放、且已确认支持的 GPT / Claude 型号。GPT 和 Claude 分别使用 Responses / Messages 两个一键连接（lanjunex-dsh-gpt / lanjunex-dsh-claude），共用同一把 Key 和余额。完成后在已启动的 DSH 中选择这些连接下的模型使用；已有手动连接仍保留，未识别或不支持的配置不会强行覆盖。
思考强度与原配置
支持思考强度的型号会配置已确认的可选档位，在 DSH 模型选择器中选择即可；不同型号的档位可能不同，不会把全部型号统一设为高强度。新连接初始保留 200K 上下文预算；输出能力按已核型号的原生上限配置，不再额外限制为 8192。上下文预算是客户端设置，不代表模型最大能力。已有自定义覆盖若与更新不同，会原样保留并提示；默认模型、其他服务商和已有会话不自动切换。
操作前会备份本站相关配置，失败时按实际写入情况恢复；无法确认恢复完成时会明确提示，不会显示全部成功。请保留配置备份，不要外发 Key 或未脱敏配置文件。
自动启动会在仅本人可读的本机私有目录保存本脚本的运行状态及本地会话认证缓存，便于复用由本脚本启动的 DSH；API Key 仍交给 DSH 原生凭据服务保存。请勿外发运行状态文件或启动日志。检测到非本脚本管理的 DSH 已在运行时，会保留原进程并停止；首次可正常退出 DSH 后重跑，无需填写端口或地址。
配置过程只免费获取模型目录，不会发送测试对话。配置完成不等于真实推理或工具任务已验收；你随后发送消息、运行 Agent 或独立工具时仍按实际服务规则计费。Search / Fetch 等独立工具服务不包含在上述模型 API 地址中。
手动配置与自动接入排错
- 打开「设置 → 模型」，选择「添加模型服务商 → 自定义模型 API」。
- 按下表添加配置，将同一把本站 Key 填入 API Key 字段。
- 点击「获取可用模型」，仅选该协议对应的已开放型号并保存。
- 回到对话，在模型选择器中切换到刚配置的模型，再发送消息。
| 字段 | 使用 Claude | 使用 GPT |
|---|---|---|
| 名称 | lanjunex-claude | lanjunex-gpt |
| API 协议 | Anthropic Messages | OpenAI Responses |
| API Base URL | | |
| API Key | 本站密钥管理中复制的同一把 Key | |
| 模型示例 | claude-sonnet-5 | gpt-6.1-sol |
一个连接只使用一种协议。GPT 配置选择 OpenAI Responses；WorkBuddy 的 Chat 兼容配置见专用步骤。如果版本没有 Responses 或脚本提示设置接口不兼容，先保留原配置，使用手动方式并按 DSH 官方说明升级，命令不会擅自升级。
获取模型失败时查看 HTTP 状态和错误码；“密钥无效”和“账户余额不足”是不同问题，见错误码。自动识别或启动失败时，请确认已有 DSH 安装完整、Node.js 版本可用；不要关闭证书校验，也不要把公网地址或额外凭据塞进接入命令。脚本不会强杀、重启客户原有 DSH 进程。
Claude Code
先安装 Claude Code，运行 claude --version 确认命令可用。在 macOS / Linux 终端先运行准备密钥，再运行：
Claude Code · macOS / Linux
进入后用 /status 检查模型与连接。此配置适用于 Claude Code CLI；辅助模型或工具出错时，请将具体模型名和错误发给客服核对。
Codex CLI
先按 Codex 官方说明安装，运行 codex --version。在 macOS / Linux 终端先准备密钥，再用以下命令启动：
Codex · Responses · macOS / Linux
启动后用 /status 确认模型与服务商。参数只用于本次启动。官方配置参考 ↗
Python SDK
按所选协议安装 python -m pip install openai 或 python -m pip install anthropic，先设置环境变量，再保存并运行对应代码。
GPT · OpenAI Responses SDK
Python · GPT Responses
Claude · Anthropic Messages SDK
Python · Claude Messages
第一次 API 请求
以下示例只请求“只回复 OK”，执行会按实际用量计费。可选输出预算不额外设小值；Claude 必填输出参数使用已核型号的原生能力。也可以直接在已配置好的客户端发送这句话。
macOS / Linux：准备密钥
打开终端，复制整段运行，再按提示粘贴 Key。输入时不会显示密钥，按回车继续。
当前终端的环境变量
随后选择与你的模型对应的一条请求运行。instructions 是示例任务指令，可以自行编辑；客户端本身提供指令时沿用客户端配置。
GPT · Responses · curl
curl · GPT Responses
Claude · Messages · curl
curl · Claude Messages
Windows：PowerShell
选一段完整复制到 PowerShell，按提示输入 Key。非流式示例会等待完整响应后显示结果。
GPT · Responses · PowerShell
PowerShell · GPT Responses
Claude · Messages · PowerShell
PowerShell · Claude Messages
响应与用量
查看完整回复，再到用量记录按时间、Key 和模型找到本次请求。HTTP 200 表示请求开始返回，流式响应仍可能在后续报错。
- GPT：非流式检查
status: completed；流式检查最终response.completed。response.failed、response.incomplete或错误事件需要继续排查。 - Claude：流式等到
message_stop，并检查stop_reason。end_turn表示本轮结束，tool_use表示需要客户端继续执行工具，max_tokens表示达到输出上限。 - 费用：查看输入、输出、缓存与消费明细。微额消费可能不会改变两位小数的余额显示，详见余额收支。
超时或断流后先查用量，再决定是否重试，避免同一任务重复请求。已交付部分内容或工具结果时，需要核对实际费用；模型拒答也应单独核对。
错误码与排查
同时查看 HTTP 状态和响应里的 code、type、message。客户端有时统一显示“连接失败”或“Key 无效”，具体原因以接口错误为准。
| 状态 / 错误 | 含义与处理 |
|---|---|
401 · API_KEY_REQUIRED / INVALID_API_KEY / API_KEY_DISABLED | Key 缺失、不正确或已停用。重新复制本站 Key，并检查客户端鉴权设置；不要使用网页登录密码。 |
| 400 · 请求参数错误 | 检查模型 ID、必填参数、JSON 和协议。GPT / Claude 原生示例分别使用 Responses / Messages；WorkBuddy 请核对当前 Key 已开放的 Chat 兼容型号。若错误明确指出 instructions 缺失，补充自己的任务指令。 |
403 · INSUFFICIENT_BALANCE | 账户余额不足。到控制台查看余额并兑换充值；不是 Key 无效。模型列表读取本身不消耗余额。 |
403 · API_KEY_EXPIRED / ACCESS_DENIED | Key 已过期或受到访问限制。检查密钥有效期、IP 限制与账号权限；无法自行解决时联系客服。 |
| 429 · 额度或请求限制 | API_KEY_QUOTA_EXHAUSTED、insufficient_quota 表示 Key 额度耗尽；USAGE_LIMIT_EXCEEDED 或其他限流错误需核对周期限额与并发。降低并发并稍后重试；有 Retry-After 时按其等待。 |
| 404 · 路径或模型错误 | 检查重复 /v1、完整接口路径及精确模型 ID；从模型广场复制型号。 |
| 502 / 503 · 服务异常 | 模型服务暂不可用、忙碌或响应超时。稍后重试，或主动选择其他模型。若流式已开始，请先核对用量和已收到的结果。 |
upstream_content_refused | 模型拒答了本次请求。本站不会自动换线重放；查看下方模型拒答说明。 |
403 · prompt_guard_blocked | 本站前置检查拦截了请求，本次未发送给模型。正常业务被误判时，保留请求标识联系客服核查。 |
503 · prompt_guard_unavailable / prompt_guard_invalid_response | 前置检查暂时不可用或没有有效结果，本次未发送给模型。稍后重试；这类故障不表示客户违规。 |
其他 403 请阅读具体错误信息：账号状态、权限或请求参数都可能触发，不能只按状态判断余额不足。连接/TLS 错误时先检查地址与网络；不要关闭证书验证。
流式请求已经返回 HTTP 200 后，错误可能通过 SSE error、response.failed 等事件出现；继续读取到结束事件，不要只检查最初的 HTTP 状态。
模型拒答
模型拒答和网络故障是不同情况。模型可能因自身内容策略拒绝某个请求；这不表示本站已认定你的账号违规。
如何识别
- Claude Messages：响应或流式
message_delta中的stop_reason为refusal。 - GPT Responses：输出内容包含
type: refusal，或流式出现response.refusal.delta/response.refusal.done。 - 本站统一错误：在尚未向客户端交付结果时，检测到结构化拒绝会返回
403和upstream_content_refused。流式开始后也可能以错误事件结束。
请按结构化字段识别，不要只匹配某一句拒绝文字。已经发送的流式片段无法撤回；收到部分文字也应检查最后的结束原因。
遇到拒绝怎么办
先核对任务是否清楚、输入是否包含与工作无关的敏感内容。正常业务疑似被误判时，保存时间、模型和请求标识，提供脱敏场景给客服。不要连续重试或反复换线绕过拒绝；本站不会为该请求自动重放，也不会仅因此锁住后续正常请求。
本地鉴权或前置检查拦截发生在模型推理前，不产生模型推理用量。已交付部分输出或工具结果后中断时，请在用量记录及余额收支核对实际费用。
余额与计费
模型价目、账户余额、消费和 Key 额度统一以 $ 显示。实际付款币种、金额与到账额度以购买页面为准。
充值与兑换
按控制台入口购买卡密后，在兑换页粘贴兑换码并提交。购买成功后仍需兑换，余额才会入账。网络中断时先刷新兑换历史和余额，避免重复操作；无效、已使用或金额异常请联系客服。
余额与 Key 额度
账户余额决定可消费的总金额；Key 额度限制某一把 Key 的消费。新建 Key 不会充值，调高 Key 上限也不会增加余额。额度耗尽时需要调整上限或充值对应账户，具体看错误码。
核对一次消费
在用量记录查看本次模型、输入、输出、缓存 token 与费用，再到余额收支核对兑换、消费、调整及退款记录。按 token 计费的输入、输出、缓存分别采用对应单价；不要仅凭屏幕上的文字估算费用。
退款或账单问题请提供订单编号、时间与请求标识。不要将完整兑换码或 Key 发到公开渠道；具体处理以订单和实际记录核实。
账号安全
在个人资料修改密码和管理页面已开放的登录保护。怀疑网页登录凭据泄露时，使用「退出所有设备」；API Key 需要在密钥页单独停用。
忘记密码时使用登录页的找回密码入口，按页面提示收取邮件；未收到先检查垃圾邮件。邮箱与登录保护功能以个人资料页面为准。
请求中只发送完成任务所需的信息。用量与余额记录用于核账；不要把隐藏 IP 或不显示请求正文理解为所有数据零保留。
联系客服
Telegram：@lanjunex ↗ QQ：2473073339
报障时请提供发生时间和时区、客户端及版本、模型 ID、接口路径、HTTP 状态、脱敏错误信息和请求标识；账单问题附用量或订单截图。
请勿发送完整 API Key、密码、Cookie 或未脱敏的业务数据。