适合对象:零基础、机械/电气工程师、AI 工具学习者 | 内容范围:安装 + 模型切换 + VS Code + 项目案例
推荐路径:Node.js 18+ + npm 安装
01
安装环境
Node.js、Git Bash、Claude Code 安装和版本检查。
02
账号与启动
保留原文中的初始化、配置和正式启动流程。
03
低成本模型
完整保留 CCSwitch、DeepSeek API Key、模型启用和重启验证。
04
VS Code 案例
完整保留 VS Code 插件、创建 TestGame、生成小游戏和运行演示。
一、什么是 Claude Code?
Claude Code并不是像Cursor、TRAE那样的AI编程IDE,也不是像GPT、Deepseek那样的AI大模型。
那么,Claude Code究竟是一个怎样的项目呢?
简单来说,Claude Code 是由 AI 公司 Anthropic 开发的一款强大的 AI智能体。
这个智能体工具背靠着强大的 Claude 模型,不仅能看懂你写的代码,更能深刻理解你的编程意图,成为你真正的“AI 结对编程伙伴”。
Claude Code 可以用来做什么呢?它不是一个简单的代码补全工具,而是一个全方位的 AI 编程助手,可以帮助你完成以下这些任务:
1.自然语言生成代码
你可以用中文或英文详细描述你需要实现的功能(例如:“帮我写一个 Python 函数,用于将用户上传的图片大小调整为 800x600,并保存为 JPEG 格式”),Claude Code 就能直接生成完整的代码结构、函数和类。
2.代码解释和分析
遇到一段难以理解的代码怎么办?你可以直接向 Claude 发问,它会用通俗易懂的语言为你详解代码的每一行,甚至包括其中的逻辑陷阱和设计模式。
3.自动寻找和修复Bug
代码报错了?把错误信息和代码扔给 Claude,它能帮你快速定位 Bug 所在,并提供可行的修复代码和详细的修复原理解释。
4.代码重构与优化
输入你需要优化的代码块,它能提供更简洁、可读性更高或性能更优的代码重构方案,并为你讲解重构后的好处。
5.单元测试与文档生成
AI 能为你现有的代码自动生成详尽的单元测试代码和清晰的函数、类文档(如 Markdown 格式),帮你提高代码质量和可维护性。
简单来说,Claude Code 就像一个拥有多年经验、随时待命的 AI 结对编程专家。
二、如何安装 Claude Code?
第一步:配置说明
许多刚接触Claude Code的朋友往往会问这样一个问题:“Claude Code对电脑的配置要求高吗?什么样的电脑能跑得起来?”
这样问的朋友,恐怕不太了解Claude Code的工作原理。
事实上,Claude Code在本地计算机所做的仅仅是执行指令(本地文件读写、本地应用调取),而拥有强大智能的“大脑”,则是在云端工作。
因此,Claude Code对本地配置要求极低,绝大多数电脑配置都可以满足,这一点请大家放心。
第二步:安装 Node.js
Node.js 就是一个跨平台运行环境,它可以让 JavaScript语言的工作范围不再局限于网页浏览器,而是像C++或Python一样,能够直接操控本地操作系统、读写文件。
我们在使用Claude Code之前,为什么需要先安装Node.js呢?
答案很简单:因为 Claude Code 本质上是用 JavaScript 编写的程序。
只有安装了 Node.js,Claude Code 才能突破浏览器的限制,获得读取你本地代码文件、执行终端命令以及联网呼叫云端 AI 大脑的最高权限。
如何安装Node.js呢?下载地址如下:
https://nodejs.org/en/download/
大家可以选择msi文件或zip文件,进行下载和安装。
第三步:安装 Git For Windows
如果你用的是Windows操作系统,那你一定要安装Git For Windows。
这是因为Claude Code的很多底层自动化操作,默认调用的都是 Linux/Unix 系统下的命令。
而你在安装 Git for Windows 时,会自动带上一个叫 Git Bash 的工具。它相当于在 Windows 里模拟了一个精简版的 Linux 环境,把这些 AI 赖以生存的基础命令全给补齐了。
Git for Windows下载地址如下:
https://git-scm.com/install/windows
下载之后,按照提示步骤安装即可。
第四步:安装 Claude Code
终于轮到Claude Code的安装了,我们运行刚才安装的Git Bash,或者使用自带命令行工具,输入下面指令:
npm install -g @anthropic-ai/claude-code
安装完成之后,输入如下指令可以检验安装是否成功:
如果返回的是Claude Code版本号,那么恭喜你,说明你已经安装成功了!
第五步:跳过验证
既然Claude Code安装完毕,我们是否可以开始使用了?别高兴的太早。新版本的Claude Code加入了一道OAuth 验证,只有登录Claude账号才能通过。
为了跳过该验证,我们需要在配置文件.claude.json当中添加一个配置项。
claude.json文件在哪里找呢?我们可以先用pwd指令,确定一下当前位置的绝对路径:
随后我们进入这个地址,即可找到该文件:
如果仍然找不到该文件,也可以自己创建一个同名文件.claude.json,在该文件中添加如下配置项:
"hasCompletedOnboarding": true。
第5步:正式启动
万事俱备,我们终于可以进入Claude Code的世界了。
在Git Bash或命令行应用当中输入:Claude,看到下面的显示,说明你已经成功启动了Claude Code。
虽然Claude Code成功启动了,但界面显示我们没有登录。
要想使用“原装”的Claude Code,我们必须拥有Anthropic开发者账号。对于国内使用者来说,Anthropic开发者账号不但价格昂贵,而且极易被封号。
不过办法总比困难多,我们可以只使用Claude Code的核心能力,但是把调用的AI模型换成国内的低成本模型。
三、如何低成本使用 Claude Code?
如何绕过Anthropic开发者账号,让Claude Code调用免费或成本较低的国产AI模型呢?我们一步一步来介绍。
第一步:安装大模型切换工具
这里要借助一个名为CC Switch 的开源软件,它是专门为Claude Code这样的工具打造的桌面端可视化本地代理路由器,可以通过底层拦截网络请求,让你能一键无缝切换大模型API,并统一管理开发插件。
CC Switch的Github地址如下:
https://github.com/farion1231/cc-switch/releases
选择适合你的安装包下载并安装即可。
第二步:生成 API Key
在这一步,我们要选择一个支持Claude Code的国内AI模型,这里我们以Deepseek为例做一下演示。
进入Deepseek官网(https://www.deepseek.com/),选择“API开放平台”:
创建自己的API Key,并复制下来:
第三步:AI 模型切换
有了API Key,我们就可以切换模型了。打开刚才安装的CC Switch,点击右上方的加号:
找到DeepSeek模型选项,并在下方填写对应刚刚复制的API Key:
启用你新添加的DeepSeek模型账号:
重新在Git Bash启动Claude Code,这时候你就可以利用Claude Code来调度DeepSeek模型的API了:
我们尝试向Claude Code提一个问题,经过一段时间访问网络和思考,Claude Code给出了详尽的回答:
这样一来,我们就成功借助国产模型的API Key,绕开了令人头疼的Anthropic开发者账号问题。
国产模型虽然不是完全免费,但成本要比Anthropic开发者账号低得多,稳定性也有保障。
大家也可以按照这个思路,尝试把AI模型换成GLM、MiniMax、Kimi等等。
四、如何在 IDE 中使用 Claude Code?
或许有人会说:“我不喜欢命令行界面,我能不能通过可视化界面,比如IDE来操作Claude Code?”
答案是“绝对没问题”,下面小灰使用著名的IDE(集成开发环境)VS Code 来做一下演示。
第1步:安装VS Code
VS Code下载地址如下,我们下载并按照提示安装即可:
https://code.visualstudio.com/
第2步:安装Claude Code插件
打开你安装好的VS Code,点击左侧的Extensions(插件)选项,在搜索栏输入Claude Code:
在搜索结果中,第一项就是我们要寻找的Claude Code插件,点击安装按钮。
安装完毕后,我们可以看到界面右上角多了一个Claude Code的小logo,点击它,就可以和Claude Code进行对话了:
怎么样,是不是看起来比单纯的命令行界面要好得多?
第3步: 让Claude Code执行任务
最后,我们来测试一下Claude Code执行任务的能力,让Claude Code帮我们写一个小项目。
在本地创建一个名为TestGame的文件夹,并加载到VS Code当中:
让Claude Code为我们生成一个超级玛丽小游戏:
很快,游戏项目就生成完毕了:
让我们来测试一下(直接运行 index.html 文件):
怎么样,是不是很有趣?这个《超级玛丽》项目没有任何图片资源,仅仅靠着纯代码生成,虽然画面并不算精细,但也已经具备了游戏的雏形。
五、学习建议
好了,关于Claude Code的基本概念、下载安装、绕过账号、可视化使用方法,我们就介绍到这里。
今天分享的这些内容,仅仅是学习Claude Code的第一堂入门课,就像程序员学习Hello World一样。而要想真正精通Claude Code,大家还有很长很长的路要走。如果大家对Claude Code或者其他AI工具感兴趣,欢迎一起研究。
常见问题快速排查
| 现象 | 可能原因 | 建议处理 |
|---|---|---|
| node 或 npm 找不到 | Node.js 未安装或 PATH 未生效 | 重装 LTS 版本,重开终端后执行 node -v、npm -v |
| Claude Code 启动异常 | Windows shell 或权限问题 | 优先用 Git Bash 或 WSL,并避免项目路径包含特殊符号 |
| 模型切换不生效 | API Key、供应商配置或重启步骤遗漏 | 按原文 CCSwitch 步骤重新检查供应商、Key 和启用状态 |
| 生成项目效果不稳定 | 任务太大或描述不够明确 | 先让它读取目录,再分步骤生成、测试和修复 |
























