产品指南
模型与供应商
区分本机订阅与 API 供应商，理解模型发现、可用性和会话执行路径。
组织管理员可以配置两类模型来源。它们在模型选择器里并列出现，但身份、凭据和执行链路不同，不能互相伪装。
本机订阅
本机订阅使用这台电脑上已经登录的官方 CLI：
- Anthropic 订阅通过 Claude Code CLI 的本机登录状态执行。
- OpenAI 订阅通过 Codex CLI 的本机登录状态执行。
系统从本机运行时发现可用模型，并使用独立的 claude-code/ 或 codex/ 内部路由。界面只显示模型名称；执行前缀不会作为模型名展示。
本机订阅不是 API Key
本机订阅只能连接运行 Grado 的这台机器，跟随本机 CLI 的登录状态、模型可用性和订阅额度。它不会被转换成兼容 API，也不会静默回退到某个 API 供应商。
API 供应商
API 供应商通过企业配置的 Base URL、端点格式和密钥引用调用远端模型服务。密钥只引用“系统安全 → 系统密钥”中的保管项，不应把明文写入供应商表单、日志或前端存储。
为什么模型没有出现
按顺序检查：
- 供应商是否启用，当前成员是否有权使用。
- 本机订阅对应 CLI 是否已登录；API 供应商的密钥引用是否有效。
- 模型发现是否成功，目标模型是否被管理员设为可见。
- 模型是否支持当前会话需要的文本、图片、工具或上下文能力。
- 刷新目录后重新打开模型选择器，避免继续使用旧缓存。
调用失败时
本机订阅失败会明确提示检查 CLI 登录状态、模型可用性或订阅额度；API 失败会保留供应商返回的可安全展示信息。两条链路不会因为失败而互相降级，避免用户以为使用订阅，实际却产生 API 调用和费用。