# 添加第一个模型

> Cube Agent 2.2.0 正式版（构建 2002007）使用说明。
> 分类：快速上手。内容基准：2026-11-07。
> 网页：https://cubeagent.app/docs/add_model/

## 你需要准备

- 一个模型服务商账号。
- 服务商提供的 `API Key`。
- 服务商接口地址,通常叫 `Base URL`。

## 配置步骤

1. 打开 **设置 → 模型与用量 → 服务商管理**。
2. 选择已有服务商,或新增一个服务商。
3. 填入 `Base URL` 与 `API Key`,然后保存。
4. 在该服务商下添加你要使用的模型。

如果不熟悉接口风格、模型 ID、能力开关或套餐选择,可以在 **服务商管理** 页点击常驻的 **让 AI 帮我配置**。先从当前已启用的聊天模型中选择一个管理模型,再直接描述“检查当前配置”“帮我选择服务商、套餐和模型”“获取这个服务商的模型”,或粘贴模型列表让 AI 整理写入。配置变更仍由你掌控，执行前会再次确认。把 API Key 交给 AI 时,首选输入区的 **密钥** 按钮:剪贴板中的密钥只保存在本机,对话里仅出现 CUBEKEY 引用,原文不会发送给管理模型的服务商;服务商详情页手动填写同样安全。如果已经把密钥明文粘贴进对话,也可以让 AI 直接配置,但密钥已随对话发送,建议尽快在服务商后台重置。

## 给单个模型选择协议

在服务商的模型编辑页设置协议与接口路径，默认跟随服务商。同一服务商的不同模型可分别使用 OpenAI Chat Completions、Responses、Anthropic 或 Gemini 协议；选择服务商实际支持的组合。协议配置不会使模型自动获得视觉或工具能力，修改后请测试。Command Code 已提供服务商预置及余额模板，仍需填写自己的有效凭据。

## 配置完成后

回到聊天页,在模型选择里切换到刚添加的模型即可开始对话。

## Header 模板

如果某些中转站要求特定 `User-Agent`、来源标识或其它请求头,可以在服务商详情页打开 **Header 模板**。当前服务商的 Header 可保存成模板,之后在其它服务商中一键应用、合并或替换。

## 重新获取模型

服务商模型列表变化后,可以重新获取模型。获取结果会显示本次新增、已存在和本次未获取到的旧模型。默认会保留旧模型,避免误删手动添加或临时不可见的模型;如果确认服务商已经下架,可开启“删除本次未获取到的旧模型”,保存前会再次确认。