Buck Blog · 博客正文

返回技术分享首页
智谱AI GLM-5.2 在 Claude Code 中调用配置（Windows + Linux 双平台指南）

智谱 AI GLM-5.2 在 Claude Code 中调用配置（Windows + Linux 双平台指南）

本指南详细介绍在 Windows（PowerShell） 和 Linux（Terminal） 环境中，从零搭建 Claude Code 并配置国产大模型 智谱 AI GLM-5.2 作为后端的完整过程。

> 适用环境： Windows 10/11 PowerShell / Linux Terminal，Claude Code v2.x
> 最后更新： 2026-07-22
> 当前配置版本参考： Node.js 22 + Claude Code 2.1.217

核心原理： 智谱 AI GLM-5.2 现已原生支持 Anthropic Messages API（端点：https://open.bigmodel.cn/api/anthropic）。Claude Code 也是 Anthropic 原生协议，所以不需要任何中间代理或格式转换——设置几个环境变量就能直接使用。
graph LR A[Claude Code] -->|Anthropic 原生协议| B[智谱AI Anthropic API]

> 相比旧版配置的优势： 不再需要 Python + 代理脚本，零依赖，零故障点，可靠性等同于使用官方 Claude 服务。

目录

1. 前置准备

1.1 系统要求

项目 Windows Linux
操作系统 Windows 10/11 Ubuntu 20.04+ / Debian / CentOS 等
Node.js 18+ 18+
内存 建议 8 GB 以上 建议 4 GB 以上
网络 能访问 open.bigmodel.cn 能访问 open.bigmodel.cn

1.2 知识准备

  • 了解基本的命令行操作（PowerShell 或 Bash）
  • 拥有智谱 AI 开放平台账号

2. 获取智谱 AI API Key

2.1 注册并获取密钥

  • 访问智谱 AI 开放平台：https://open.bigmodel.cn
  • 注册并登录账号（支持手机号注册）
  • 进入控制台 → API Keys 页面
  • 点击 "创建 API Key"，获取密钥

密钥格式通常为：xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx.xxxxxxxxxxxxxx

2.2 充值

API 调用按照 token 数量计费，GLM-5.2 的定价请参考官方页面：
https://open.bigmodel.cn/pricing

> 提示： 首次注册通常赠送体验额度，足够完成配置验证。正式开发建议充值 ≥ 10 元。

2.3 为什么不需要代理

智谱 AI 提供了 Anthropic 兼容 API：


https://open.bigmodel.cn/api/anthropic

Claude Code 原生使用 Anthropic Messages API 协议，和智谱的这个端点协议完全一致。所以只需设好环境变量指向这个地址，Claude Code 就能直接和 GLM-5.2 通信，不需要任何中间代理或格式转换。

3. 安装 Node.js 和 Claude Code

3.1 Windows（PowerShell）

安装 Node.js

访问 https://nodejs.org 下载 LTS 版本（推荐 22.x），运行安装程序，全部默认选项即可。

安装完成后，重新打开 PowerShell，验证：


node --version
# 输出示例：v22.12.0


npm --version

# 输出示例：10.9.0

安装 Claude Code


npm install -g @anthropic-ai/claude-code

验证：


claude --version
# 输出示例：2.1.217 (Claude Code)

3.2 Linux（Terminal）

安装 Node.js（使用 nvm）


# 安装 nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash


# 重新打开终端 或 source

source ~/.bashrc



# 安装 Node.js LTS

nvm install 22

nvm alias default 22



# 验证

node --version

npm --version

安装 Claude Code


npm install -g @anthropic-ai/claude-code


# 验证

claude --version

4. 配置环境变量

Claude Code 通过环境变量知道要连接哪个后端 API。只需设 3 个变量：

环境变量 值 作用
ANTHROPIC_BASE_URL https://open.bigmodel.cn/api/anthropic 指向智谱 Anthropic API
ANTHROPIC_AUTH_TOKEN 你的智谱 API Key 认证
ANTHROPIC_MODEL glm-5.2 使用的模型名

4.1 Windows（PowerShell）

临时配置（当前终端有效）


$env:ANTHROPIC_BASE_URL = "https://open.bigmodel.cn/api/anthropic"
$env:ANTHROPIC_AUTH_TOKEN = "<你的API Key>"
$env:ANTHROPIC_MODEL = "glm-5.2"

永久配置

以管理员身份打开 PowerShell，执行：


[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://open.bigmodel.cn/api/anthropic", "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "<你的API Key>", "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_MODEL", "glm-5.2", "User")

> 注意： 设置永久变量后，需要重新打开 PowerShell 才能生效。

4.2 Linux（Terminal）

在 ~/.bashrc 末尾添加（推荐直接编辑，无需额外配置文件）：


# Claude Code — 直连智谱 AI GLM-5.2
export ANTHROPIC_BASE_URL=https://open.bigmodel.cn/api/anthropic
export ANTHROPIC_AUTH_TOKEN=<你的API Key>
export ANTHROPIC_MODEL=glm-5.2

使配置生效：


source ~/.bashrc

验证：


echo $ANTHROPIC_BASE_URL
# 输出：https://open.bigmodel.cn/api/anthropic


echo $ANTHROPIC_MODEL

# 输出：glm-5.2

5. 启动并验证

5.1 直接启动 Claude Code


claude

如果一切配置正确，你会看到：


Claude Code v2.1.217

系统提示中会显示 You are powered by the model glm-5.2。

5.2 简单功能测试

在 Claude Code 中输入：


> 你好，请介绍一下你自己。

如果能正常收到智谱 AI GLM-5.2 的回复，配置就完成了！

5.3 直接测试 API（无需 Claude Code）


curl https://open.bigmodel.cn/api/anthropic/v1/messages \
  -H "Content-Type: application/json" \
  -H "x-api-key: <你的API Key>" \
  -H "anthropic-version: 2023-06-01" \
  -d '{"model":"glm-5.2","max_tokens":30,"messages":[{"role":"user","content":"say OK"}]}'

正常返回 JSON 响应即表示 API 可用。

6. 多模型共存（可选）

如果你想同时使用多个国产大模型（DeepSeek、GLM、Kimi），无需代理。每个模型对应一个终端命令即可。

Linux — 创建命令脚本


# DeepSeek v4-pro
cat > ~/bin/claude-ds << 'EOF'
#!/bin/bash
exec env \
  ANTHROPIC_BASE_URL=https://api.deepseek.com/anthropic \
  ANTHROPIC_AUTH_TOKEN=<DeepSeek API Key> \
  ANTHROPIC_MODEL=deepseek-v4-pro \
  claude "$@"
EOF


# GLM-5.2

cat > ~/bin/claude-glm << 'EOF'

#!/bin/bash

exec env \

  ANTHROPIC_BASE_URL=https://open.bigmodel.cn/api/anthropic \

  ANTHROPIC_AUTH_TOKEN=<智谱 API Key> \

  ANTHROPIC_MODEL=glm-5.2 \

  claude "$@"

EOF



# Kimi K3

cat > ~/bin/claude-kimi << 'EOF'

#!/bin/bash

exec env \

  ANTHROPIC_BASE_URL=https://api.moonshot.cn/anthropic \

  ANTHROPIC_AUTH_TOKEN=<Kimi API Key> \

  ANTHROPIC_MODEL=kimi-k3 \

  claude "$@"

EOF



chmod +x ~/bin/claude-ds ~/bin/claude-glm ~/bin/claude-kimi

使用：


claude-ds     # 启动 DeepSeek
claude-glm    # 启动 GLM-5.2
claude-kimi   # 启动 Kimi K3

Windows — 创建批处理脚本

在 %USERPROFILE%\bin\ 目录下创建对应的 .bat 或 .ps1 文件，原理相同。

7. 常见问题排查

7.1 claude 命令找不到

原因： npm 全局安装路径不在 PATH 中。 Windows： 

npm config get prefix
# 将输出路径添加到系统 PATH 环境变量
Linux： 

echo 'export PATH="$(npm config get prefix)/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

7.2 连接失败 / 超时

原因： 网络不通或 API Key 错误。 排查： 

# 直接用 curl 测试智谱 API（排除 Claude Code 因素）
curl -s --max-time 10 https://open.bigmodel.cn/api/anthropic/v1/messages \
  -H "Content-Type: application/json" \
  -H "x-api-key: <你的API Key>" \
  -H "anthropic-version: 2023-06-01" \
  -d '{"model":"glm-5.2","max_tokens":10,"messages":[{"role":"user","content":"hi"}]}'


# 如果能返回 JSON，说明 API 正常；检查环境变量

echo $ANTHROPIC_BASE_URL

7.3 API Key 认证失败 / 401 错误

原因： API Key 错误或未正确设置。 排查：
  • 确认 ANTHROPIC_AUTH_TOKEN 已设置为真实 API Key
  • 登录智谱 AI 控制台检查 API Key 状态
  • 确认账户有足够余额

7.4 网络连接超时 / 无法访问智谱 API

原因： 网络不通。 排查： 

# 测试 DNS 解析
nslookup open.bigmodel.cn


# 如果在内网需要配置代理

export HTTPS_PROXY=http://<代理IP>:<端口>

7.5 模型返回空内容

原因： GLM-5.2 是推理模型，max_tokens 设置过低时推理过程会消耗全部 token 预算。 排查： 确保 max_tokens 设置为 1024 以上。

附录 A：方案对比

代理方案（旧） 直连方案（新，推荐）
原理 本地起一个 Python 代理，转发请求 Claude Code 直接调 API
依赖 Python + httpx + uvicorn + systemd 无
磁盘占用 ~20 MB（venv） 0
启动时间 等 5-6 秒 即时
故障点 代理可能卡死 零
多模型 /model 命令切换 不同命令名切换
维护 需要更新脚本 + 服务 无需维护

> 一句话： 智谱提供 Anthropic API 之后，Claude Code 不再需要任何代理。直连方案的可靠性、简洁性和维护成本都远优于代理方案。

附录 B：配置速查


环境变量:  ANTHROPIC_BASE_URL  = https://open.bigmodel.cn/api/anthropic
          ANTHROPIC_AUTH_TOKEN = <你的智谱 API Key>
          ANTHROPIC_MODEL      = glm-5.2

附录 C：多模型命令速查

命令 模型 API 端点
claude-ds DeepSeek v4-pro api.deepseek.com/anthropic
claude-glm GLM-5.2 open.bigmodel.cn/api/anthropic
claude-kimi Kimi K3 api.moonshot.cn/anthropic

参考链接