ZCode Developer Guide 2026: Z.ai's Agentic IDE for GLM-5.2

Official Sources

Last updated: July 7, 2026

ZCode launched publicly the week of July 1, 2026, positioning itself as the official harness for GLM-5.2 - Zhipu AI's open-weights coding model that scores 62.1% on SWE-bench Pro. The app is free. You pay for the AI models you connect.

Z.ai calls ZCode an "Agentic Development Environment" - an ADE rather than an IDE. Where a Cursor or VS Code fork puts the editor first and bolts an agent onto it, ZCode puts the agent conversation at the center and arranges everything the agent touches around it: a file manager, a terminal, a Git panel, and a live browser preview, all in one Electron app.

What ZCode Actually Is

ZCode is a desktop application that bundles:

• An agent chat interface with goal-directed execution
• A file manager with agent write access
• An integrated terminal the agent can use
• A Git panel for version control
• A live browser preview for web projects
• MCP server support for extensibility
• Skills and plugin systems
• SSH and Docker container support for remote development

The design philosophy is that the agent maintains context across files, terminal output, browser state, execution modes, and Git state simultaneously - reducing mid-task context breaks that plague other tools.

Installation

Download the desktop app for your platform:

• macOS: Apple Silicon and Intel builds available
• Windows: x64 and ARM64 builds
• Linux: Beta support

After installation:

1. Create a Z.ai account or log in with BigModel credentials
2. Connect your GLM model access (free trial or GLM Coding Plan)
3. Configure your workspace directory
4. Start a task

New users get a 5-day free trial: 3M GLM-5.2 tokens/day plus 2M GLM-5-turbo tokens/day (5M total daily).

GLM Coding Plan Pricing

ZCode itself is free. The models cost money. Z.ai offers the GLM Coding Plan as a flat-fee subscription:

Through September 2026, there is a 30% promo that drops Lite to $12.60/month, Pro to $50.40/month, and Max to $112/month.

The GLM Coding Plan works with ZCode and 20+ other clients: Claude Code, Cline, Roo Code, OpenClaw, and others that support custom model providers.

Usage Multipliers

GLM-5.2 and GLM-5-turbo normally consume quota at:

• 3x during peak hours (14:00-18:00 Beijing time)
• 2x off-peak

A limited-time promotion through September 2026 drops off-peak to 1x consumption.

During ZCode's campaign (through July 31, 2026), GLM-5.2 usage via the Coding Plan is metered at a 0.67 factor - effectively about 1.5x the usable quota.

Pay-As-You-Go Alternative

If you prefer API pricing over subscriptions:

These are competitive rates - GLM-5.2 output is roughly 10x cheaper than Claude Fable 5.

Key Features

Goal Mode

Set a verifiable session objective with /goal - the agent keeps iterating until the goal is verified complete. This is the "agentic" part of the agentic development environment.

/goal "Add user authentication with email/password and OAuth to the Next.js app"

The agent will plan, implement, test, and iterate until the goal is done or it hits a blocker.

Custom Subagents

Subagents are stored as plain Markdown files at ~/.zcode/agents/. They can be invoked:

• Automatically when the primary agent matches a task to a subagent's description
• Explicitly with @name in chat

This is similar to Claude Code's skills system but with automatic routing.

Edit History

ZCode lets you modify prior messages without restarting tasks. If the agent went in the wrong direction, you can edit your original prompt and resume from there without losing context.

Remote Development

SSH and Docker container support enables agent operations in target environments. You can point ZCode at a remote machine or container and the agent executes there - useful for testing in production-like environments or working with large codebases you do not want to clone locally.

Mobile and Bot Access

ZCode supports remote control via:

• A mobile app for monitoring and triggering tasks
• Feishu and WeChat bot integrations for task dispatch

You can start a long-running task from your desk, then check on it from your phone.

GLM-5.2 Performance Context

The model powering ZCode scores:

• SWE-bench Pro: 62.1% (vs Claude Opus 4.8 at 69.2%, Claude Sonnet 5 at 63.2%)
• Terminal-Bench 2.1: 81.0 (vs Claude Opus 4.8 at 85.0)
• Vending Bench 2: $4,432 - ranking #1 among open-source models

GLM-5.2 is a 744B parameter mixture-of-experts model with 40B active parameters. It uses IndexShare architecture that reduces per-token computation by 2.9x at 1M context - making long-horizon tasks more efficient.

The model is Apache-2.0 licensed with no regional restrictions.

ZCode vs Claude Code vs Cursor

ZCode's unique advantage is the combination of goal-directed execution with an open-weights model at competitive pricing. The disadvantage is that GLM-5.2, while strong, is not quite at Claude Opus 4.8 levels on the hardest tasks.

Data Residency Consideration

ZCode runs on Z.ai's infrastructure, which operates under Chinese data law. Every GLM-5.2 API call routes through servers subject to PRC jurisdiction. For most development work this is fine. For code involving regulated data, sensitive IP, or compliance requirements, consider whether this matters for your use case.

This is not unique to ZCode - it applies to any tool using GLM models via Z.ai's API.

When to Use ZCode

Good fit:

• You want an agentic IDE built around goal-directed execution
• You want to use an open-weights model (Apache-2.0)
• You need competitive pricing for high-volume coding work
• You want mobile access to long-running tasks
• You are comfortable with Chinese data infrastructure

Not the best fit:

• You need the absolute best model quality (Claude Opus 4.8 still leads)
• You have strict data residency requirements
• You prefer the VS Code ecosystem and extensions
• You already have a Claude Max or Cursor Pro subscription

Getting Started

1. Download ZCode from zcode.z.ai
2. Create a Z.ai account
3. Start the 5-day free trial (5M tokens/day)
4. Open a project directory
5. Use /goal to set your first objective
6. Let the agent work

If the trial works for your use case, the Lite plan at $18/month (or $12.60/month with the current promo) is the next step.

FAQ

Is ZCode free?

The app is free. The AI models cost money. New users get a 5-day free trial with 5M tokens/day. After that, you need a GLM Coding Plan ($18-160/month) or pay-as-you-go API access.

Can I use ZCode with models other than GLM?

ZCode is designed as the official harness for GLM models. It does not support Claude, GPT, or other providers. If you want multi-model support, look at Claude Code or Cursor.

How does GLM-5.2 compare to Claude Sonnet 5?

GLM-5.2 scores 62.1% on SWE-bench Pro vs Sonnet 5's 63.2%. They are in the same ballpark. GLM-5.2 is open-weights (Apache-2.0) and cheaper at $1.40/$4.40 per MTok vs Sonnet 5's $2/$10 introductory rate.

What is the edit history feature?

ZCode lets you modify prior messages in a conversation without starting over. If the agent went down a wrong path, you can edit your original prompt and the agent continues from there with full context.

Does ZCode work offline?

No. ZCode requires internet access to call the GLM API. There is no local model option within ZCode itself, though GLM-5.2 can be self-hosted separately via vLLM or SGLang.

What is Goal Mode?

Goal Mode sets a verifiable objective for the session. The agent keeps iterating - planning, implementing, testing, fixing - until the goal is complete or it hits a blocker that requires human input.

Can I use the GLM Coding Plan with other tools?

Yes. The GLM Coding Plan works with 20+ clients including Claude Code, Cline, Roo Code, and others that support custom model providers. You are not locked to ZCode.

What are the data residency implications?

Z.ai operates under Chinese data law. All API calls route through PRC-jurisdiction servers. This matters for regulated industries and sensitive code. It does not matter for most development work.

Sources

• ZCode Documentation
• GLM Coding Plan Pricing
• GLM-5 GitHub Repository
• GLM-5.2 Developer Guide
• AI Coding Tools Pricing Comparison