大家好，我是讯享网，很高兴认识大家。这里提供最前沿的Ai技术和互联网信息。



最近在项目里折腾PDF文档处理，遇到个挺有意思的需求：批量给一批PDF文件添加统一格式的水印，同时还要能根据特定规则移除某些水印。这活儿要是手动操作，估计得折腾一整天。我第一个想到的就是用Claude Code来写脚本，毕竟它生成代码的速度和准确度在圈内是出了名的。但实际用起来才发现，原版Claude Code的订阅费用对个人开发者来说确实有点压力，而且网络稳定性也是个问题。

就在我琢磨着有没有更优解的时候，发现智谱AI的GLM-4.5模型居然能无缝对接Claude Code，价格只有原版的几分之一，响应速度还特别快。更关键的是，它完全支持本地化部署，不需要折腾那些复杂的网络配置。我花了一个周末的时间，在Windows和Mac上都折腾了一遍，把整个配置流程和实际应用场景都摸透了。今天就把这套完整的解决方案分享出来，特别是那个PDF水印处理的实战案例，相信对很多开发者都有参考价值。

配置GLM-4.5到Claude Code的第一步，是确保你的开发环境已经就绪。这里有个小细节需要注意：虽然Claude Code本身是基于Node.js的，但不同操作系统在环境变量配置上有着本质的区别。很多教程只讲一种系统，导致用户在另一个平台上遇到各种奇怪的问题。

1.1 基础环境搭建

无论你用的是Windows还是macOS，首先都需要安装Node.js。我建议使用Node.js 18或更高版本，因为Claude Code的一些依赖包对版本有要求。如果你之前已经安装过Node.js，可以通过以下命令检查当前版本：

node –version npm –version 

如果版本低于18，建议升级。在macOS上，用Homebrew管理Node.js版本是最方便的选择：

brew install node@18 

Windows用户可以直接从官网下载安装包，记得勾选“Add to PATH”选项，这样命令行工具才能正常识别node和npm命令。

安装完Node.js后，就可以全局安装Claude Code了：

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

安装完成后，验证一下是否成功：

claude –version 

如果看到类似2.0.14 (Claude Code)的输出，说明安装没问题。这里有个小坑：有些Windows用户在安装时可能会遇到权限问题。如果出现权限错误，可以尝试用管理员权限打开命令行工具再执行安装命令。

1.2 获取智谱API Key

接下来需要去智谱AI开放平台注册账号并获取API Key。这个过程比较简单：

1. 访问智谱AI开放平台（bigmodel.cn）
2. 注册/登录账号
3. 进入控制台，找到API管理页面
4. 点击“创建新的API Key”

创建成功后，系统会生成一个以b5db10d…开头的字符串，这就是你的API Key。一定要妥善保管这个Key，不要把它硬编码到任何公开的代码或配置文件中。我习惯的做法是，在获取Key后立即复制到剪贴板，然后马上开始配置环境变量，避免Key在屏幕上停留太久。

注意：智谱AI目前提供免费额度和付费套餐。对于日常开发使用，免费额度其实已经足够应付大多数场景。但如果你需要处理大量代码生成任务，建议考虑他们的编程套餐，性价比确实很高。

这是整个配置过程中最关键的一步，也是Windows和macOS差异最大的地方。很多人在这里卡住，主要是因为没搞清楚两种系统环境变量管理机制的本质区别。

2.1 Windows系统配置方案

Windows的环境变量管理相对直观，但配置方式有多种，每种都有其适用场景。我推荐使用系统级环境变量配合settings.json文件的组合方案，这样既保证了全局可用，又能在需要时快速调整。

方法一：使用setx命令（推荐）

打开命令提示符（CMD）或PowerShell，依次执行以下命令：

setx ANTHROPIC_AUTH_TOKEN “你的智谱API Key” setx ANTHROPIC_BASE_URL “https://open.bigmodel.cn/api/anthropic” setx CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC 1 

这里有个重要细节：setx命令设置的是永久环境变量，但不会立即在当前会话生效。你需要关闭当前的命令行窗口，重新打开一个新的，环境变量才会生效。这是很多Windows用户容易忽略的地方。

方法二：图形界面配置

如果你不习惯命令行，也可以通过系统设置来配置：

1. 右键点击“此电脑” → “属性” → “高级系统设置”
2. 点击“环境变量”按钮
3. 在“系统变量”区域点击“新建”
4. 分别添加以下两个变量：
   • 变量名：ANTHROPIC_AUTH_TOKEN，变量值：你的API Key
   • 变量名：ANTHROPIC_BASE_URL，变量值：https://open.bigmodel.cn/api/anthropic

图形界面的好处是直观，但如果你需要频繁切换不同的API Key（比如测试环境和生产环境），还是命令行更方便。

方法三：配置文件方式（最灵活）

在Windows中，Claude Code会读取C:Users你的用户名.claudesettings.json这个配置文件。你可以直接创建或修改这个文件：

{ “env”: {

"ANTHROPIC_AUTH_TOKEN": "你的智谱API Key", "ANTHROPIC_BASE_URL": "https://open.bigmodel.cn/api/anthropic", "API_TIMEOUT_MS": "", "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": 1 

} }

配置文件方式的优势在于，你可以为不同的项目创建不同的配置，通过软链接或脚本快速切换。我个人的工作流是：将基础配置放在环境变量中，项目特定的调整通过settings.json来管理。

2.2 macOS/Linux系统配置方案

Unix-like系统的环境变量配置更加灵活，主要通过shell配置文件来实现。但不同的shell（bash、zsh、fish）配置文件位置不同，这也是很多用户困惑的地方。

确定你的默认shell

首先需要知道当前使用的是哪种shell：

echo $SHELL 

如果输出/bin/bash，说明用的是bash；如果是/bin/zsh，说明是zsh。macOS从Catalina开始默认使用zsh，但很多开发者可能还在用bash。

bash用户配置

编辑~/.bashrc文件（如果不存在就创建）：

nano ~/.bashrc 

在文件末尾添加：

export ANTHROPIC_AUTH_TOKEN=“你的智谱API Key” export ANTHROPIC_BASE_URL=”https://open.bigmodel.cn/api/anthropic” export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1 

保存后执行：

source /.bashrc 

zsh用户配置

编辑/.zshrc文件：

nano ~/.zshrc 

添加同样的内容，然后：

source /.zshrc 

配置文件方式

和Windows一样，macOS/Linux也可以通过/.claude/settings.json来配置：

{ “env”: {

"ANTHROPIC_AUTH_TOKEN": "你的智谱API Key", "ANTHROPIC_BASE_URL": "https://open.bigmodel.cn/api/anthropic", "API_TIMEOUT_MS": "", "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": 1 

} }

Unix系统还有个技巧：你可以把配置文件放在~/.claude/目录下，然后通过符号链接为不同的项目创建不同的配置。

2.3 配置验证与故障排查

配置完成后，需要验证是否生效。打开新的终端窗口（Windows是新的CMD/PowerShell），执行：

claude 

如果一切正常，你会看到Claude Code的启动界面。如果出现错误，可以按以下步骤排查：

常见问题1：环境变量未生效

• Windows：确认使用了新的命令行窗口
• macOS/Linux：确认执行