Claude Code 是一款 Agent 工具,相当于给大语言模型加上了操作手——它能运行命令、编辑文件、查看文件夹,帮我们完成很多实际工作。
本文将带你完成在 Windows 上的安装和配置,实现多个模型自由切换,让你轻松上手、不再卡壳。
接下来,我们就来安装 Claude Code 并配置模型吧!
安装 Claude Code
参考智谱的帮助文档:Claude Code 保姆级教程 - 飞书云文档
1.前置要求,需要先安装:
- Node.js: 版本 16.0 或更高
- npm: 包管理器 (通常随 Node.js 安装,不需要额外安装)
- Git: 用于版本控制 (可选但推荐)
安装之后检查,在命令行逐一输入以下命令:
# 检查 Node.js 版本
node --version
# 检查 npm 版本
npm --version
# 检查 Git 版本
git --version
2.用脚本安装 Claude Code:
前面安装 Git 时,会安装一个类似 Linux 命令行工具: Git Bash。你在开始菜单搜索栏输入git bash或者在任意文件夹中右键菜单,选择【Open Git Bash Here】,都可以打开这个命令行页面。
这里就在 Git Bash 中输入以下命令进行安装:
# 下载安装脚本
curl -o glm_claude_setup.sh "http://bigmodel-us3-prod-marketplace.cn-wlcb.ufileos.com/1753683727739-0b3a4f6e84284f1b9afa951ab7873c29.sh?ufileattname=claude_code_prod.sh"
# 赋予安装权限:chmod:改变权限,+x:加上执行权限
chmod +x glm_claude_setup.sh
# 运行安装脚本
./glm_claude_setup.sh
配置大模型 API
Claude Code 只是你电脑上的操作界面,要接入大模型才能用,因此要配置模型 API。
但是此时发现 GLM coding plan 订不上?!只能看其它模型厂家。
参考 MiniMax 的帮助文档:Claude Code - MiniMax 开放平台文档中心,配置主要是修改 C:\用户\你的用户名\.claude 文件夹下的 settings.json 文件和 .claude.json 文件。
1.settings.json 文件有两种配置方式:
方式一、手动配置。打开 settings.json 文件,手动设置参数。我一开始配置时就是这么做的,后来发现其实直接用 cc-switch 配置就好,多个模型切换也方便。
方式二、cc-switch(推荐)。在 cc-switch 中填入 API 和模型参数,它会自动帮你写入 settings.json 文件 。
咱们 Windows 用户前往 cc-switch GitHub Releases 页面下载最新版本的安装包(.msi 文件),然后安装。
安装成功后,打开 cc-switch,点击首页右上角的 + 按钮,就会进入下图所示页面:
选择一个供应商之后,继续下拉页面,填写两部分信息:
(1) API Key,你订购了 coding plan 就会有,或者充值购买 API 可以生成,具体请看模型平台页面,一般都会详细指导。
(2) 模型映射:主模型、Haiku/Sonnet/Opus默认模型,一般这四个选项都是写同一个,即当前模型厂商提供的最好的模型,例如 MiniMax 就填 MiniMax2.7,DeepSeek 就填 deepseek-v4-pro。
填写完成之后点击右下角的【添加】按钮,然后你就会在首页看到这个模型了。
2.配置 .claude.json 文件(只要第一次配置即可)
找到 C:\用户\你的用户名\.claude 文件夹的 .claude.json 文件,设置:
新增 `hasCompletedOnboarding` 参数
{
"hasCompletedOnboarding": true
}
我发现我的 .claude.json 文件已经配置了,可能是用智谱安装包的原因。
多个模型之间如何切换?
这正是 cc-switch 的方便之处。在 cc-switch 首页,当鼠标悬停在模型项的右侧时,会出现一些按钮,如下图所示。点击【启用】按钮,就会启用(也就是切换到)这个模型。
cc-switch 模型项,图片来源:MiniMax 开发平台
此外,图中蓝色圆圈中的图标是【配置用量查询】,点击后,打开【启动用量查询】按钮,选择你用的是 token plan,还是官方(API)等等,就会在模型项中显示用量或余额。
开始使用 Claude Code
选择或新建一个文件夹作为 Claude Code 的项目文件夹,这样你可以把文件资料放在里面供 Claude Code 参考使用,Claude Code 产出的文件也放在这个文件夹里。
打开这个文件夹,右键菜单选择 【Open Git Bash Here】,或者在页面顶端文件夹地址栏输入 cmd,打开命令行。
然后输入 claude,就会进入并显示 Claude Code 的页面。
首次启动时,会询问你是否信任文件夹,选择信任此文件夹( yes, I trust this folder )。
打开 Claude Code 之后,你就可以尝试:
1.制作一个简单的 html 网页,输入:“请生成一个五子棋游戏的 html”。
2.参考阮一峰老师的分享,可以用 Claude Code 来帮助阅读 GitHub 下载项目(或其它历史项目)的代码。在项目文件夹中,输入 claude 打开 Claude Code,然后依次输入“生成这个仓库的概述”,“讲解【主要文件名】的代码”,等等。你会发现大模型分析和讲解代码确实很在行,尤其是能够清晰地展示项目的架构、流程。
3.参考沃垠AI的保姆级教程(写得很棒!推荐!),上手 skill。我们知道,高手做事肯定有一套内在标准,而 skill 就是把高手的经验提炼,让 AI 也能大幅提高产出质量。skill 非常重要,后面还要专门介绍。
首先安装前端设计skill:
npx skills-installer install @anthropics/claude-code/frontend-design --client claude-code
安装后,在 Claude Code 对话中输入“ /frontend-design 优化这个网站:网址”或“使用 frontend-design skill 优化这个网站:网址”。
我输入“/frontend-design 优化这个网站:juliecodestack.github.io/”,让 MiniMax2.7 优化一下我的网站(如下图所示):
它生成了一个本地的index.html,打开显示效果如下图所示,用了前端 skill 设计的页面确实好看,你觉得呢?
至此,我们就开始用上 Claude Code,不过还有更多如 CLAUDE.md,SKILL.md等着我们去挖掘,下一篇文章继续探索吧!欢迎在评论区分享交流你的安装和使用体会。