模型

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

重要提示

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

切换模型

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

添加一个自定义模型

你可以使用 traecli config edit 命令来编辑全局配置文件 trae_cli.yaml，在其中添加自定义模型配置。
需要为自定义模型配置的字段如下：

• OpenAI 模型

  字段	类型	是否必填	描述
  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 规范构造请求。

  示例：

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

• Claude 模型

  字段	类型	是否必填	描述
  base_url	String	是	Claude API 的基础请求地址。默认为官方服务地址，若使用代理或中转服务，请填写对应的地址。
  model	String	是	要使用的 Claude 模型名称。
  api_key	String	是	调用 Claude API 所需的密钥，通常为你的 ANTHROPIC_API_KEY。

  示例：

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

同时添加多个自定义模型

你可以一次性在 trae_cli.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"