文档中心阅读博客
文档中心使用者指南

本地 Key:创建、编辑、查看配置和停用工具

为不同工具分配独立密钥,理解平台范围、本地范围、配置导入和删除影响。

建议一个工具一把 Key

本地 Key 是工具连接 User Client 的身份。给 Codex、Claude Code 和另一个编辑器分别创建 Key,名称说明用途,排障时就能快速找到对应记录。

本地 Key 绑定创建它的网站账号和平台 Key。切换 Client 管理账号不会把已有 Key 变成新账号的 Key;某把 Key 的请求始终按自己的归属路由和结算。

创建与编辑

  1. 登录 User Client,进入“本地 Key”。
  2. 点击“创建本地 Key”,填写用途名称。
  3. 按需要选择提供商、公开或私有范围、允许的模型和图片规格。
  4. 保存后查看状态与可用模型数,再复制本地 Key。
  5. 已有 Key 可点击“编辑”调整配置;编辑不会自动更换密钥值。

本地 Key 创建界面

本地设置是在平台 Key 权限内进一步收紧。平台没有配置某渠道时,本地界面不能把它开通。策略同步失败时,先确认网站 Key 未被禁用以及平台连接正常。

三个接入动作有什么区别

动作做什么何时用
查看配置展示入口、模型和连接配置手动填到支持自定义地址的工具
导入本机 Agent桌面版预览并写入支持的 Agent 配置,生成备份本机已安装 Codex、Claude Code、Pi 或 WorkBuddy
CC Switch通过本机已安装的 CC Switch 接入配置你习惯用 CC Switch 切换提供商

导入到 Agent 前要检查目标文件、模型与地址。预览不等于已经应用;确认写入后才生效。当前编辑器不支持的 Agent 按其他 Agent 接入手动配置,不要假设所有软件都有一键导入。

浏览器中运行的 Web 管理页面与桌面程序的本机文件权限不同。桌面专属入口在纯浏览器下可能不可用。

删除会怎样

删除本地 Key 会让继续使用它的工具无法鉴权。它不等于删除网站平台 Key,也不等于退掉上游账号登录。更换工具 Key 后,要同步修改该工具里保存的值。

如果只想收紧范围,优先编辑,而不是反复创建和删除。在共享电脑上先确认当前登录的管理账号,避免误操作另一个账号的 Key。

结果怎么确认

运行短请求,到使用记录核对 Key、客户端来源和模型。出现 401 时先检查 Key 是否仍有效;出现 403 时检查两层允许范围;出现 409 时检查网站路由是否保存。