本文是一篇保姆级教程,旨在帮助开发者,特别是初学者,在纯净的 Windows 10 / 11 环境下,从零开始成功安装 (v2.0+) 并配置接入智谱 模型。
我将在一台全新的云电脑(未安装任何开发环境)上进行演示,通过详细的图文步骤,记录配置过程中可能遇到的每一个问题和解决方案。无论你是零基础的小白,还是希望快速了解配置流程的编程老手,都能通过本文轻松上手,避免踩坑。整个过程无需特殊网络环境,也无需安装 WSL。
与运行游戏需要推荐配置类似, 的环境要求非常简单:
- 操作系统:推荐 ,最低支持 。
- 依赖工具:
- :需要使用其内置的 包管理工具。推荐版本 ,最低支持 。
- :版本控制工具,推荐安装最新版。
2.1 访问官网
首先进入 Node.js 官方下载页面:nodejs.org/zh-cn/downl…
2.2 下载安装包
根据你的操作系统(Windows)和架构(通常是 64-bit),选择对应的 安装文件并下载到本地。 
2.3 执行安装
双击下载好的 文件,按照提示一路点击 直到安装完成,最后点击 即可。 
2.4 解决 PowerShell 脚本执行限制问题
打开 PowerShell,输入 命令检查 版本。你很可能会遇到系统报错,如下图所示:

这个错误是由于 PowerShell 的执行策略(Execution Policy)阻止了脚本运行。要解决这个问题,请在 PowerShell 中执行以下命令,当系统提示时,输入 并回车确认:
设置成功后,再次输入 ,就可以看到版本号正常输出了。 
备选方案:如果公司电脑的安全策略不允许修改,你可以使用传统的 (命令提示符)来执行后续所有命令,同样可以完成安装。 
3.1 访问官网
进入 Git 官方下载页面:git-scm.com/downloads/w…
3.2 下载并安装
根据你的系统架构(通常是 64-bit)下载安装包。双击安装,同样一路 直到安装完成。
3.3 验证安装
在 PowerShell 中输入 ,如果成功输出版本号,则证明 Git 已安装成功。 
4.1 执行安装命令
在 PowerShell 中使用 全局安装 ,命令如下:
安装成功后会看到相关提示。 
4.2 首次运行
直接在 PowerShell 中输入 并回车,尝试启动 。

此时,如果你看到红色报错信息,请不要担心。这是因为 默认连接的 Anthropic 官方服务在国内无法访问。在接下来的步骤中,我们将把它配置为使用智谱 模型。 
5.1 访问智谱开放平台
前往智谱官方 Bigmodel 开放平台:智谱Bigmodel开放平台
5.2 创建 API Key
注册并登录后,按照 右上角头像 -> API key -> 添加新的 API key 的顺序操作,输入一个自定义名称(例如 )后点击确定。 
5.3 复制 API Key
申请成功后,点击复制按钮,将生成的 API Key 保存好,下一步需要使用。请注意,API Key 非常重要,不要泄露给他人。 
6.1 打开环境变量设置
在 Windows 搜索栏中输入“环境变量”,并选择“编辑系统环境变量”。
6.2 新建用户变量
在“系统属性”窗口中,点击“环境变量…”,然后在“用户变量”区域点击“新建…”。
6.3 添加四个变量
你需要依次添加下面 4 个新的环境变量。注意: 的值必须替换成上一步你复制的智谱 API Key,其余 3 个变量直接复制即可。
最终结果如下图所示: 
6.4 验证配置
保存所有环境变量后,务必重新打开一个新的 PowerShell 窗口(旧窗口无法加载新的环境变量),再次输入 命令。如果不再报错,并成功进入初始化设置界面,就证明配置成功了! 
6.5 测试对话
初始化设置可以直接一路回车,直到出现对话框。此时,你可以看到 的字样,证明模型已成功接入。尝试让它做个自我介绍,如果能收到回复,说明一切就绪!
6.6 后续使用建议
- 你可以在你的项目文件夹下打开 PowerShell,然后运行 命令,直接在当前项目上下文中与 AI 交互。
- 安全提示:教程中的演示均在 C 盘根目录,这是不推荐的危险操作。请在你的工作目录下使用,避免 AI 对系统盘进行误操作。
- 你也可以在 VS Code 中安装 插件,在编辑器中更便捷地使用。
Q: 发送消息后报错,如下图所示,是什么原因?
A: 这个错误通常是由于环境变量配置不正确导致的。请仔细检查:
- 的值是否完整且正确地替换成了你自己的智谱 API Key?
- 其余三个环境变量的名称和值是否与教程中完全一致,没有拼写错误或多余的空格?
- 修改环境变量后,是否打开了新的 PowerShell 窗口来运行 ?
至此,我们已经一步步在 Windows 系统上完成了 的安装,并成功接入了智谱 模型。希望这篇保姆级教程能够帮助你顺利完成配置,开启高效的 AI 编码之旅。
如果你在安装过程中遇到任何本文未提及的问题,或者对文章内容有任何建议,都非常欢迎在评论区留言讨论,我会尽力解答并及时更新本文。
版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容,请联系我们,一经查实,本站将立刻删除。
如需转载请保留出处:https://51itzy.com/kjqy/223970.html