给每个智能体一个清晰起点。Croli 用户手册:每一屏是什么,以及怎么用。
查看产品预览 ↗
用户手册

模型供应商

「设置 → 模型供应商」管理智能体用的 API 供应商凭据。

副标题:「管理 Agent 的 API 供应商凭据。」

Croli 不预置任何供应商。 这一屏里没有「OpenAI」「Anthropic」之类的现成选项,全部条目都是你自己建的——名称、地址、密钥都由你填。

列表

顶部是一个智能体筛选下拉(全部 / 逐个智能体),加一个添加供应商按钮。

每一行显示名称、等宽字体的 API 地址、以及所属智能体的徽章,右侧是编辑(铅笔)和删除(红色垃圾桶)。

一条都没有时显示「尚未配置模型供应商。」

删除有确认对话框。如果这个供应商还绑在某个智能体上,删除会被拒绝:

{agents} 正在使用该配置,请先解除关联后再删除。

只有三个智能体能用

这是本屏最重要的约束:可绑定的智能体只有 Claude Code、Codex、Gemini CLI 三个。

其它智能体不在这里配。Grok 和 DeepSeek Harness 虽然也是用 API 密钥的,但它们从自己的设置面板里读端点和密钥——放在这里会得到一个什么都不生效的绑定,所以干脆不提供。其余 CLI 各有自己的认证方式,见智能体。

添加 / 编辑表单

添加和编辑用同一张表单,三块,按顺序:

1. 智能体

从上面那三个里选一个。创建之后不能改(表单上明确写了「智能体类型创建后不可修改。」)。要换智能体就删了重建。

2. 接入点

字段 说明
名称 自己认人用,例如「公司网关」
API 地址 例如 https://api.openai.com/v1
API 密钥 密码框。编辑时留空表示保持原值不变

三个都必填(编辑时密钥可留空)。

3. 模型

这一块的内容取决于选了哪个智能体:

  • Codex — 一个可编辑的模型清单(可以配多个候选模型)。

  • Gemini CLI — 单个文本框,一个默认模型,例如 gemini-3-pro-preview。表单会提示「该智能体只支持配置一个默认模型。」

  • Claude Code — 一张两列的角色表,每个角色各填一个模型 ID:

    角色 示例
    主模型 claude-sonnet-5
    推理模型(思考) claude-opus-5
    Haiku 默认 claude-haiku-5-5
    Sonnet 默认 claude-sonnet-5
    Opus 默认 claude-opus-5
    Fable 默认 claude-fable-5

    另外还可以加一条自定义模型 ID(例如 my-gateway/claude-opus-5,带自己的显示名和说明),用来接自建网关。

值得了解

  • 编辑已有供应商时,如果当前有会话正在用它,会提示:正在跑的会话需要重连才会用上新配置。新建时不会有这个提示。
  • 供应商和它的密钥属于配置同步的同步范围——包含 API 密钥。导出的 JSON 里密钥是明文,别随手发给别人。
  • 绑定关系的另一端在智能体页面:每个智能体的「认证方式」里有「模型供应商」这一档,选中后才会去读这里配的东西。某个智能体一个供应商都没配时,那里会提示去这一屏添加。