LanoX 官方平台地址
进入 LanoX 控制台，完成账户注册、余额充值与 API Key 准备。
LanoX 控制台lanox.ai生成 API Key
后续配置使用 LanoX API Key，无需填写模型厂商官网的密钥。
- 01
注册并登录账户
填写邮箱和密码，完成邮箱验证。已有账户可直接登录。
- 02
准备账户余额
在控制台充值，或使用兑换码完成入账。
- 03
创建并复制 API Key
进入“API Key”页面，新建密钥，创建后复制并妥善保存。
API Key 是你的访问凭证，请勿公开分享、提交到代码仓库或放进截图。
安装 WorkBuddy
从官方网站下载客户端，安装后登录。直接在客户端配置，无需安装 CC Switch。
- 下载并打开桌面端安装包，按提示完成安装。
- 打开 WorkBuddy，完成客户端账户登录。
- 进入设置，在“模型”中添加自定义模型以对接 LanoX。
WorkBuddy 客户端登录与 LanoX API 鉴权是两个独立步骤。第三方模型调用费用由 LanoX 账户承担。
WorkBuddy 接入配置
使用自定义 API，将 LanoX 的接口地址、API Key 和模型名称填入 WorkBuddy。
接入参数
https://api.lanox.ai/v1/chat/completionsYOUR_MODEL_ID仅用于更新下方命令示例，不会发送请求。模型 ID 以 LanoX 实际列表为准，不是显示名称。
接口地址使用完整的 /v1/chat/completions 路径。“自定义协议”保持关闭，避免重复拼接路径；能力选项按模型实际支持设置。
分步配置
Custom API选择自定义
点击“添加模型”，将提供商设为“自定义 / Custom”。此入口使用 OpenAI 兼容 API。
填写接入信息
将上方接口地址、LanoX API Key 和准确的模型 ID 填入对应字段。使用支持工具调用的模型，并按能力开启工具调用；图片与推理选项以模型实际支持为准。
保存并选择模型
保存模型配置，返回对话界面，在“自定义模型”分组中选择刚添加的模型，并新建任务进行验证。
完成前确认
- 确认接口地址、API Key、模型名称均已填写。
- 返回任务输入框，选择刚保存的自定义模型。
- 先做简单问答，再在测试文件夹中验证工具调用。
模型灰显通常表示接口地址或 API Key 未填写完整。补全并保存后重新选择模型。
验证接入
先验证简单问答，再验证工具调用，最后核对调用记录。
- 新建会话，发送一条简短消息，确认收到真实回复。
- 在可信测试文件夹中验证工具调用，检查客户端授权。
- 在 LanoX 控制台核对模型、用量和调用记录。
可选：直接测试 API
先在本地环境变量中设置 LANOX_API_KEY。以下命令仅供复制，页面不会发送请求；手动运行可能产生模型调用费用。
curl --fail-with-body 'https://api.lanox.ai/v1/chat/completions' \
-H "Authorization: Bearer $LANOX_API_KEY" \
-H 'Content-Type: application/json' \
-d '{
"model": "YOUR_MODEL_ID",
"messages": [
{
"role": "user",
"content": "Reply with OK."
}
],
"stream": false
}'常见问题与支持
先检查以下常见问题；仍未解决时，可提交工单获得技术支持。
保存成功，但模型没有回复？
核对 API Key、余额、模型 ID 与接口协议。401/403 通常与鉴权或权限有关，404 需检查接口路径与模型名称，429 需检查限流或额度；以接口返回的具体错误为准。
自定义模型是灰色，无法选择？
先确认接口地址与 API Key 已完整填写，保存后重新选择。WorkBuddy 会将配置不完整的自定义模型置灰；必要时更新到提供可视化模型配置的版本。
接口地址要不要带 /chat/completions？
本指南填写完整接口地址 https://api.lanox.ai/v1/chat/completions，使用默认标准协议处理。“自定义协议”仅用于需要原样请求非标准路径的场景，不应为排错随意开启。
能对话，但无法操作文件？
确认模型支持工具调用、协议与网关兼容，并检查客户端的工作区授权和工具设置。能回答文本不代表具备完整 Agent 能力。
需要重启或安装 CC Switch 吗？
无需 CC Switch。直接在 WorkBuddy 的可视化模型配置中保存，回到新任务选择该自定义模型。
用户交流群
微信扫码入群，交流接入与使用问题。
查看最新二维码工单支持
账户、模型调用或接入遇到问题？提交工单，支持团队将持续跟进。
提交工单登录后可在工单中心查看回复。附上操作系统、客户端版本、协议及错误截图，并隐藏 API Key。
接入步骤核对：2026-11-04。截图保留官方原图；可用模型与接口权限以 LanoX 控制台为准。