ZCode

ZCode 是智谱推出的桌面 AI 编程客户端（macOS / Windows / Linux），深度集成 GLM 系列模型，同时兼容自定义 OpenAI / Anthropic 协议供应商。本文介绍如何在 ZCode 中接入方舟 Coding Plan。

一、前置操作#

访问方舟 Coding Plan 活动，按需订阅套餐后再配置使用编程工具。
访问 ZCode 官网，下载并安装适合您操作系统的版本。安装步骤可参考 ZCode 官方安装教程，安装完成后按提示登录。

核心配置#

接入工具的核心参数如下：

模型配置#

支持以下两种方式配置模型：

在工具配置文件中指定 Model Name，可实时切换模型。支持配置的 Model Name：

doubao-seed-evolving
doubao-seed-2.1-pro
doubao-seed-2.1-lite
doubao-seed-2.0-mini
minimax-m3
glm-5.3 (glm-latest)
glm-5.3-flash
deepseek-v4.1-flash
deepseek-v4-flash
deepseek-v4-pro
kimi-k2.8-preview
kimi-k3

在配置文件中指定模型为ark-code-latest。
通过开通管理页面选择或切换目标模型，切换模型后 3-5 分钟即可生效。
支持 Auto 模式，通过「效果 + 速度」双维度智能算法自动选择模型。

Base URL#

不同的工具配置的 Base URL 根据兼容的协议会有不同：

兼容 Anthropic 接口协议工具：https://ark.cn-beijing.volces.com/api/coding
兼容 OpenAI 接口协议工具：https://ark.cn-beijing.volces.com/api/coding/v3

API Key#

获取 API Key

二、配置 ZCode#

Coding Plan 同时兼容 OpenAI 与 Anthropic 接口协议，ZCode 均支持。以下以 OpenAI 协议为例；如需使用 Anthropic 协议，将 API 格式改为 Anthropic 并把 Base URL 换成 https://ark.cn-beijing.volces.com/api/coding 即可。

方式 1：自动化助手（推荐）#

ArkCLI Helper 是一个编码工具助手，支持快速配置选择的工具接入 Coding Plan。安装并运行该助手，根据界面提示操作可自动完成工具配置，降低手动配置的时间成本和出错风险。

安装 Ark CLI。

1
2
3
4
5# 1. 通过 NPM 安装
npm install -g @volcengine/ark-cli@latest

# 2. 验证安装
arkcli --version

登录 Ark CLI。
Bash
```
1arkcli auth login
```
根据界面提示选择登录方式。若之前已登录过 arkcli，会沿用上次选择的配置；如需重新选择，请先执行 arkcli config reset 后再运行 arkcli auth login。首次登录时，按提示完成以下配置：
1. 选择项目（Project）：可按需选择，或默认选择账号全部资源。
2. 选择消费模式（Type）：选择 coding-plan。
其中：
- <ARK_API_KEY>：运行 ArkCLI Helper 时填写的 Coding Plan API Key。
运行 ArkCLI Helper，根据界面提示完成 ZCode 的配置。
1. 在命令行界面输入 arkcli helper 命令，启动 ArkCLI Helper。
2. 选择要配置的 Plan profile：选择 coding-plan_cn-beijing_personal (Coding Plan)。
3. 选择默认 model：按需选择。
4. 选择要配置的 AI Agent：ZCode。

完成上述操作后，将自动完成 ZCode 的基础配置，无需手动安装。

方式 2：手动配置#

打开 ZCode 客户端，单击左下角设置图标，进入 模型设置，单击 添加供应商。

在弹出的表单中填写以下字段，保存供应商。
- 名称：自定义，便于识别，例如 Ark Coding Plan。
- Base URL：https://ark.cn-beijing.volces.com/api/coding/v3（OpenAI 协议）；若使用 Anthropic 协议，填 https://ark.cn-beijing.volces.com/api/coding。
- API Key：填写您的方舟 API Key。
- API 格式：取决于选择的 Base URL。

API 格式	Base URL
Anthropic Messages	`https://ark.cn-beijing.volces.com/api/coding`
Chat Completions	`https://ark.cn-beijing.volces.com/api/coding/v3`
Responses	`https://ark.cn-beijing.volces.com/api/coding/v3`

单击 添加模型，在表单中填写以下字段，保存模型。可以多次点击 添加模型，为一个供应商添加多个模型。
- 模型 ID：填入支持的 Model Name（详见上方核心配置），或使用 ark-code-latest。
- 上下文窗口：按所选模型的最大上下文长度填写。
- 最大输出 Token（可选）：按需填写，默认可留空跟随模型上限。

除了在客户端 UI 中添加供应商，也可以直接编辑本地配置文件 ~/.zcode/v2/config.json（Windows 系统为 %USERPROFILE%\.zcode\v2\config.json）。首次通过 UI 完成任意配置后该文件会自动生成，已有内容时在 provider 对象中追加一条即可。

API 格式为Anthropic Messages时，~/.zcode/v2/config.json 示例

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75{
  "provider": {
    ...
    "ark-coding-plan": {
      "name": "Ark Coding Plan",
      "kind": "anthropic",
      "options": {
        "apiKey": "<ARK_API_KEY>",
        "baseURL": "https://ark.cn-beijing.volces.com/api/coding",
        "apiKeyRequired": true
      },
      "enabled": true,
      "source": "custom",
      "models": {
        "ark-code-latest": {
          "limit": { "context": 256000, "output": 32768 },
          "modalities": { "input": ["text", "image"], "output": ["text"] }
        },
        "doubao-seed-2.1-pro": {
          "limit": { "context": 1024000, "output": 262144 },
          "modalities": { "input": ["text", "image"], "output": ["text"] }
        },
        "doubao-seed-evolving": {
          "limit": { "context": 1024000, "output": 262144 },
          "modalities": { "input": ["text", "image"], "output": ["text"] }
        },
        "doubao-seed-2.1-lite": {
          "limit": { "context": 1024000, "output": 256000 },
          "modalities": { "input": ["text", "image"], "output": ["text"] }
        },
        "doubao-seed-2.0-mini": {
          "limit": { "context": 256000, "output": 128000 },
          "modalities": { "input": ["text", "image"], "output": ["text"] }
        },
        "minimax-m3": {
          "limit": { "context": 1024000, "output": 131072 },
          "modalities": { "input": ["text", "image"], "output": ["text"] }
        },
        "glm-5.3": {
          "limit": { "context": 1024000, "output": 131072 },
          "modalities": { "input": ["text"], "output": ["text"] }
        },
        "glm-5.3-flash": {
          "limit": { "context": 1024000, "output": 131072 },
          "modalities": { "input": ["text", "image"], "output": ["text"] }
        },
        "glm-latest": {
          "limit": { "context": 1024000, "output": 131072 },
          "modalities": { "input": ["text"], "output": ["text"] }
        },
        "deepseek-v4-flash": {
          "limit": { "context": 1024000, "output": 393216 },
          "modalities": { "input": ["text"], "output": ["text"] }
        },
        "deepseek-v4-pro": {
          "limit": { "context": 1024000, "output": 393216 },
          "modalities": { "input": ["text"], "output": ["text"] }
        },
        "deepseek-v4.1-flash": {
          "limit": { "context": 1024000, "output": 393216 },
          "modalities": { "input": ["text", "image"], "output": ["text"] }
        },
        "kimi-k2.8-preview": {
          "limit": { "context": 1024000, "output": 1024000 },
          "modalities": { "input": ["text", "image"], "output": ["text"] }
        },
        "kimi-k3": {
          "limit": { "context": 1024000, "output": 131072 },
          "modalities": { "input": ["text","image"], "output": ["text"] }
        }
      }
    }
    ...
  }
}

API 格式为Chat Completions时，~/.zcode/v2/config.json 示例

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75{
  "provider": {
    ...
    "ark-coding-plan": {
      "name": "Ark Coding Plan",
      "kind": "openai-compatible",
      "options": {
        "apiKey": "<ARK_API_KEY>",
        "baseURL": "https://ark.cn-beijing.volces.com/api/coding/v3",
        "apiKeyRequired": true
      },
      "enabled": true,
      "source": "custom",
      "models": {
        "ark-code-latest": {
          "limit": { "context": 256000, "output": 32768 },
          "modalities": { "input": ["text", "image"], "output": ["text"] }
        },
        "doubao-seed-2.1-pro": {
          "limit": { "context": 1024000, "output": 262144 },
          "modalities": { "input": ["text", "image"], "output": ["text"] }
        },
        "doubao-seed-evolving": {
          "limit": { "context": 1024000, "output": 262144 },
          "modalities": { "input": ["text", "image"], "output": ["text"] }
        },
        "doubao-seed-2.1-lite": {
          "limit": { "context": 1024000, "output": 256000 },
          "modalities": { "input": ["text", "image"], "output": ["text"] }
        },
        "doubao-seed-2.0-mini": {
          "limit": { "context": 256000, "output": 128000 },
          "modalities": { "input": ["text", "image"], "output": ["text"] }
        },
        "minimax-m3": {
          "limit": { "context": 1024000, "output": 131072 },
          "modalities": { "input": ["text", "image"], "output": ["text"] }
        },
        "glm-5.3": {
          "limit": { "context": 1024000, "output": 131072 },
          "modalities": { "input": ["text"], "output": ["text"] }
        },
        "glm-5.3-flash": {
          "limit": { "context": 1024000, "output": 131072 },
          "modalities": { "input": ["text", "image"], "output": ["text"] }
        },
        "glm-latest": {
          "limit": { "context": 1024000, "output": 131072 },
          "modalities": { "input": ["text"], "output": ["text"] }
        },
        "deepseek-v4-flash": {
          "limit": { "context": 1024000, "output": 393216 },
          "modalities": { "input": ["text"], "output": ["text"] }
        },
        "deepseek-v4-pro": {
          "limit": { "context": 1024000, "output": 393216 },
          "modalities": { "input": ["text"], "output": ["text"] }
        },
        "deepseek-v4.1-flash": {
          "limit": { "context": 1024000, "output": 393216 },
          "modalities": { "input": ["text", "image"], "output": ["text"] }
        },
        "kimi-k2.8-preview": {
          "limit": { "context": 1024000, "output": 1024000 },
          "modalities": { "input": ["text", "image"], "output": ["text"] }
        },
        "kimi-k3": {
          "limit": { "context": 1024000, "output": 131072 },
          "modalities": { "input": ["text","image"], "output": ["text"] }
        }
      }
    }
    ...
  }
}

API 格式为Responses时，~/.zcode/v2/config.json 示例

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75{
  "provider": {
    ...
    "ark-coding-plan": {
      "name": "Ark Coding Plan",
      "kind": "openai",
      "options": {
        "apiKey": "<ARK_API_KEY>",
        "baseURL": "https://ark.cn-beijing.volces.com/api/coding/v3",
        "apiKeyRequired": true
      },
      "enabled": true,
      "source": "custom",
      "models": {
        "ark-code-latest": {
          "limit": { "context": 256000, "output": 32768 },
          "modalities": { "input": ["text", "image"], "output": ["text"] }
        },
        "doubao-seed-2.1-pro": {
          "limit": { "context": 1024000, "output": 262144 },
          "modalities": { "input": ["text", "image"], "output": ["text"] }
        },
        "doubao-seed-evolving": {
          "limit": { "context": 1024000, "output": 262144 },
          "modalities": { "input": ["text", "image"], "output": ["text"] }
        },
        "doubao-seed-2.1-lite": {
          "limit": { "context": 1024000, "output": 256000 },
          "modalities": { "input": ["text", "image"], "output": ["text"] }
        },
        "doubao-seed-2.0-mini": {
          "limit": { "context": 256000, "output": 128000 },
          "modalities": { "input": ["text", "image"], "output": ["text"] }
        },
        "minimax-m3": {
          "limit": { "context": 1024000, "output": 131072 },
          "modalities": { "input": ["text", "image"], "output": ["text"] }
        },
        "glm-5.3": {
          "limit": { "context": 1024000, "output": 131072 },
          "modalities": { "input": ["text"], "output": ["text"] }
        },
        "glm-5.3-flash": {
          "limit": { "context": 1024000, "output": 131072 },
          "modalities": { "input": ["text", "image"], "output": ["text"] }
        },
        "glm-latest": {
          "limit": { "context": 1024000, "output": 131072 },
          "modalities": { "input": ["text"], "output": ["text"] }
        },
        "deepseek-v4-flash": {
          "limit": { "context": 1024000, "output": 393216 },
          "modalities": { "input": ["text"], "output": ["text"] }
        },
        "deepseek-v4-pro": {
          "limit": { "context": 1024000, "output": 393216 },
          "modalities": { "input": ["text"], "output": ["text"] }
        },
        "deepseek-v4.1-flash": {
          "limit": { "context": 1024000, "output": 393216 },
          "modalities": { "input": ["text", "image"], "output": ["text"] }
        },
        "kimi-k2.8-preview": {
          "limit": { "context": 1024000, "output": 1024000 },
          "modalities": { "input": ["text", "image"], "output": ["text"] }
        },
        "kimi-k3": {
          "limit": { "context": 1024000, "output": 131072 },
          "modalities": { "input": ["text","image"], "output": ["text"] }
        }
      }
    }
    ...
  }
}

保存完成后，回到 ZCode 主界面。

三、使用 ZCode#

在 ZCode 主界面顶部的模型下拉中，选中刚添加的模型。
在对话框输入你的需求（如生成代码、修复 bug、重构、写单元测试），回车即可开始对话开发。ZCode 支持规划、编码、评审与上线等全流程研发场景。

更多使用技巧和高级功能参见 ZCode 官方文档。