ZCode

ZCode

URL: https://mrxapi.com/docs/docs/tools/zcode

ZCode 是一款面向长周期任务（Long Horizon Task）的 Agentic Development Environment（ADE）桌面应用，支持自定义供应商接入兼容 Anthropic / OpenAI 协议的模型服务。本页说明如何接入MRXAPI。

---

安装 ZCode

前往官网下载并安装适合你操作系统的版本：

• 官网：https://zcode.z.ai

---

添加MRXAPI供应商

打开 设置 → 模型供应商，在左侧供应商列表底部点击「添加供应商」，按下表填写：

• Anthropic 接口地址：https://mrxapi.com —— 不带 /v1，客户端会自己拼 /v1/messages
• OpenAI 接口地址：https://mrxapi.com/v1 —— 必须带 /v1

填反会出现 401 / 404。两个地址可以同时填在同一个供应商条目里，ZCode 会按所选模型走对应协议。

---

添加模型

自定义供应商不会自动拉取模型清单，需要手动添加：

1. 保存供应商配置
2. 点击「添加模型」
3. 手动填写模型 ID，例如 claude-opus-5
4. 开启启用开关

需要多个模型就重复添加。常用模型 ID：

不知道填什么模型？前往 模型广场 查看全部可用模型 ID 并一键复制。

---

启用 1M 长上下文

claude-opus-5、claude-sonnet-5 等主线模型支持 1M token 长上下文，在模型 ID 后加 [1M] 后缀即可启用：

复制claude-opus-5[1M]

按上面「添加模型」的步骤把带后缀的完整 ID 填进去即可。

在 设置 → 模型供应商 里点开某个模型、展开「高级」，可以为这一个模型单独设置上下文窗口与最大输出 Token。自定义供应商的模型支持修改这两项。

最大输出 Token 建议默认留空（跟随模型自身上限）。注意输出空间与历史对话共用同一个上下文，调得越高能带的历史对话越少，自动压缩也会来得更早。

---

验证配置

配置完成后重启 ZCode，在对话框的模型选择器里选中刚添加的模型，发送一句简单指令测试。能正常回复即配置成功。

ZCode 设置里的 HTTP 代理不是全局代理，但模型请求会走代理。如果配了代理导致连不上，关掉代理重试即可。另外 HTTP_PROXY / HTTPS_PROXY 环境变量同样生效，改完需要重启 ZCode。

---

注意事项

• MRXAPI属于「第三方供应商 / 自定义供应商」，请用列表底部的「添加供应商」新建，不要改动内置的智谱、Z.ai 等条目
• Anthropic 接口地址填 https://mrxapi.com（不带 /v1）；OpenAI 接口地址填 https://mrxapi.com/v1（带 /v1）
• API Key 填MRXAPI后台生成的 sk- 开头密钥
• 自定义供应商必须手动「添加模型」并开启启用开关，模型才会出现在选择器里
• 同名模型的第三方部署，可用的思考强度档位可能与官方端点不同，自定义模型通常只有「开启 / 关闭」两档或不提供档位
• 使用自定义模型时若遇到图片相关报错，请确认该模型本身支持图片输入，并在模型配置中明确声明图片能力