ZCode is the best first test when you want an integrated desktop harness designed around GLM-5.2. Z.AI describes it as an Agentic Development Environment that keeps goals, files, terminal results, browser context, execution mode, and Git state in one task.
That integration is a product claim, not proof that ZCode beats Pi or OpenCode on your repository. Run the same-model harness test in the comparison guide.
Quick facts
| Question | ZCode answer |
|---|---|
| Interface | Desktop ADE for macOS, Windows, and Linux |
| Model focus | Deep GLM-5.2 integration |
| Long work | Goal Mode with repeated execution and automatic goal verification |
| Delegation | Built-in general-purpose and read-only Explore subagents; custom subagents in beta |
| Safety | Default, confirm-before-changes, auto-edit, plan, and fuller-access modes |
| Review | Files, terminal, Git changes, edit history and task state in one workspace |
| Best for | Long-running GLM work where integrated state and review matter |
Install and Connect
Download the installer for your operating system from the official ZCode page. The current product page publishes signed desktop downloads rather than a package-manager command.
After installation:
- Open a repository as a workspace.
- Connect the GLM model or GLM Coding Plan account documented in ZCode.
- Start in Confirm Before Changes or Plan mode.
- Give one bounded task with tests and a stopping rule.
- Review the Git changes before committing.
Use the Z.AI guide for Coding Plan prices, quota windows, renewal, and supported-use policy. ZCode’s harness features do not turn the plan into a general unlimited API.
Goal Mode
Set an explicit objective with:
| |
ZCode says Goal Mode verifies the goal at the end of each iteration and continues when the goal is not met. This can reduce “continue” prompts, but it can also multiply quota use when acceptance criteria are vague.
Define:
- the exact test or observable outcome;
- files or directories that are out of scope;
- commands that must pass;
- actions that require approval;
- when the agent must stop and report a blocker.
Subagents
ZCode includes a general-purpose subagent and an Explore role designed for read-only search. Custom user-level subagents are currently beta and can define their own model, instructions, tools, and permissions.
Subagents can improve context separation, but they are not free throughput. Parallel or repeated exploration consumes quota and can return overlapping summaries. Use one read-only explorer for a clearly bounded question before adding more.
Safety Confirmations
ZCode documents several execution modes:
| Mode | Practical use |
|---|---|
| Confirm Before Changes | Production code, secrets, infrastructure, unfamiliar repositories |
| Plan | Refactors and migrations that need review before implementation |
| Auto Edit | Routine file edits while commands still require confirmation |
| Fuller access | Controlled sandboxes after the task and rollback path are understood |
Permission prompts show the proposed command, file change, or tool action. Do not approve a broad command merely because Goal Mode is active; the goal and the permission boundary solve different problems.
GLM-5.2 Context and Quota
ZCode is designed to use GLM-5.2’s 1M-token capacity, but capacity is not productivity. Large context, repeated goal iterations, and multiple subagents can consume more quota without improving the patch.
Z.AI applies five-hour and weekly Coding Plan limits and estimates that one prompt may invoke the model 15–20 times. Record retries, interventions, files changed, and quota in the same-model test card.
Choose ZCode When
- GLM-5.2 is your primary model.
- You want desktop task state, terminal, Git, review, and long-running goals together.
- Built-in safety modes and read-only exploration fit your workflow.
- You accept a tighter Z.AI product relationship than a provider-neutral harness.
Choose Pi for a minimal programmable terminal core. Choose OpenCode for broad providers, explicit permission configuration, and terminal/desktop/IDE/GitHub paths.
Related links
- /compare/pi-vs-zcode-vs-opencode/
- /tools/pi/
- /tools/opencode/
- /models/glm-5.2/
- /tools/zai/
- /value/smart-spend/
Sources
- ZCode product and downloads (Archive)
- ZCode GLM-5.2 overview (Archive)
- ZCode Goal Mode (Archive)
- ZCode subagents (Archive)
- ZCode safety confirmations (Archive)
- ZCode changelog (Archive)
- Z.AI Coding Plan overview (Archive)
- Z.AI Coding Plan usage policy (Archive)
- Z.AI Coding Plan FAQ (Archive)
Last verified: July 2, 2026. ZCode features, beta scope, downloads, and Coding Plan limits can change.