自定义模型

自定义模型配置文件完整的结构如下：

{
  "provider": {
    "<提供商ID>": {
      "name": "<提供商显示名称>",
      "npm": "<SDK包名>",
      "api": "<提供商API地址>",
      "env": ["<环境变量名>", ...],
      "whitelist": ["<模型ID>", ...],
      "blacklist": ["<模型ID>", ...],
      "options": {
        "apiKey": "<API密钥>",
        "baseURL": "<API基础地址>",
        "useFullUrl": false,
        "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" },
          "provider": { "npm": "<SDK包名>", "api": "<API地址>" },
          "variants": { ... }
        }
      }
    }
  }
}

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

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

如果你已在其他工具（如码道IDE、Visual Studio Code等）中完成模型自定义，可直接将对应的配置文件拷贝到码道CLI，快速复用已有模型配置。

1. 获取已有模型配置文件codearts.json。
   • 码道IDE：%USERPROFILE%\.codeartsdoer\codearts-data
   • Visual Studio Code：%USERPROFILE%\.codeartsdoer\vscode-data
   • JetBrains（PyCharm/IntelliJ IDEA/WebStorm/CLion）：%USERPROFILE%\.codeartsdoer\IntelliJIDEA2025.3.4，将IntelliJIDEA2025.3.4替换为你本机IDE的实际版本目录。

2. 在码道CLI侧配置模型文件。
   1. 进入%USERPROFILE%/.codeartsdoer路径，找到并打开codearts_cli.json配置文件。
   2. 将1中codearts.json文件中provider字段内容，拷贝到codearts_cli.json中，保存并退出。

      {
        "$schema": "https://opencode.ai/config.json",
        "lsp": false,
        "provider": {
          "MaaS": {
            "name": "MaaS",
            "npm": "@ai-sdk/openai-compatible",
            "options": {
              "apiKey": "enc:v3:aPrf8u1f5M******FdrnKFvwfQu1pcAJgg3r/3q2Vdz",
              "baseURL": "https://api.modelarts-maas.com/v2",
              "glm-5.2": {
                "sourceType": "provider",
                "providerType": "MaaS",
                "provider": "华为云MaaS",
                "modelId": "glm-5.2",
                "modelName": "GLM5.2",
                "modelType": "textConversation",
                "modelDesc": "智谱GLM-5.2模型,擅长中文理解与大规模知识推理,适合企业级应用",
                "displayEnabled": true,
                "isCustomModel": true,
                "maxTokens": 0,
                "truncateLength": 0,
                "inputLength": 0,
                "inputContextWindow": 184000,
                "outputContextWindow": 16000,
                "contextWindow": 200000,
                "createdAt": "2026-09-02T02:50:01.197Z",
                "updatedAt": "2026-09-02T02:50:01.197Z"
              }
            },
            "models": {
              "glm-5.2": {
                "id": "glm-5.2",
                "limit": {
                  "context": 200000,
                  "output": 16000
                }
              }
            }
          }
        }
      }

3. 查看自定义模型是否添加成功。
   • 在CLI环境中执行以下命令，回显的模型列表中显示添加的模型，说明模型添加成功。

     codearts models

     图1 模型列表中显示添加的模型
     
   • 在TUI环境中输入如下斜杠命令，进入模型选择页面，显示添加的模型，说明模型添加成功。

     /models

     图2 选择模型页面显示添加的模型