网站密码、平台 Key、本地 Key:别填错
用一张表分清每种凭据给谁用,以及禁用、删除和切换账号分别影响什么。
先看这张表
| 名称 | 从哪里获得 | 填到哪里 |
|---|---|---|
| 网站密码或第三方登录 | 注册/绑定网站账号时 | 网站登录页 |
| User API Key(平台用户密钥) | 网站“API 密钥” | User Client 登录页 |
| 本地 API Key | User Client“本地 Key” | Codex、Claude Code、其他工具和 HTTP 请求 |
| Partner API Key | 网站“合作伙伴控制台 → 合作伙伴 API Key” | Partner Client 登录页 |
| 上游账号登录凭证 | 官方 CLI 登录或账号授权流程 | Partner Client 的账号接入流程 |
不要因为名字里都有“Key”就互换使用。尤其不要把上游账号凭证给消费端工具,也不要把 Partner Key 当成 User Key。
为什么还要创建本地 Key
本地 Key 让你把不同工具分开管理。例如给 Codex 一把、给另一个编辑器一把。可以给它们不同的名称和路由范围,需要停用某个工具时处理对应本地 Key 即可。
平台 Key 决定网站侧的权限、价格和额度。本地 Key 的限制只能在平台 Key 允许的范围内进一步收紧,不能用本地设置开通平台禁止的模型。
丢失或泄漏时怎么处理
- 先确认泄漏的是哪一种凭据。
- 本地 Key 泄漏:删除对应本地 Key,为工具创建新的本地 Key。
- User 平台 Key 泄漏:在网站禁用或删除它,再用新的平台 Key 重新接入 Client。
- Partner Key 泄漏:按合作伙伴密钥页面的更换规则操作,并重新登录受影响的 Partner Client。
- 上游凭证泄漏:通过官方账号体系重新授权,随后检查供号账号的授权状态。
不要把完整密钥贴到工单、群聊、截图或公开仓库。排障通常只需要请求 ID、错误类型和时间。
删除本地数据不等于删网站账号
User Client 的“移除此设备上的账号数据”会清除该账号在这台设备上的平台 Key、本地 Key、信任策略和本地记录,并退出登录。它不会自动删除网站账号或禁用网站侧的平台 Key。再次使用时,需要重新登录和创建本地 Key。
Partner Client 的清理操作也要先阅读确认内容,尤其检查远端账号是否仍参与调度。相关步骤见账号健康和更新与本地存储。


