Claude Code

Documentation Index

Fetch the complete documentation index at: https://docs.z.ai/llms.txt

Use this file to discover all available pages before exploring further.

​

Step 1: Installing the Claude Code

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

# Navigate to your project
cd your-awesome-project

# Complete
claude

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

​

Step 2: Config GLM Coding Plan

1

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.

2

Configure Environment Variables

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 Cmd

Windows PowerShell

# 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",
        "API_TIMEOUT_MS": "3000000"
    }
}

​

Step 3: Start with Claude Code

cd your-project-directory
claude

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

{
    "env": {
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "glm-4.5-air",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "glm-5-turbo",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "glm-5.1"
}
}

​

FAQ

​

How to check which model is currently in use

​

Vision Search Reader MCP

​

Manual Configuration Not Work

• 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 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