文档中心阅读博客
文档中心通用与入门

网站密码、平台 Key、本地 Key:别填错

用一张表分清每种凭据给谁用,以及禁用、删除和切换账号分别影响什么。

先看这张表

名称从哪里获得填到哪里
网站密码或第三方登录注册/绑定网站账号时网站登录页
User API Key(平台用户密钥)网站“API 密钥”User Client 登录页
本地 API KeyUser 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 允许的范围内进一步收紧,不能用本地设置开通平台禁止的模型。

User Client 中的本地 Key 列表

丢失或泄漏时怎么处理

  1. 先确认泄漏的是哪一种凭据。
  2. 本地 Key 泄漏:删除对应本地 Key,为工具创建新的本地 Key。
  3. User 平台 Key 泄漏:在网站禁用或删除它,再用新的平台 Key 重新接入 Client。
  4. Partner Key 泄漏:按合作伙伴密钥页面的更换规则操作,并重新登录受影响的 Partner Client。
  5. 上游凭证泄漏:通过官方账号体系重新授权,随后检查供号账号的授权状态。

不要把完整密钥贴到工单、群聊、截图或公开仓库。排障通常只需要请求 ID、错误类型和时间。

删除本地数据不等于删网站账号

User Client 的“移除此设备上的账号数据”会清除该账号在这台设备上的平台 Key、本地 Key、信任策略和本地记录,并退出登录。它不会自动删除网站账号或禁用网站侧的平台 Key。再次使用时,需要重新登录和创建本地 Key。

Partner Client 的清理操作也要先阅读确认内容,尤其检查远端账号是否仍参与调度。相关步骤见账号健康和更新与本地存储。