自定义模型

约束与限制

• 接入第三方企业自定义模型仅支持OpenAI规范的Chat Completions API格式和Anthropic规范的Messages API格式。
• 在控制台新建的自定义模型所有智能体均可调用，在客户端新建的自定义模型仅系统内置智能体、AgentTeam和自定义智能体可调用，智能问答无法调用。
• 相同模型提供商和模型ID的模型仅允许添加一次。

前提条件

• 已将账号添加至企业成员中，并启用席位。
• 若您已购买华为云码道代码智能体专业版套餐，请确保企业管理员已在控制台开启成员自定义模型权限，具体操作请参考配置企业自定义模型。

自定义模型配置文件

在码道CLI中，通过配置文件对自定义模型进行管理。在CLI/TUI模式下，不支持使用命令创建、修改或删除自定义模型，所有配置均需手动编辑文件。

自定义模型配置文件及其存放路径：“~/.codeartsdoer/codearts_cli.json”，“~”表示当前用户的主目录，Windows下等同于“C:\Users\用户名\”，macOS下等同于“/Users/用户名/”，Linux下等同于“/home/用户名/”。

配置文件以provider为顶层键，每个提供商ID对应一个配置块。自定模型配置文件完整的结构如下：

{
  "provider": {
    "<提供商ID>": {
      "name": "<提供商显示名称>",
      "npm": "<SDK包名>",
      "api": "<提供商API地址>",
      "env": ["<环境变量名>", ...],
      "whitelist": ["<模型ID>", ...],
      "blacklist": ["<模型ID>", ...],
      "options": {
        "apiKey": "<API密钥>",
        "baseURL": "<API基础地址>",
        "enterpriseUrl": "<企业版URL>",
        "setCacheKey": true,
        "timeout": 300000,
        "chunkTimeout": 60000
      },
      "models": {
        "<模型ID>": {
          "id": "<模型API标识>",
          "name": "<显示名称>",
          "family": "<模型家族>",
          "reasoning": true,
          "attachment": true,
          "temperature": true,
          "tool_call": true,
          "limit": { "context": 128000, "input": 120000, "output": 8000 },
          "cost": {
            "input": 3.0,
            "output": 15.0,
            "cache_read": 0.5,
            "cache_write": 2.0,
            "context_over_200k": {
              "input": 6.0,
              "output": 30.0,
              "cache_read": 1.0,
              "cache_write": 4.0
            }
          },
          "modalities": {
            "input": ["text", "image", "pdf"],
            "output": ["text"]
          },
          "headers": { "X-Custom-Header": "value" },
          "status": "active",
          "provider": { "npm": "<SDK包名>", "api": "<API地址>" },
          "variants": { ... }
        }
      }
    }
  }
}

apiKey是您的核心资产，请不要轻易外泄。当您配置apiKey后，重启TUI/CLI，系统会自动对apiKey进行加密，后续配置文件中展示的就是密文。

提供商ID是配置文件中的顶层键名，用于标识模型来源。常见提供商ID，如表1所示。您也可以使用任意自定义字符串作为提供商ID（如my-server），只要对应模型支持OpenAI兼容的API格式即可。

自定义模型配置示例

以最小化配置为例，演示如何通过设置提供商ID、API密钥及模型来自定义模型。以Windows操作系统为例。

1. 进入%USERPROFILE%/.codeartsdoer路径，找到并打开codearts_cli.json配置文件。
2. 在codearts_cli.json配置文件中，增加provider内容。

   {
     "$schema": "https://opencode.ai/config.json",
     "provider": {
       "deepseek": {
         "options": {
           "apiKey": "sk-***",
           "baseURL": "https://api.deepseek.com/v1"
         },
         "models": {
           "deepseek-chat": {
             "name": "DeepSeek Chat"
           },
           "deepseek-reasoner": {
             "name": "DeepSeek Reasoner",
             "reasoning": true
           }
         }
       }
     },
     "mcp": {},
     "lsp": false
   }

   其中，apiKey需要您到DeepSeek官网购买后填写。

3. 保存文件并退出。
4. 查看自定义模型是否添加成功。
   • 在CLI环境中执行以下命令，从回显的模型列表中检查是否包含自定义模型。

     codearts models

   • 在TUI环境中输入如下斜杠命令，进入模型选择页面确认是否存在自定义模型。

     /models

指定运行模型

在码道CLI中，您可以通过指定特定模型来运行您的任务。如下命令中，provider为模型的供应商，model为模型的名称。

• TUI开发环境
  • 在启动TUI开发模式时，可以通过执行如下命令，指定运行的模型。

    codearts --model provider/model
    或使用短参数
    codearts -m provider/model

  • 在TUI开发环境中，只需输入“/models”命令即可快速切换模型。
• CLI开发环境

  codearts run --model provider/model "您的问题"