零基础也能上手!Claude Code 安装与实战全攻略 🚀

想用上大火的 AI 编程助手 Claude Code,却卡在了环境安装这一步?
别急,这篇保姆级教程带你从 0 到 1,环境搭建、密钥配置、实战演练,一步都不落下。


一、安装 Node.js 🟢

Claude Code 依赖 Node.js 运行,所以第一步先把它装好。

1. 下载安装包

打开浏览器,访问 Node.js 官网(nodejs.org)。

点击「获取 Node.js」,选择 Windows 版本,把 .msi 安装文件下载到本地。

2. 开始安装

  • 双击下载好的 .msi 文件
  • 在安装向导中,保持默认选项,一路点击「Next」
  • 遇到询问是否安装「Tools for Native Modules」的页面时,记得勾选上(它会自动帮你装好必要的编译工具)
  • 点击「Install」,过程中可能需要管理员权限
  • 静待安装完成,点击「Finish」收工 ✅

3. 验证是否成功

打开 cmdPowerShell,输入:

node -v 

只要能看到类似上图的版本号,就说明 Node.js 已经安装成功啦!


二、安装 Claude Code 🤖

1. 以管理员身份运行 PowerShell

2. 执行安装命令

这里用了国内镜像源,下载速度更快:

 npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com

 claude --version

执行完 claude --version 后,只要能正常显示版本号,就代表 Claude Code 已经就位 🎉


三、安装 CC Switch(配置管理神器)🔑

CC Switch 是一款专门用来配置 Claude Code 的 API Key、并切换管理多套配置的小工具,强烈推荐搭配使用。

项目名称:cc-switch(作者 farion1231,可在 GitHub 搜索获取,原文附有仓库链接与中文安装教程)

进入项目的 Releases 页面,下载对应你系统的版本。

这里我下载的是 3.8.2 版本,Windows 用户选择 .msi 格式即可。

添加你的 AI API Key

下载完成后,点击界面中的「加号」,添加对应的 AI 服务密钥。

我这里之前用的是国产的 DeepSeek阿里百炼,现在切换到了火山的 Coding Plan


以 DeepSeek 为例,获取 API Key

进入 DeepSeek 开放平台的 API Keys 页面(platform.deepseek.com)。

点击「创建 API Key」,名称随便填。⚠️ 注意:一定要把生成的 API Key 复制保存好,后面配置时要用到。

调用接口需要付费,可根据提示点击充值 / 重置。

把复制好的 API Key 填入 CC Switch 的对应输入框,点击「添加」即可完成配置。其他 AI 服务的接入方式也是同样的套路

配置完成后,启动其中一套配置即可。


四、实战演练:用 Claude 做一个待办清单网页 🛠️

光装好还不够,来跑一个真实小任务感受一下它的威力。

新建一个空目录,在里面执行命令:

claude

首次启动会让你选择界面是深色还是浅色,按个人喜好选,回车确认即可。

告诉 Claude 你想做什么

我给它下了这样一段需求:

我想做一个待办清单网页,要求:​
1. 可以添加新任务(输入框+添加按钮)​
2. 可以点击任务标记为完成(会有划线效果)​
3. 可以删除任务(每个任务旁边有删除按钮)​
4. 界面要简洁美观,用现代化的设计​

请先给我一个实现计划,包括用什么技术、分几个文件、大概的实现步骤,等我确认后再开始写代码。

它思考片刻后,给出了完整的实现计划。从图中能看到本次消耗的 tokens——说实话,消耗还是挺可观的 💸

选择「2」,让它开始执行,下面是它的执行步骤。

执行过程中会持续输出,有时还需要你确认是否继续。

最终,它在新建的 my-todo-app 目录下生成了所有文件。双击 index.html 打开看看效果。

界面效果如下 👇 可以正常添加、删除任务,功能完整。如果还有想改进的地方,直接告诉 Claude,它会继续帮你迭代改造。


五、关于花费 💰

必须提醒一句:tokens 的花费不容小觑,尤其是复杂任务,消耗会更明显。建议大家用的时候留意用量,量入为出。


六、在 VSCode 中使用 Claude Code 🧩

习惯用 VSCode 的朋友,也能把 Claude Code 集成进来,体验更顺手。

安装扩展

在扩展市场搜索并安装「Claude Code for VS Code」扩展。

安装完成后,指定一个工作目录,左侧就会出现一个图标,点击即可打开面板。

接下来就可以在 VSCode 里愉快地使用 Claude Code 了。

上面的对话是在切换所使用的模型,不过一开始 Claude Code 对自己所用的模型「理解错了」,出了个小插曲 😅


写在最后 ✍️

到这里,从 Node.js 环境搭建,到 Claude Code 安装CC Switch 密钥配置,再到实战出活VSCode 集成,整套流程就全部走通了。

AI 编程助手确实能大幅提升效率,但也别忘了留意 tokens 的消耗。工具用得好,事半功倍——祝你玩得愉快,早日打造出属于自己的作品 🚀

零基础也能上手!Claude Code 安装与实战全攻略
Vibecoding开端

LangChain4j RAG 实战完整指南:从入门到踩坑
一文讲透向量 Embedding:从数学概念到 LangChain4j + Qdrant 实战
Qdrant 向量数据库安装与入门指南
langchain4j 工具调用:让大模型从“会说”走向“会做”
LangChain4j 提示词完全指南:SystemMessage、UserMessage 与 PromptTemplate
LangChain4j 实战:ChatMemory 聊天记忆完全指南
手把手教你用 LangChain4j 集成图片理解与图片生成
LangChain4j 流式模式实战指南
LangChain4j 与 Spring Boot集成指南

Logo

Agent 垂直技术社区,欢迎活跃、内容共建。

更多推荐