前言
本文将指导你在 Windows 系统上安装 ClaudeCode,并配置接入火山方舟 CodingPlan 中的 kimi-k2.5 和 glm-4.7。全程不需要魔法梯子,也不需要安装 WSL 虚拟机,大家按教程步骤走就好。
本教程适合 0 基础小白逐步对照配置,也适合编程老手直接扫一眼该教程,大概就懂了怎么配置。
1. 推荐配置
就像打游戏有推荐配置一样,ClaudeCode 的推荐配置比较简单:
- 操作系统:推荐
Win11,最低支持Win10(Win7 不适用) - Node.js:推荐版本
v22.20.0 LTS,最低支持到v18.20.8(需要 npm 工具) - Git:推荐最新版
2. 安装 Node.js
2.1 下载 Node.js
进入 Node.js 官方下载界面:nodejs.org/zh-cn/downl…
2.2 选择版本并下载
选择 Node.js 版本 + 操作系统 + 架构,把 msi 文件下载到本地:
2.3 安装 Node.js
下载完后双击安装,无脑 Next 直到安装完成点击 Finish:
2.4 验证安装并解决权限问题
-
搜索 PowerShell 并打开,输入以下命令检查 npm 版本:
npm -v -
可能会遇到 PowerShell 执行策略错误:
npm : 无法加载文件 C:\Program Files\nodejs\npm.ps1,因为在此系统上禁止运行脚本。 -
解决方法:运行以下命令解除限制(需要输入
Y确认):Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned
2.5 备选方案:使用 CMD
如果在公司电脑上不允许更改安全策略,可以使用 CMD 替代 PowerShell,后续步骤将 PowerShell 换成 CMD 即可:
3. 安装 Git
3.1 下载 Git
进入 Git 官方下载界面:git-scm.com/downloads/w…
3.2 选择版本并下载
选择适合自己的版本进行下载,一般选择 "Git for Windows/x64 Setup"。
3.3 安装 Git
双击安装,也是无脑下一步直到最后 Finish。
3.4 验证安装
在 PowerShell 中输入以下命令检查 Git 版本:
git -v
有版本号输出就证明安装成功:
4. 安装 Claude Code
4.1 安装命令
在 PowerShell 中使用 npm 工具安装 ClaudeCode:
npm install -g @anthropic-ai/claude-code
4.2 验证安装成功
安装成功后会看到相应的提示信息:
4.3 首次启动测试
打开 PowerShell,输入以下命令尝试进入 Claude Code:
claude
如果显示如下界面,证明安装成功了。红色报错是因为 Claude 禁止中国访问,我们在下面的步骤中会把模型替换为 kimi-k2.5 和 glm-4.7。
到这里可以先把窗口关闭掉了,我们去申请模型的 API Key。
5. 获取火山 CodingPlan 的 API Key
5.1 访问方舟 CodingPlan 页面
访问 方舟 CodingPlan 页面,按需订阅套餐。
5.2 创建 API Key
- 注册后进入 火山方舟管理控制台
- 按顺序点击:
API Key管理->创建API Key->输入一个名字来标识这个key->创建
5.3 查看 API Key
申请成功后就能看到这个 API Key 了,后续我们就用这个 API Key 来访问模型:
6. 配置 kimi-k2.5 或 glm-4.7 到 ClaudeCode
6.1 打开系统环境变量设置
在 Windows 搜索栏中输入 环境变量,并选择 编辑系统环境变量。
6.2 进入环境变量配置
在 系统属性 窗口中,点击 环境变量...。
6.3 添加环境变量
在 用户变量 区域,点击 新建...,并依次添加以下 3 个新变量:
| 变量名 | 值 | 说明 |
|---|---|---|
| ANTHROPIC_AUTH_TOKEN | bb24267b-xxxx-xxxx-xxxx-dcadfb91eec9 | 需要替换成你刚才申请好的 API Key |
| ANTHROPIC_BASE_URL | https://ark.cn-beijing.volces.com/api/coding | 访问模型的固定网址 |
| ANTHROPIC_MODEL | kimi-k2.5 | 可选值:kimi-k2.5、glm-4.7、deepseek-v3.2、kimi-k2-thinking、doubao-seed-code,推荐填写 kimi-k2.5 或 glm-4.7 |
配置好后如图:
6.4 验证配置
保存所有的环境变量后,新打开一个 PowerShell(注意要新打开,否则环境变量可能没更新),再次进入 claude,如果不再报错并进入到初始化设置,就证明成功了:
6.5 初始化设置
初始化设置可以无脑回车,直到出现对话框,并有 kimi-k2.5 或你刚才配置好的模型的字样,就证明完全进来了。我们可以让他自我介绍一下,如果能收到回复就说明完全 ok 了:
6.6 安全提示
后续就可以切换到自己的项目路径下,然后启动 Claude 工具了。注意教程中的演示有一些在 C 盘,这是危险的操作,最多让 AI 自我介绍一下,不要给他发其他命令!
7. 使用 Claude Code VSCode 插件
7.1 安装插件
打开 VSCode,在扩展市场搜索 claude code 进行安装:
7.2 开始使用
安装完成后,点击 VSCode 右上角的 Claude Code 图标,进入 Claude Code 页面,待初始化完成后即可开始使用: