Adapter 一键配置

Adapter 面向 CodeBuddy / WorkBuddy 等本地客户端。它把客户端协议、模型目录和平台个人密钥连接起来。Codex CLI 与 Claude Code 可按前两节直连，无需强制安装本地 Adapter。

安装步骤

1. 先在平台创建有效密钥，再打开 API 密钥 → Adapter 一键配置。
2. 选择客户端与密钥，下载当前完整安装包及一次性 setup 配置文件。不要把 setup 文件共享给其他用户。
3. 按页面提示在目标客户端安装技能，使用 setup 文件绝对路径运行安装器。Windows 路径有空格时必须加引号。
4. 安装器交换一次性授权，生成本机凭证，写入客户端模型配置与登录启动项。成功后按提示重启客户端。
5. 选择 pt/ 前缀的模型，发送一条简单消息，再验证工具调用。

授权和本地运行

setup 授权有效期为 60 分钟，并且只能兑换一次。已用或过期时重新从平台生成；短时安装重试需要沿用同一安装凭证，不能复制到另一台机器。客户端凭证继承源密钥权限，源密钥停用、到期或账户暂停会影响本地调用。

本地代理必须持续运行。安装文件复制成功不代表代理已监听，也不代表授权兑换成功。受限沙箱可能在命令结束时回收后台进程，应在用户真实桌面会话按安装说明启动，并核对登录自启动。

升级与排障

1. 升级使用平台最新完整包，避免混用旧安装器和新运行时。
2. 授权失败：重新生成 setup 文件；检查系统时间和网络。
3. 模型存在但 502：检查代理健康、本地日志及平台请求记录，再核对模型协议。
4. 源密钥更换：重新生成对应配置，不能仅改模型名称。
5. 分享日志前移除密钥、setup 授权和个人信息。