Skip to main content

Install ZCode and Sign In

ZCode Beginner Path · Step 1

This guide does one thing: install ZCode and sign in with a BigModel account. It usually takes 5–10 minutes.

1. Download and Install ZCode

Open the ZCode website and download the version for your computer.

SystemInstallation
WindowsDownload the Windows installer, open it, and follow the prompts
macOSOpen the .dmg file and drag ZCode into Applications
LinuxChoose AppImage, DEB, or RPM in the download section

If you are unsure which chip or package to choose, use the option recommended on the download page. See the ZCode installation documentation for details.

2. Launch ZCode for the First Time

After installation:

  1. Click Start Using ZCode.
  2. Skip data migration if you have no previous data to import.
  3. Continue to the sign-in page.

ZCode first-launch and sign-in screens showing the Start Using ZCode button and the Z.ai, BigModel, and API Key options

3. Choose “Connect with BigModel”

On the welcome screen, click the middle option:

👉 Connect with BigModel

Cropped ZCode welcome panel showing the Z.ai, BigModel, and API Key options; choose Connect with BigModel to continue

Your browser will open the BigModel sign-in or authorization page:

  1. Sign in to your BigModel account.
  2. Complete the authorization shown on the page.
  3. Return to ZCode.

4. Confirm That Sign-In Worked

After browser authorization, return to ZCode. Sign-in is complete when you reach the new-task or workspace screen and the sign-in choices no longer appear.

For an extra check, open Settings → Model Settings from the lower-left gear icon and confirm that BigModel shows Enabled. Do not change the plan or model in this guide; Step 3 covers those settings.

ZCode BigModel settings after sign-in, with the provider enabled and the current quota and GLM model list visible

Completion Check

  • ZCode is installed and opens normally;
  • you selected Connect with BigModel;
  • authorization returns you to the new-task or workspace screen;
  • the sign-in choices no longer appear.

Next: Step 2 · Enable ZCode Core Capabilities.