Claude Code

Claude Code is an agentic coding tool that lives in your terminal, understands your codebase, and helps you code faster by executing routine tasks, explaining complex code, and handling git workflows — all through natural language commands.

To use the latest GLM-5.2 model, see How to Switch the Model in Use.

Step 1: Installing the Claude Code

Recommended Installation Method
Cursor Guided Installation Method

Prerequisites:

Node.js 18 or newer
For MacOS, please use nvm to install Nodejs, if you directly install the package, maybe encounter permission issues
For Windows, please additionally install Git for Windows

# Install Claude Code
npm install -g @anthropic-ai/claude-code

# Navigate to your project
cd your-awesome-project

# Complete
claude

If you are not familiar with npm but have Cursor, you can enter the command in Cursor, and Cursor will guide you through the installation of Claude Code.

https://docs.anthropic.com/en/docs/claude-code/overview Help me install Claude Code

Note: If MacOS users encounter permission issues during installation, please use nvm to install Nodejs.

Step 2: Config GLM Coding Plan

Get API Key

Access Z.AI Open Platform, Register or Login.
Create an API Key in the API Keys management page.
Copy your API Key for use.

Configure Environment Variables

Mapping between Claude Code internal model environment variables and GLM models, with the default configuration as follows:

ANTHROPIC_DEFAULT_OPUS_MODEL: GLM-4.7
ANTHROPIC_DEFAULT_SONNET_MODEL: GLM-4.7
ANTHROPIC_DEFAULT_HAIKU_MODEL: GLM-4.7

Set up environment variables using one of the following methods in the macOS Linux or Windows:

Note: Some commands show no output when setting environment variables — that’s normal as long as no errors appear.

Automated Coding Tool Helper
Automated Script
Manual configuration

Coding Tool Helper is a coding-tool companion that quickly loads GLM Coding Plan into your favorite Coding Tools. Install and run it, then follow the on-screen guidance to automatically install tools, configure plan, and manage MCP servers.

# Run Coding Tool Helper directly in the terminal
npx @z_ai/coding-helper

For more details, please refer to the Coding Tool Helper documentation.

Just run the following command in your terminal
Attention only macOS Linux environment is supported, this method does not support Windows

curl -O "https://cdn.bigmodel.cn/install/claude_code_zai_env.sh" && bash ./claude_code_zai_env.sh

The script will automatically modify ~/.claude/settings.json to configure the following environment variables(You don’t need to edit manually):

{
    "env": {
        "ANTHROPIC_AUTH_TOKEN": "your_zai_api_key",
        "ANTHROPIC_BASE_URL": "https://api.z.ai/api/anthropic",
        "API_TIMEOUT_MS": "3000000"
    }
}

If you have previously configured environment variables for Claude Code, you can manually configure them as follows. A new window is required for the changes to take effect.

MacOS & Linux & Windows

# Edit the Claude Code configuration file `~/.claude/settings.json`
# Add or modify the env fields ANTHROPIC_BASE_URL, ANTHROPIC_AUTH_TOKEN
# Note to replace `your_zai_api_key` with the API Key you obtained in the previous step

{
        "env": {
        "ANTHROPIC_AUTH_TOKEN": "your_zai_api_key",
        "ANTHROPIC_BASE_URL": "https://api.z.ai/api/anthropic",
        "ANTHROPIC_DEFAULT_HAIKU_MODEL": "glm-4.7",
        "ANTHROPIC_DEFAULT_SONNET_MODEL": "glm-5.2[1m]",
        "ANTHROPIC_DEFAULT_OPUS_MODEL": "glm-5.2[1m]",
        "CLAUDE_CODE_AUTO_COMPACT_WINDOW": "1000000",
        "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": 1,
        "API_TIMEOUT_MS": "3000000"
    }
}

Step 3: Start with Claude Code

Once the configuration is complete, you can start using Claude Code in your terminal or cmd:

cd your-project-directory
claude

If prompted with “Do you want to use this API key,” select “Yes.”

After launching, grant Claude Code permission to access files in your folder as shown below: Description

You can use Claude Code for development Now!

FAQ

Manual Configuration Not Work

If you manually modified the ~/.claude/settings.json configuration file but found the changes did not take effect, refer to the following troubleshooting steps.

Close all Claude Code windows, open a new command-line window, and run claude again to start.
If the issue persists, try deleting the ~/.claude/settings.json file and then reconfigure the environment variables; Claude Code will automatically generate a new configuration file.
Confirm that the JSON format of the configuration file is correct, check the variable names, and ensure there are no missing or extra commas; you can use an online JSON validator tool to check.

Recommended Claude Code Version

We recommend using the latest version of Claude Code. You can check the current version and upgrade with the following commands:

We have verified compatibility with Claude Code 2.0.14 and other versions.

# Check the current version
claude --version

2.0.14 (Claude Code)

# Upgrade to the latest
claude update

GLM Coding Plan

Guide

Learning Resources

Campaign Rules

Step 1: Installing the Claude Code

Step 2: Config GLM Coding Plan

Step 3: Start with Claude Code

FAQ

Manual Configuration Not Work

Recommended Claude Code Version

​Step 1: Installing the Claude Code

​Step 2: Config GLM Coding Plan

​Step 3: Start with Claude Code

​FAQ

​Manual Configuration Not Work

​Recommended Claude Code Version

Step 1: Installing the Claude Code

Step 2: Config GLM Coding Plan

Step 3: Start with Claude Code

FAQ

Manual Configuration Not Work

Recommended Claude Code Version