API Key Setup

ZCode currently supports three ways to connect model services:

Setup Entry Points

Method 1: First-Launch Welcome Screen

The first time you open ZCode without any usable model, the welcome screen offers connection options directly:

• Continue with Z.ai: authorize and sign in with a Z.ai account.
• Continue with BigModel: authorize and sign in with a Zhipu BigModel account.
• Use API Key: fill in an API Key directly and go to the model provider settings.

After you choose Continue with Z.ai or Continue with BigModel, ZCode opens the authorization flow and waits for the provider to finish authentication. Once authentication succeeds, the account is bound automatically.

Method 2: Model Selector

After entering ZCode, click the model name inside the chat box to open the model selector, then click Manage Models at the bottom of the list to open the Settings -> Model Settings panel, where you manage the model channels available to ZCode Agent.

Connect BigModel

1. Open the Model Settings panel through either method above
2. Select BigModel from the provider list on the left
3. Connect your account and turn on the enable switch to use built-in models such as GLM-5.2 and GLM-5-Turbo according to your account permissions
4. Use the switcher in the upper-right corner to choose a connection mode: bind a GLM Coding Plan via Coding Plan, or switch to API Key access

Free Trial Quota

New users get a trial plan as soon as they connect a BigModel account: no payment required, with a free daily quota for flagship GLM models. The provider page shows today's balance and usage in real time, so you can try first and decide whether to upgrade later.

Subscribe to a Coding Plan Inside ZCode

Need more than the trial quota? You don't have to leave ZCode: the BigModel provider page lists the GLM Coding plans (Lite / Pro / Max) with monthly, quarterly, and yearly billing, and you can complete the purchase in-app after signing in. Existing subscribers can also manage their current plan and check quota status here.

Connect With an API Key

If you use model resource packages or prepaid balance from the Zhipu open platform, switch the connection mode to API Key:

1. In the upper-right corner of the BigModel provider page, switch the connection mode to API Key
2. Keep the default Base URL https://open.bigmodel.cn/api/anthropic
3. Fill in the API Key obtained from the Zhipu open platform
4. Available models depend on your account permissions and the model list returned by the provider; click Add Model to add other available models

Connect Z.ai

Z.ai is the connection option for overseas users, and the setup flow mirrors BigModel:

1. Open the Model Settings panel through either method above
2. Select Z.ai from the provider list on the left
3. Connect your account and turn on the enable switch to use built-in models such as GLM-5.2 and GLM-5-Turbo
4. The switcher in the upper-right corner also toggles between Coding Plan and API Key connection modes

Once connected, the provider page shows your current plan plus today's balance and usage per model:

Trial Quota and Coding Plans

Just like BigModel, new users get a free daily trial quota for flagship GLM models, and you can browse and subscribe to the GLM Coding plans (Lite / Pro / Max, priced in USD) right on the page, with monthly, quarterly, and yearly billing.

Connect With an API Key

If you already have an API Key from the Z.ai platform, switch the connection mode to API Key:

1. In the upper-right corner of the Z.ai provider page, switch the connection mode to API Key
2. Keep the default Base URL https://api.z.ai/api/anthropic
3. Fill in the API Key obtained from the Z.ai platform
4. Available models depend on your account permissions and the model list returned by the provider; click Add Model to add other available models

Anthropic (Claude API)

1. Open the Model Settings panel through either method above
2. Click Add Provider at the bottom of the provider list on the left
3. Name it "Anthropic"
4. Set the Anthropic endpoint to https://api.anthropic.com
5. Fill in the API Key obtained from the Anthropic platform, where you can also check usage and plans
6. After saving, ZCode shows models according to the available model list returned by the provider
7. If models are not loaded automatically, click Add Model to add Anthropic-supported models manually

OpenRouter

1. Create an API Key

Go to the OpenRouter platform, register an account, and create an API Key.

2. Configure in ZCode

1. Open the Model Settings panel
2. Click Add Provider at the bottom of the provider list on the left
3. Name it "OpenRouter"
4. Set the API base URL to https://openrouter.ai/api
5. Fill in the API Key
6. Turn on the enable switch to start using it

Moonshot

1. Open the Model Settings panel
2. Click Add Provider at the bottom of the provider list on the left
3. Name it "Moonshot"
4. Set the Anthropic endpoint to https://api.moonshot.cn/anthropic
5. Get an API Key from the Kimi open platform (token packages and usage are available there) and fill it into the API Key field
6. After saving, ZCode shows models according to the available model list returned by the provider; if models are not loaded automatically, click Add Model to add Moonshot-supported models manually

OpenAI

1. Open the Model Settings panel
2. Click Add Provider at the bottom of the provider list on the left
3. Name it "OpenAI"
4. Set the API base URL to https://api.openai.com
5. Fill in the API Key obtained from the OpenAI platform
6. After saving, ZCode shows models according to the available model list returned by the provider; if models are not loaded automatically, click Add Model to add OpenAI-supported models manually

MiniMax

1. Open the Model Settings panel
2. Click Add Provider at the bottom of the provider list on the left
3. Name it "MiniMax"
4. Set the Anthropic endpoint to https://api.minimaxi.com/anthropic
5. Get an API Key from the MiniMax open platform (plans and billing are available there) and fill it into the API Key field
6. After saving, ZCode shows models according to the available model list returned by the provider; if models are not loaded automatically, click Add Model to add MiniMax-supported models manually

Xiaomi MiMo

1. Open the Model Settings panel
2. Click Add Provider at the bottom of the provider list on the left
3. Name it "Xiaomi MiMo"
4. Set the API base URL to https://api.xiaomimimo.com/v1
5. Get an API Key from the Xiaomi MiMo open platform (Token Plan packages are available there) and fill it into the API Key field
6. After saving, ZCode shows models according to the available model list returned by the provider; if models are not loaded automatically, click Add Model to add Xiaomi MiMo-supported models manually

Custom Providers (Anthropic / OpenAI Compatible)

ZCode can add any model service compatible with the Anthropic / OpenAI protocols as a custom provider — public model services, team-managed enterprise channels, or self-hosted services on a private network.

When you pick a vendor Base URL from the list or enter a compatible endpoint, the system automatically detects it and loads the available model list, so you no longer need to add model names one by one.

Setup Steps

1. Open the Model Settings panel
2. Click Add Provider at the bottom of the provider list on the left
3. Name the provider (e.g. claude, deepseek)
4. Choose the vendor Base URL from the dropdown, or enter the API base URL manually
5. Fill in the API Key for the service
6. Once the endpoint is confirmed, the system automatically fetches and fills in the available model list
7. Turn on the enable switch to start using it

Taking the DeepSeek-compatible endpoint as an example:

• Name it "DeepSeek"
• Set the Anthropic endpoint to https://api.deepseek.com/anthropic
• Set the OpenAI endpoint to https://api.deepseek.com/v1
• Fill in the API Key obtained from the DeepSeek open platform
• Use the actual model list returned by the provider; if needed, manually add model IDs agreed on by your team
• Click save

Team usage tip: for enterprise model channels, manage the Base URL, API Key, model list, and access policy at the team level so long-running tasks have a stable and traceable model connection.

Verify The Setup

After configuration, choose the channel from the model selector in the chat box and send a short test instruction. Once the model responds reliably, you are ready to go.

Next Steps