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

本文介绍如何在 TraeCode CLI 中切换模型并添加自定义模型。

## 重要提示 {#faeb4622}

若要允许企业成员添加并使用自定义模型，需要在 TRAE 企业版控制台中打开 **是否允许成员在 TRAE 客户端和插件添加自定义模型** 开关。

![Image=700x110](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/d184c8f554ea44779a99e90fb93fc2da~tplv-goo7wpa0wc-topic.webp)

## 切换模型 {#3c407f3d}

你可以使用 `/model` 命令来切换模型，包括内置模型和企业管理员添加的自定义模型。

1. 在输入框中，输入 `/model` 命令，然后连续按两次回车键。
   TraeCode CLI 展示可用模型列表。
   ![Image=1604x590](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/6d17a7f28e2f4905832fa5797cc968a4~tplv-goo7wpa0wc-topic.webp)
2. 选择所需模型。

## 添加一个自定义模型 {#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,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"
```