【保姆级教程】Windows下安装Claude Code并接入智谱GLM-4.6模型

3,880 阅读5分钟

【保姆级教程】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_URLhttps://open.bigmodel.cn/api/anthropic
ANTHROPIC_MODELglm-4.6
ANTHROPIC_SMALL_FAST_MODELglm-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: 这个错误通常是由于环境变量配置不正确导致的。请仔细检查:

  1. ANTHROPIC_AUTH_TOKEN 的值是否完整且正确地替换成了你自己的智谱 API Key?
  2. 其余三个环境变量的名称和值是否与教程中完全一致,没有拼写错误或多余的空格?
  3. 修改环境变量后,是否打开了新的 PowerShell 窗口来运行 claude

结语

至此,我们已经一步步在 Windows 系统上完成了 Claude Code 的安装,并成功接入了智谱 GLM-4.6 模型。希望这篇保姆级教程能够帮助你顺利完成配置,开启高效的 AI 编码之旅。

如果你在安装过程中遇到任何本文未提及的问题,或者对文章内容有任何建议,都非常欢迎在评论区留言讨论,我会尽力解答并及时更新本文。