{"slug": "zcode-z-ai-s-coding-agent-harness-explained", "title": "ZCode: Z.ai's coding agent harness, explained", "summary": "Z.ai's ZCode, an Apache-2.0 coding agent workspace with desktop, browser and terminal interfaces, had 7,541 GitHub stars as of 8 Oct 2026 and one release, v3.14.3, published 24 Sep 2026, according to the zai-org/ZCode repository. The repo's built-in provider file, zcode-builtin.json, listed 20 provider templates including Z.ai Coding Plan, BigModel, Kimi, MiniMax, DeepSeek, OpenAI, Anthropic, xAI and OpenRouter, with the Z.ai Coding Plan template naming GLM-5.3 and GLM-5.3-Flash. The software itself is free under Apache-2.0, while model use is billed by whichever provider a user connects.", "body_md": "# ZCode: Z.ai's coding agent harness, explained\n\nZCode is Z.ai's Apache-2.0 coding workspace: desktop app, browser view and terminal agent. How to install it, which models it lists, and what it costs.\n\nZCode is [Z.ai](http://Z.ai)’s open source coding workspace: a desktop app, a browser interface and a terminal agent in one Apache-2.0 repo, tuned for [Z.ai](http://Z.ai)’s GLM models but shipped with templates for other providers. We have not tested it. This page reports what its own pages say. Checked 8 Oct 2026.\n\nOther products are also called zcode. This page is about [Z.ai](http://Z.ai)’s ZCode only. It is one vendor’s workspace. If you want several agent CLIs working side by side, that is the layer [Munder Difflin](https://harnessmd.com/download) works at: free and open source: a desktop app that runs a team of coding agents such as Claude Code, Codex and Gemini CLI on your own computer. The [install guide](https://munderdiffl.in/blog/how-to-install-and-use-munder-difflin/) covers setup, and more explainers sit in the [concepts hub](https://munderdiffl.in/blog/topics/concepts/).\n\n## What is ZCode and who makes it? [#](#what-is-zcode-and-who-makes-it)\n\nZCode is a coding agent workspace made by [Z.ai](http://Z.ai). The [README](https://github.com/zai-org/ZCode/blob/main/README.en.md) calls it “an AI coding workspace with desktop, browser, and terminal interfaces”, and says the repo holds the clients, backend services, shared UI, and the Agent CLI and runtime source.\n\nThe GitHub API for [zai-org/ZCode](https://github.com/zai-org/ZCode) showed this on 8 Oct 2026: created 20 Sep 2026, last push 29 Sep 2026, Apache-2.0, 7,541 stars. The description reads “[Z.ai](http://Z.ai)’s coding agent harness. Powerful, intelligent, extensible.” The [releases page](https://github.com/zai-org/ZCode/releases) had one release, v3.14.3, published 24 Sep 2026. [Z.ai](http://Z.ai)’s [product page](https://zcode.z.ai/en) calls it the “Official Harness for GLM-5.3”. New to the word? Read [what is a multi-agent harness](https://munderdiffl.in/blog/what-is-a-multi-agent-harness/).\n\n## How do I install ZCode? [#](#how-do-i-install-zcode)\n\nDownload the desktop installer from [zcode.z.ai](http://zcode.z.ai), or build from source. The [install docs](https://zcode.z.ai/en/docs/install) list macOS (Apple Silicon and Intel), Windows (x64 and ARM64) and Linux (x64 and ARM64, as AppImage, DEB or RPM). The download page marks Linux as Beta.\n\nTo build from source, the README asks for Git, Node 24.14.0 and pnpm 10.33.2, then:\n\n```\npnpm bootstrap      # install dependencies, prepare desktop assets\npnpm dev:desktop    # run the desktop app\npnpm build:zcode    # build the command line distribution\n```\n\nThe command line build gives one `zcode` command. With no arguments it starts the terminal UI. `zcode --web` starts the browser interface. The README says both modes run locally without Electron, and that the distribution still requires Node.\n\nThe README gives no hosted one line installer. `pnpm build:zcode` needs a download base URL, and the one in the README is a placeholder.\n\n## Which models and providers does ZCode support? [#](#which-models-and-providers-does-zcode-support)\n\nThe README does not list models. The list is in the repo’s built-in provider file, [zcode-builtin.json](https://github.com/zai-org/ZCode/blob/main/config/provider/zcode-builtin.json). On 8 Oct 2026 it held 20 provider templates: [Z.ai](http://Z.ai) Coding Plan, [Z.ai](http://Z.ai) API, BigModel, Kimi, MiniMax, DeepSeek, Alibaba Cloud, Xiaomi MiMo, OpenAI, Anthropic, xAI, OpenRouter, and OpenCode Go and Zen. The [Z.ai](http://Z.ai) Coding Plan template names two models, GLM-5.3 and GLM-5.3-Flash.\n\nWe found no Ollama entry in that file. The [model docs](https://zcode.z.ai/en/docs/configuration) say you can connect compatible services “through the Anthropic / OpenAI protocols” or with an API key.\n\n## What does ZCode cost? [#](#what-does-zcode-cost)\n\nThe code costs nothing: the repo is Apache-2.0. Model use is billed by the provider you connect.\n\nFor [Z.ai](http://Z.ai)’s own plan, the ZCode product page listed these GLM Coding Plan prices on 8 Oct 2026, and added: “Prices and plan benefits may change.”\n\n| Plan | Price shown | Figure shown beside it | Usage as listed | \n|---|---|---|---|\n| Lite | $12.6 / month | $18 | 10,000 credits / week | \n| Pro | $56 / month | $80 | 6× Lite usage | \n| Max | $117.6 / month | $168 | 14× Lite usage | \n\nThe page shows the second figure struck through and does not explain it. On 8 Oct 2026 [Z.ai](http://Z.ai)’s [Coding Plan overview](https://docs.z.ai/devpack/overview) said “Starting at just 18 USD per month” and that each plan has both a 5-hour and a weekly limit. The [ZCode docs](https://zcode.z.ai/en/docs/welcome) describe 5 days of free benefits for first-time users, with daily quotas “granted only during these 5 days”.\n\n## What features does ZCode list? [#](#what-features-does-zcode-list)\n\nMCP, skills, subagents, hooks, plugins and workflows, per its docs and its [`NOTICE.md`](https://github.com/zai-org/ZCode/blob/main/NOTICE.md) file, which is written in Chinese (our translation).\n\n- **MCP.** The[MCP page](https://zcode.z.ai/en/docs/mcp-services) covers stdio servers and says SSE and HTTP remote servers are also supported.\n- **Skills.** A[skill](https://zcode.z.ai/en/docs/skill) is a folder with a`SKILL.md` file, at`~/.zcode/skills/<skill-name>/SKILL.md` for user-level skills.\n- **Subagents.** The[subagents page](https://zcode.z.ai/en/docs/subagents) names two built-in ones,`general-purpose` and the read-only`Explore` . Custom subagents are marked Beta.\n- **Hooks.**`NOTICE.md` lists seven lifecycle events, from`SessionStart` to`Stop` .\n- **Workflows.** The v3.14.3 release notes say a running workflow’s concurrency limit can be changed without stopping the task.\n\n## How does ZCode compare with Claude Code, Codex CLI and OpenCode? [#](#how-does-zcode-compare-with-claude-code-codex-cli-and-opencode)\n\nZCode, Codex CLI and OpenCode carry open source licences, and Claude Code’s licence file says all rights reserved. This table is our selection of rows, each from that tool’s own repo or docs on 8 Oct 2026.\n\n| Tool | Maker | Licence | Model access, as stated | \n|---|---|---|---|\n| ZCode | [Z.ai](http://Z.ai) | Apache-2.0 | 20 built-in provider templates | \n| Munder Difflin | Munder Difflin | Free and open source | Whatever each CLI you run supports | \n| [Claude Code](https://code.claude.com/docs/en/setup) | Anthropic | “All rights reserved” | Pro, Max, Team, Enterprise or Console account, or a third-party provider like Amazon Bedrock | \n| [Codex CLI](https://github.com/openai/codex) | OpenAI | Apache-2.0 | Sign in with ChatGPT, or an API key with additional setup | \n| [OpenCode](https://opencode.ai/docs/) | Anomaly | MIT | “any LLM provider by configuring their API keys” | \n\nLonger write-ups: [what is OpenCode](https://munderdiffl.in/blog/what-is-opencode/), [what is Codex](https://munderdiffl.in/blog/what-is-codex/) and [Claude Code alternatives](https://munderdiffl.in/blog/claude-code-alternatives/).\n\n## What are the limits and what is not documented? [#](#what-are-the-limits-and-what-is-not-documented)\n\nOur view: the biggest gap is that the public repo may not match the shipped product. `NOTICE.md` says the project does not promise every feature and promotion of the official product. Three more points from the same file:\n\n- The shared agent execution adapter provides no default operating system sandbox.\n- The standalone CLI uses `yolo` mode for`--prompt` runs when no`--mode` is given.\n- The bundled Computer Use package is an unavailable placeholder.\n\nVersions differ too. GitHub’s one release is v3.14.3, with a macOS arm64 and a Windows x64 installer. The download page listed v3.14.4. The README has no benchmark figures and no model list.\n\n## Who does ZCode suit? [#](#who-does-zcode-suit)\n\nOur view: ZCode suits people who already pay for a GLM Coding Plan and want [Z.ai](http://Z.ai)’s own desktop workspace with the source open to read. The repo is under three weeks old, so for a longer public record we think OpenCode or Codex CLI is the safer first pick. We have not run ZCode: this is a reading of its documents, not a review. Our [best AI coding agents](https://munderdiffl.in/blog/best-ai-coding-agents/) page compares more tools.\n\n## FAQ\n\nIs ZCode free?\n\nThe code is free under Apache-2.0. Model use is separate. On 8 Oct 2026 the ZCode site listed GLM Coding Plan Lite at $12.6 a month next to an $18 figure, and its docs described 5 days of free benefits for first-time users. The site says prices and plan benefits may change.\n\nWho makes ZCode?\n\nZ.ai. The source is at zai-org/ZCode on GitHub, and its description reads: Z.ai's coding agent harness. Powerful, intelligent, extensible.\n\nDoes ZCode only work with GLM models?\n\nNo. The built-in provider file in the repo had 20 templates on 8 Oct 2026, including Z.ai, Kimi, MiniMax, DeepSeek, OpenAI, Anthropic, xAI and OpenRouter. The ZCode docs say it is tuned for GLM-5.3.\n\nDoes ZCode support MCP, skills and subagents?\n\nYes, according to its docs. They describe stdio, HTTP and SSE MCP servers, skills as a folder with a SKILL.md file, and two built-in subagents called general-purpose and Explore. Custom subagents are marked Beta.\n\nIs Z.ai's ZCode the only product called zcode?\n\nNo. Other products use the name. This page covers only the ZCode made by Z.ai, at zcode.z.ai and zai-org/ZCode.", "url": "https://wpnews.pro/news/zcode-z-ai-s-coding-agent-harness-explained", "canonical_source": "https://munderdiffl.in/blog/what-is-zcode/", "published_at": "2026-10-08 00:00:00+00:00", "updated_at": "2026-10-09 10:24:06.112437+00:00", "lang": "en", "topics": ["ai-agents", "ai-tools", "developer-tools", "large-language-models", "ai-products"], "entities": ["Z.ai", "ZCode", "zai-org/ZCode", "GLM-5.3", "GLM-5.3-Flash", "Munder Difflin", "OpenRouter", "Anthropic"], "also_reported_by": [], "alternates": {"html": "https://wpnews.pro/news/zcode-z-ai-s-coding-agent-harness-explained", "markdown": "https://wpnews.pro/news/zcode-z-ai-s-coding-agent-harness-explained.md", "text": "https://wpnews.pro/news/zcode-z-ai-s-coding-agent-harness-explained.txt", "jsonld": "https://wpnews.pro/news/zcode-z-ai-s-coding-agent-harness-explained.jsonld"}}