本地 Key:创建、编辑、查看配置和停用工具
为不同工具分配独立密钥,理解平台范围、本地范围、配置导入和删除影响。
建议一个工具一把 Key
本地 Key 是工具连接 User Client 的身份。给 Codex、Claude Code 和另一个编辑器分别创建 Key,名称说明用途,排障时就能快速找到对应记录。
本地 Key 绑定创建它的网站账号和平台 Key。切换 Client 管理账号不会把已有 Key 变成新账号的 Key;某把 Key 的请求始终按自己的归属路由和结算。
创建与编辑
- 登录 User Client,进入“本地 Key”。
- 点击“创建本地 Key”,填写用途名称。
- 按需要选择提供商、公开或私有范围、允许的模型和图片规格。
- 保存后查看状态与可用模型数,再复制本地 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 时检查网站路由是否保存。


