> ## Documentation Index
> Fetch the complete documentation index at: https://docs.trae.cn/llms.txt
> Use this file to discover all available pages before exploring further.

本文介绍如何在 TRAE CLI 中切换模型并添加自定义模型。
## 重要提示 {#faeb4622}
若要允许企业成员添加并使用自定义模型，需要在 TRAE 企业版控制台中打开 **是否允许成员在 TRAE 客户端和插件添加自定义模型** 开关。
![Image=700x110](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/d184c8f554ea44779a99e90fb93fc2da~tplv-goo7wpa0wc-image.image)
## 切换模型 {#3c407f3d}
你可以使用 `/model` 命令来切换模型，包括内置模型和企业管理员添加的自定义模型。
## 添加一个自定义模型 {#82395692}
你可以使用 `traecli config edit` 命令来编辑全局配置文件 trae_cli.yaml，在其中添加自定义模型配置。
需要为自定义模型配置的字段如下：

* **OpenAI 模型**
   <!-- @cols-width: 100,100,101,518 -->
   | | | | | \
   |**字段** |**类型** |**是否必填** |**描述** |
   |---|---|---|---|
   | | | | | \
   |base_url |String |是 |OpenAI API 的基础请求地址。用于以下情况： |\
   | | | | |\
   | | | |* 使用 Azure OpenAI（需要填写 Azure 的 endpoint）； |\
   | | | |* 使用代理、中转、私有部署； |\
   | | | |* 访问兼容 OpenAI 协议的模型服务器。 |
   | | | | | \
   |api_key |String |是 |调用 OpenAI（或 Azure OpenAI）API 所需的密钥。例如 `OPENAI_API_KEY` 或 Azure 的 `API Key`。 |
   | | | | | \
   |model |String |是 |要使用的 OpenAI 模型名称。 |
   | | | | | \
   |by_azure |Boolean |否 |是否使用 Azure OpenAI 服务调用模型。如果为 `true`，系统将按 Azure 的 API 规范构造请求。 |

   示例：
   ```YAML
   models:
     -  name: "模型的展示名"
        open_ai:
          base_url: https://example.com
          api_key: "你申请的 API_KEY"
          model: "gpt-4.1"
          by_azure: true
   ```

* **Claude 模型**
   <!-- @cols-width: 100,100,,537 -->
   | | | | | \
   |**字段** |**类型** |**是否必填** |**描述** |
   |---|---|---|---|
   | | | | | \
   |base_url |String |是 |Claude API 的基础请求地址。默认为官方服务地址，若使用代理或中转服务，请填写对应的地址。 |
   | | | | | \
   |model |String |是 |要使用的 Claude 模型名称。 |
   | | | | | \
   |api_key |String |是 |调用 Claude API 所需的密钥，通常为你的 `ANTHROPIC_API_KEY`。 |

   示例：
   ```YAML
   models:
     -  name: "模型的展示名"
        claude:
          base_url: https://example.com
          model: "claude-3-7-sonnet-20250219"
          api_key: "你的 ANTHROPIC_API_KEY"
   ```


## 同时添加多个自定义模型 {#51c33df8}
你可以一次性在 trae_cli.yaml 文件中添加多个自定义模型。
示例如下：
```YAML
models:
  -  name: "模型的展示名"
     open_ai:
       base_url: https://example.com
       api_key: "你申请的 API_KEY"
       model: "gpt-4.1"
       by_azure: true
  -  name: "模型的展示名"
     claude:
       base_url: https://example.com
       model: "claude-3-7-sonnet-20250219"
       api_key: "你的 ANTHROPIC_API_KEY"
```