# ZCode > 全部文档的索引见 [llms.txt](https://ark.volcengine.com/llms.txt)；在任一文档页面地址后追加 `.md` 可获取该页的 Markdown 版本。 ZCode 是智谱推出的桌面 AI 编程客户端（macOS / Windows / Linux），深度集成 GLM 系列模型，同时兼容自定义 OpenAI / Anthropic 协议供应商。本文介绍如何在 ZCode 中接入方舟 Coding Plan。 # 一、前置操作 1. 访问 [方舟 Coding Plan 活动](https://www.volcengine.com/activity/codingplan)，按需订阅套餐后再配置使用编程工具。 2. 访问 [ZCode 官网](https://zcode.z.ai/cn#all-downloads)，下载并安装适合您操作系统的版本。安装步骤可参考 [ZCode 官方安装教程](https://zcode.net.cn/en/docs/install#setup-guide)，安装完成后按提示登录。 # 核心配置 接入工具的核心参数如下： ## **模型配置** 支持以下两种方式配置模型： **选项：配置 Model Name (配置文件指定)** 在工具配置文件中指定 Model Name，可实时切换模型。支持配置的 Model Name： > **注意** > > 配置 Model Name 时，支持使用全小写格式，同时也支持直接复制 [开通管理页面](https://ark.volcengine.com/region:cn-beijing/openManagement?LLM=%7B%7D&advancedActiveKey=subscribe) 中的模型名称。 * `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` > **说明** > > Model Name 不支持配置为 `Auto`，如需使用，请通过控制台切换该模式。 **选项：配置 ark-code-latest (控制台管理)** 1. 在配置文件中指定模型为`ark-code-latest`。 2. 通过 [开通管理页面](https://ark.volcengine.com/region:cn-beijing/openManagement?LLM=%7B%7D&advancedActiveKey=subscribe) 选择或切换目标模型，切换模型后 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` > **注意** > > 请勿使用 `https://ark.cn-beijing.volces.com/api/v3` ：该 Base URL 不会消耗您的 Coding Plan 额度，而是会产生额外费用。 ## **API Key** [获取 API Key](https://ark.volcengine.com/region:cn-beijing/apikey) # 二、配置 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。安装并运行该助手，根据界面提示操作可自动完成工具配置，降低手动配置的时间成本和出错风险。 > **注意** > > * ArkCLI Helper 是基于 Ark Helper 升级演进的工具配置服务，相关能力将持续在 ArkCLI Helper 上迭代更新。建议优先使用 ArkCLI Helper 完成工具配置。 > * ArkCLI Helper 支持 macOS、Linux、Windows 系统。 1. 安装 Ark CLI。 ```Bash # 1. 通过 NPM 安装 npm install -g @volcengine/ark-cli@latest # 2. 验证安装 arkcli --version ``` 2. 登录 Ark CLI。 ```Bash arkcli auth login ``` ![image-20260624-144256-509.png](https://arkdocs.tos-cn-beijing.volces.com/images/CodingPlan/image-20260624-144256-509.png) 根据界面提示选择登录方式。若之前已登录过 arkcli，会沿用上次选择的配置；如需重新选择，请先执行 `arkcli config reset` 后再运行 `arkcli auth login`。首次登录时，按提示完成以下配置： 1. **选择项目（Project）**：可按需选择，或默认选择**账号全部资源**。 2. **选择消费模式（Type）**：选择 `coding-plan`。 ![image-20260624-163746-727.png](https://arkdocs.tos-cn-beijing.volces.com/images/CodingPlan/image-20260624-163746-727.png) 其中： * ``：运行 ArkCLI Helper 时填写的 Coding Plan API Key。 3. 运行 ArkCLI Helper，根据界面提示完成 ZCode 的配置。 1. 在命令行界面输入 `arkcli helper` 命令，启动 ArkCLI Helper。 2. **选择要配置的 Plan profile**：选择 `coding-plan_cn-beijing_personal (Coding Plan)`。 ![image-20260624-163451-813.png](https://arkdocs.tos-cn-beijing.volces.com/images/CodingPlan/image-20260624-163451-813.png) 3. **选择默认 model**：按需选择。 4. **选择要配置的 AI Agent**：`ZCode`。 ![](https://arkdocs.tos-cn-beijing.volces.com/images/CodingPlan/zcode-arkcli.png) 完成上述操作后，将自动完成 ZCode 的基础配置，无需手动安装。 ## 方式 2：手动配置 1. 打开 ZCode 客户端，单击左下角 **设置** 图标，进入 **模型设置**，单击 **添加供应商**。 ![zcode-setting.png](https://arkdocs.tos-cn-beijing.volces.com/images/CodingPlan/zcode-setting.png) 2. 在弹出的表单中填写以下字段，保存供应商。 * **名称**：自定义，便于识别，例如 `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](https://ark.volcengine.com/region:cn-beijing/apikey)。 * **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` | ![zcode-setting2.png](https://arkdocs.tos-cn-beijing.volces.com/images/CodingPlan/zcode-setting2.png) 3. 单击 **添加模型**，在表单中填写以下字段，保存模型。可以多次点击 **添加模型**，为一个供应商添加多个模型。 * **模型 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` 示例 ```JSON { "provider": { ... "ark-coding-plan": { "name": "Ark Coding Plan", "kind": "anthropic", "options": { "apiKey": "", "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` 示例 ```JSON { "provider": { ... "ark-coding-plan": { "name": "Ark Coding Plan", "kind": "openai-compatible", "options": { "apiKey": "", "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` 示例 ```JSON { "provider": { ... "ark-coding-plan": { "name": "Ark Coding Plan", "kind": "openai", "options": { "apiKey": "", "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 Key](https://ark.volcengine.com/region:cn-beijing/apikey)。 > * 上述示例仅列出 Coding Plan 目前提供的文本生成模型，实际支持的 Model Name 以上方**核心配置**中的列表为准；请删除您不需要或所选套餐不支持的条目，避免调用时收到 model not found 错误。 ![zcode-setting-ready.png](https://arkdocs.tos-cn-beijing.volces.com/images/CodingPlan/zcode-setting-ready.png) 1. 保存完成后，回到 ZCode 主界面。 ![zcode-start-to-work.png](https://arkdocs.tos-cn-beijing.volces.com/images/CodingPlan/zcode-start-to-work.png) # 三、使用 ZCode 1. 在 ZCode 主界面顶部的模型下拉中，选中刚添加的模型。 2. 在对话框输入你的需求（如生成代码、修复 bug、重构、写单元测试），回车即可开始对话开发。ZCode 支持规划、编码、评审与上线等全流程研发场景。 > 更多使用技巧和高级功能参见 [ZCode 官方文档](https://zcode.net.cn/en/docs)。