Claude Code & 智谱GLM-5.1 环境配置指南 (Windows/macOS/Ubuntu)

前言

本指南将引导您完成安装和配置 Claude Code 和 GLM-5.1 的所有必要步骤。

本指南参考了智谱官方文档，并本地跑通：接入 Claude Code

在开始之前，您的系统需要安装好 Node.js 和 Git。。

下载与安装 ：请前往 Node.js 官方网站下载并安装最新版本的 Node.js（建议使用 v18 或更高版本）。根据您的操作系统下载对应的安装包。
验证安装 ：安装完成后，打开您的终端（Terminal）或命令提示符（CMD），运行以下命令来验证。
bash 复制代码
```
node -v
```
如果成功安装，将会显示 Node.js 的版本号。

Windows : 下载并安装 Git for Windows。安装时直接使用默认选项"下一步"即可。
macOS : Git 通常已预装。您可以在终端中运行 git --version 来检查。如果没有，系统会自动提示您安装"Command Line Developer Tools"，同意即可安装。
Ubuntu : 在终端中运行以下命令进行安装。
bash 复制代码
```
sudo apt update
sudo apt install git
```

接下来，我们将全局安装 Claude Code NPM 包。此步骤在不同操作系统下的主要区别在于是否需要管理员权限。

注意：为了获得最佳的安装体验，建议连接稳定的网络环境（例如使用科学上网）运行安装命令。

打开您的 终端（Terminal）。
由于全局安装 npm 包需要系统权限，您需要在命令前加上 sudo。
输入并运行以下安装命令（过程中会提示您输入电脑的登录密码）：
bash 复制代码
```
sudo npm install -g @anthropic-ai/claude-code
```

安装完成后，在 新的终端窗口 中运行以下命令来验证。
bash 复制代码
```
claude --version
```
如果终端成功返回版本号，则代表 Claude Code 已成功安装。
此时运行 claude 会报错（如图），因为它默认尝试使用 Anthropic 官方的 API 密钥进行验证，而我们尚未提供或配置。接下来的步骤将引导它使用我们自己的智谱GLM-5.1 API Key 和服务地址。

为了让 Claude Code 能够成功连接到 GLM-5.1 API，您需要配置四个重要的环境变量。

您可以选择以下任一方法进行配置：

方法一：使用命令提示符
打开命令提示符（无需管理员），并执行以下两条命令。请确保将 "你刚才复制的GLM_API_Key" 替换为您真实的 API Key。模型种类可选glm-5.1和glm-5-turbo，自己根据需求替换即可，air会轻量快速一些。个人建议全部配成最强的glm-5.1哈哈哈，如下：
bash 复制代码
```
setx ANTHROPIC_AUTH_TOKEN "你刚才复制的GLM_API_Key"
setx ANTHROPIC_BASE_URL "https://open.bigmodel.cn/api/anthropic"
setx ANTHROPIC_MODEL "glm-5.1"
setx ANTHROPIC_SMALL_FAST_MODEL "glm-5.1"
```
注意：setx 命令设置的是永久环境变量，但只对新打开的命令行窗口生效。当前窗口需要关闭后重开才能读取到新变量。
方法二：使用系统属性面板
1. 在 Windows 搜索栏中输入"环境变量"，并选择"编辑系统环境变量"。
2. 在"系统属性"窗口中，点击"环境变量..."。
3. 在"系统变量"区域，点击"新建..."，并添加两个新变量。

在 macOS 和 Ubuntu 系统中，环境变量通常配置在 Shell 的配置文件中。

确定您的 Shell 类型

在终端中运行 echo $SHELL。
- 如果输出包含 zsh，您的配置文件是 ~/.zshrc。
- 如果输出包含 bash，您的配置文件是 ~/.bashrc。
编辑配置文件

使用您喜欢的文本编辑器打开对应的文件。这里以 nano 为例（一个对新手友好的终端编辑器）。
bash 复制代码
```
# 如果您使用 Zsh (macOS 默认)
nano ~/.zshrc

# 如果您使用 Bash
nano ~/.bashrc
```
添加环境变量

在文件的末尾，添加以下两行。请将 你刚才复制的GLM_API_Key 替换为您真实的 API Key。模型种类可选glm-5.1和glm-5-turbo，自己根据需求替换即可，air会轻量快速一些。个人建议全部配成最强的glm-5.1哈哈哈，如下：
bash 复制代码
```
export ANTHROPIC_AUTH_TOKEN "你刚才复制的GLM_API_Key"
export ANTHROPIC_BASE_URL "https://open.bigmodel.cn/api/anthropic"
export ANTHROPIC_MODEL "glm-5.1"
export ANTHROPIC_SMALL_FAST_MODEL "glm-5.1"
```
添加后，按下 Ctrl + O 保存文件，然后按 Ctrl + X 退出编辑器。
使配置生效

运行以下命令让配置立即生效（或直接重启终端）。
bash 复制代码
```
# 如果您修改了 .zshrc
source ~/.zshrc

# 如果您修改了 .bashrc
source ~/.bashrc
```

完成所有配置后，您现在可以启动 Claude Code 了。

在你的工作目录打开一个 新的终端窗口。
输入claude 命令，你会看到你选择主题的选项，方向键上下可以切换主题，我这里默认选Dark mode，回车确认：
bash 复制代码
```
claude
```
首次启动 ：在首次运行时，程序会提示您选择登录方式。请选择 "Anthropic Console account" 。由于我们通过环境变量注入了 API Key，这里选择'Anthropic Console account'，程序会自动从环境变量中读取密钥信息，从而跳过官方的登录流程。因为我登录过了没截图，我从别处偷个首次登录的示意图：
然后进入到安全提示页面，直接回车
提示你是否要信任当前工作目录，选择Yes即可
登录成功，会显示如下界面。可以看到API Base URL是我们刚才配置好的。
完成以上步骤后，就可以开始使用由智谱GLM-5.1 驱动的 Claude Code 了。我们让它自我介绍一下吧，能看到它的回复就证明可以使用了。

以上就是所有内容，剩下的请自己探索吧。