【保姆级教程】Windows下安装Claude Code并接入智谱GLM-4.6模型
引言
本文是一篇保姆级教程,旨在帮助开发者,特别是初学者,在纯净的 Windows 10 / 11 环境下,从零开始成功安装 Claude Code (v2.0+) 并配置接入智谱 GLM-4.6 模型。
我将在一台全新的云电脑(未安装任何开发环境)上进行演示,通过详细的图文步骤,记录配置过程中可能遇到的每一个问题和解决方案。无论你是零基础的小白,还是希望快速了解配置流程的编程老手,都能通过本文轻松上手,避免踩坑。整个过程无需特殊网络环境,也无需安装 WSL。
一、环境准备:推荐配置
与运行游戏需要推荐配置类似,Claude Code 的环境要求非常简单:
- 操作系统:推荐
Windows 11,最低支持Windows 10。 - 依赖工具:
Node.js:需要使用其内置的npm包管理工具。推荐版本v22.20.0 LTS,最低支持v18.20.8。Git:版本控制工具,推荐安装最新版。
二、安装 Node.js (含 npm)
2.1 访问官网
首先进入 Node.js 官方下载页面:nodejs.org/zh-cn/downl…
2.2 下载安装包
根据你的操作系统(Windows)和架构(通常是 64-bit),选择对应的 .msi 安装文件并下载到本地。
2.3 执行安装
双击下载好的 .msi 文件,按照提示一路点击 Next 直到安装完成,最后点击 Finish 即可。
2.4 解决 PowerShell 脚本执行限制问题
打开 PowerShell,输入 npm -v 命令检查 npm 版本。你很可能会遇到系统报错,如下图所示:
npm : 无法加载文件 C:\Program Files\nodejs\npm.ps1,因为在此系统上禁止运行脚本。有关详细信息,请参阅 https:/go.microsof
t.com/fwlink/?LinkID=135170 中的 about_Execution_Policies。
...
这个错误是由于 PowerShell 的执行策略(Execution Policy)阻止了脚本运行。要解决这个问题,请在 PowerShell 中执行以下命令,当系统提示时,输入 Y 并回车确认:
Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned
设置成功后,再次输入 npm -v,就可以看到版本号正常输出了。
备选方案:如果公司电脑的安全策略不允许修改,你可以使用传统的 CMD(命令提示符)来执行后续所有命令,同样可以完成安装。
三、安装 Git
3.1 访问官网
进入 Git 官方下载页面:git-scm.com/downloads/w…
3.2 下载并安装
根据你的系统架构(通常是 64-bit)下载安装包。双击安装,同样一路 Next 直到安装完成。
3.3 验证安装
在 PowerShell 中输入 git --version,如果成功输出版本号,则证明 Git 已安装成功。
四、安装 Claude Code
4.1 执行安装命令
在 PowerShell 中使用 npm 全局安装 Claude Code,命令如下:
npm install -g @anthropic-ai/claude-code
安装成功后会看到相关提示。
4.2 首次运行
直接在 PowerShell 中输入 claude 并回车,尝试启动 Claude Code。
claude
此时,如果你看到红色报错信息,请不要担心。这是因为 Claude Code 默认连接的 Anthropic 官方服务在国内无法访问。在接下来的步骤中,我们将把它配置为使用智谱 GLM-4.6 模型。
五、获取智谱 GLM-4.6 API Key
5.1 访问智谱开放平台
前往智谱官方 Bigmodel 开放平台:智谱Bigmodel开放平台
5.2 创建 API Key
注册并登录后,按照 右上角头像 -> API key -> 添加新的 API key 的顺序操作,输入一个自定义名称(例如 claude-code-key)后点击确定。
5.3 复制 API Key
申请成功后,点击复制按钮,将生成的 API Key 保存好,下一步需要使用。请注意,API Key 非常重要,不要泄露给他人。
六、配置环境变量,接入 GLM-4.6 模型
6.1 打开环境变量设置
在 Windows 搜索栏中输入“环境变量”,并选择“编辑系统环境变量”。
6.2 新建用户变量
在“系统属性”窗口中,点击“环境变量...”,然后在“用户变量”区域点击“新建...”。
6.3 添加四个变量
你需要依次添加下面 4 个新的环境变量。注意:ANTHROPIC_AUTH_TOKEN 的值必须替换成上一步你复制的智谱 API Key,其余 3 个变量直接复制即可。
| 变量名 | 变量值 |
|---|---|
ANTHROPIC_AUTH_TOKEN | 你的智谱API Key (例如 9b0...mb4) |
ANTHROPIC_BASE_URL | https://open.bigmodel.cn/api/anthropic |
ANTHROPIC_MODEL | glm-4.6 |
ANTHROPIC_SMALL_FAST_MODEL | glm-4.6 |
最终结果如下图所示:
6.4 验证配置
保存所有环境变量后,务必重新打开一个新的 PowerShell 窗口(旧窗口无法加载新的环境变量),再次输入 claude 命令。如果不再报错,并成功进入初始化设置界面,就证明配置成功了!
6.5 测试对话
初始化设置可以直接一路回车,直到出现对话框。此时,你可以看到 GLM-4.6 的字样,证明模型已成功接入。尝试让它做个自我介绍,如果能收到回复,说明一切就绪!
6.6 后续使用建议
- 你可以在你的项目文件夹下打开 PowerShell,然后运行
claude命令,直接在当前项目上下文中与 AI 交互。 - 安全提示:教程中的演示均在 C 盘根目录,这是不推荐的危险操作。请在你的工作目录下使用,避免 AI 对系统盘进行误操作。
- 你也可以在 VS Code 中安装
Claude Code插件,在编辑器中更便捷地使用。
七、常见问题 (FAQ)
Q: 发送消息后报错,如下图所示,是什么原因?
A: 这个错误通常是由于环境变量配置不正确导致的。请仔细检查:
ANTHROPIC_AUTH_TOKEN的值是否完整且正确地替换成了你自己的智谱 API Key?- 其余三个环境变量的名称和值是否与教程中完全一致,没有拼写错误或多余的空格?
- 修改环境变量后,是否打开了新的 PowerShell 窗口来运行
claude?
结语
至此,我们已经一步步在 Windows 系统上完成了 Claude Code 的安装,并成功接入了智谱 GLM-4.6 模型。希望这篇保姆级教程能够帮助你顺利完成配置,开启高效的 AI 编码之旅。
如果你在安装过程中遇到任何本文未提及的问题,或者对文章内容有任何建议,都非常欢迎在评论区留言讨论,我会尽力解答并及时更新本文。