Help Center/ CodeArts Agent/ User Guide (IDE)/ Models
Updated on 2026-09-17 GMT+08:00
View PDF
Share

Models

Enterprise members can add third-party LLMs to the CodeArts Agent client. If you have purchased the CodeArts Agent professional edition, you can also add third-party LLMs on the console. For details, see Configuring Custom Models.

Constraints

Table 1 Constraints

Category

Description

API format

Only the OpenAI Chat Completions format and Anthropic Messages format are supported.

Calling tool

Custom models cannot be invoked in the Ask mode. They can be invoked only by built-in system agents, AgentTeam, and custom agents.

Credit consumption/Token consumption

When you call custom models, credits or tokens from the CodeArts Agent package are not consumed. However, to minimize inference latency, the code generation function uses dedicated built-in models and does not support custom models.

Uniqueness

The provider and model ID combination of each model you add must be unique.

Prerequisites

Viewing Built-in Models

  1. Log in to CodeArts Agent IDE as instructed in Quick Start.
  2. Click in the upper right corner of the page to access the global settings page of the IDE.
  3. In the navigation pane of the Settings page, choose Model.
  4. View the built-in models in the Built-in area.

    If you are using CodeArts Agent professional edition, custom models created by the enterprise administrator on the console are also displayed in addition to the built-in system models. The provider is CodeArts for built-in models and Built-in for enterprises for custom models created on the console.

    The page displays all built-in system models and custom models created on the console, regardless of whether they are enabled on the console.

Adding Custom Models

CodeArts Agent allows you to add custom models by specifying the model provider or using custom configurations.

  • Via providers: CodeArts Agent is preset with some LLMs from mainstream providers. Once you select the provider and model ID, CodeArts Agent automatically populates the model URL. You only need to configure the API key for a quick setup.
  • Via custom configuration: You must manually specify the model URL, model ID, and API key. This method is suitable for integrating self-hosted local models or models from providers not included in the preset list.
  1. Log in to CodeArts Agent IDE as instructed in Quick Start.
  2. Click in the upper right corner of the page to access the global settings page of the IDE.
  3. In the navigation pane of the Settings page, choose Model.
  4. Click Add Model.
  5. Select Model Provider, and set parameters by referring to Table 2.

    Figure 1 Adding a model by specifying the model provider
    Table 2 Adding a model by specifying the model provider

    Parameter

    Description

    Model Provider

    Select the provider to which the model to be added belongs from the drop-down list.

    Model ID

    Select the ID of the model to be added. If the required model ID is not in the list, select Custom.

    Custom Model ID

    This parameter is available only when Model ID is set to Custom.

    Enter the model ID obtained from the model provider. Its value contains a maximum of 64 characters.

    Model Name

    Enter the name of a model displayed in CodeArts Agent. The name contains a maximum of 64 characters.

    API Key

    Enter the API key obtained from the model provider.

    Custom Model URL

    Optional. After you select a provider, the system automatically populates the model URL. To modify the model URL, enable Custom Edit and enter the new model URL. Enter only the base URL of the API. For example, if the model address is https://open.bigmodel.cn/api/paas/v4/chat/completions, enter https://open.bigmodel.cn/api/paas/v4 here.

    Context Window Tokens

    Optional. Set the input tokens and output tokens.

    • Input: indicates the maximum number of tokens that can be received by the model in a single request.
    • Output: indicates the maximum number of tokens that can be delivered by the model in a single response.

    Description

    Optional. Enter a maximum of 200 characters to describe the custom model.

  6. Click Confirm.

    In the Custom area, view the added custom model, which is enabled by default.

  1. Log in to CodeArts Agent IDE as instructed in Quick Start.
  2. Click in the upper right corner of the page to access the global settings page of the IDE.
  3. In the navigation pane of the Settings page, choose Model.
  4. Click Add Model.
  5. Select Custom Configuration, and set parameters by referring to Table 3.

    Figure 2 Adding a model through custom configuration
    Table 3 Adding a model through custom configuration

    Parameter

    Description

    API Format

    Select the API format used by the model from the drop-down list. The options include OpenAI Chat Completions and Anthropic Messages.

    Model URL

    Enter the model URL obtained from the model provider. Note that only the base URL of the API is required.

    For example, if the model address is https://open.bigmodel.cn/api/paas/v4/chat/completions, enter https://open.bigmodel.cn/api/paas/v4 here.

    If you enable Use Full URL, enter the full URL of the model.

    Model ID

    Enter the model ID obtained from the model provider. Its value contains a maximum of 64 characters. For example, glm-5.2.

    Model Name

    Enter the name of a model displayed in CodeArts Agent. The name contains a maximum of 64 characters.

    API Key

    Enter the API key obtained from the model provider.

    Context Window Tokens

    Optional. Set the input tokens and output tokens.

    • Input: indicates the maximum number of tokens that can be received by the model in a single request.
    • Output: indicates the maximum number of tokens that can be delivered by the model in a single response.

    Description

    Optional. Enter a maximum of 200 characters to describe the custom model.

  6. Click Confirm.

    In the Custom area, view the added custom model, which is enabled by default.

Using Custom Models

In the lower part of the chat box, choose Built-in > Agent, or choose Custom and select a custom model from the model list on the right.

Managing Custom Models

After creating custom models, enterprise members can edit, delete, and disable them as required.

Operation

Procedure

Editing a custom model
  1. In the Custom area, click next to the target custom model.
  2. Edit the model parameters and click Confirm.

Deleting a custom model
  1. In the Custom area, click next to the target custom model.
  2. Click Delete.

    The target custom model is removed from the Custom area, indicating that it is successfully deleted.

Enabling/Disabling a custom model

In the Custom area, click or next to the target custom model to enable or disable it.

Once disabled, custom models will no longer show up in the model list in the lower part of the chat box.