ZCode

前提条件

• 已订阅MaaS Token Plan个人版套餐。具体操作请参见快速开始。

约束限制

该功能仅支持“西南-贵阳一”区域。

步骤一：安装ZCode

在ZCode官网下载并安装对应操作系统的版本。ZCode支持macOS、Windows和Linux。

安装完成后，打开ZCode，可选择连接Z.ai账号、BigModel账号或使用API Key接入模型。本文以使用API Key接入MaaS模型为例。

步骤二：接入MaaS模型API

1. 打开ZCode，在对话框下方单击模型选择器，选择“管理模型”。如下图所示：
   图1 打开模型设置页面
   

2. 进入“模型设置”页面，在右上角单击“添加供应商”，选择“创建自定义供应商”，如图所示：
   图2 添加供应商
   

3. 在“添加供应商”页面，参考下表配置。
   图3 设置自定义供应商

   

   表1 自定义供应商配置

   参数	说明	示例
   供应商名称	自定义供应商名称。 单击右上角，选择“重命名”	MaaS-Token-Plan
   Base URL	必填。 Chat Completions格式，路径如下：https://api.modelarts-maas.com/plan/v2 Anthropic Messages格式，路径如下：https://api.modelarts-maas.com/plan/anthropic	https://api.modelarts-maas.com/plan/v2
   API格式	必填。 Chat Completions格式 Anthropic Messages格式	选择Chat Completions格式
   API Key	必填。 可使用已有的API Key，如果没有可获取API Key。	gA4ocs*****Tc-Kz4AQ

4. 单击“添加模型”，按照下表配置模型。
   图4 配置模型示例
   

   表2 模型配置

   参数	说明	示例
   模型ID	必填。 从模型列表中的“模型参数”中获取。	deepseek-v4.1-flash
   上下文窗口	必填。 模型一次可处理的上下文容量，单位为Token。 可智能配置，配置为模型支持的上限。可从模型列表中的“长度限制”中查看模型支持的上限。 请勿超过模型的实际上下文限制。	1,000,000
   最大输出Token	必填。 单次模型请求允许生成的最大Token数，单位为Token。 可智能配置，配置为模型支持的上限。可从模型列表中的“长度限制”中查看模型支持的上限。 请勿超过模型的实际上下文限制。	384,000
   高级配置	选填。可设置输入类型、模型能力、推理等级等。	-

5. 单击“保存”后，单击模型操作栏的“测试模型”，连接成功表示模型添加成功。
   图5 测试模型
   

步骤三：使用ZCode

1. 在ZCode主页面左侧导航栏，选择“新建任务”，进入对话框，在对话框下方选择步骤二：接入MaaS模型API配置的模型，如下图所示：
   图6 选择模型
   

2. 在对话框进行对话，体验模型，如下图所示：
   图7 对话示例
   

常见报错