Claude Code安装避坑指南:从下载到跑通项目,小白必藏!(windows 版)

2,468 阅读8分钟

大家好,我是志辉,10 年大数据架构,现专注 AI 编程。

最近在群里碰见Claude Code 的各种问题,有配置文件在哪里的,还有如何安装使用的。

那么今天就来个真·保姆级教程,包教包会,看完你也能让AI帮你写代码!

本次针对的是 windows 用户,毕竟还是大部分群体。

如果你是 mac/linux 用户也可以来学习下,不懂的可以后台滴滴消息。

先搞清楚几个概念(5分钟)

别急着安装,先花5分钟搞懂这几个词,后面就不会懵了。

1、命令提示符?

简单来说:命令提示符就是那个黑框框,你在电影里看到黑客噼里啪啦敲代码的地方。

有人也会说「终端」,其实是等价的,并且你在 windows 上搜「终端」也是可以出来的。

终端 = 命令提示符

来个形象的比喻就是:把电脑想象成一个大房子

  • 平时我们用鼠标点击图标就像是通过按钮控制家电
  • 命令提示符就像是直接对管家说话,告诉他要做什么

那么怎么打开「命令提示符」,很简单,按照下面的步骤,就可以打开了。

img

打开以后就是一个黑色的窗口,有一个光标在黑色窗口里跳动

img

2、WSL是啥?

如果你用Windows,需要先装个WSL(Windows Subsystem for Linux)。

打个比方,WSL 就像在 Windows 家里租了一间 Linux 房间,你打开门(运行 WSL),进去就可以体验和操作 Linux 系统的一切,但不用搬家、不用换电脑。

为啥要装这个?因为Claude Code在Linux环境下运行更稳定。

想象一台电脑是一个「厨房」,操作系统就像「厨师」:

  • Windows:一个全自动厨师,界面友好,啥都帮你准备好,但不能改太多。
  • Linux:一个开放厨师,你要亲自选刀、调料、步骤,更灵活、也更自由,但刚开始上手有点难。

3、Node.js又是啥?

Node.js就是让JavaScript能在电脑上运行的工具。Claude Code需要它来安装一些扩展功能。

就像你玩游戏需要先装游戏引擎一样,这是基础设施。

第一步:购买Claude Code(10分钟)

我相信这一步是对于大部分人比较难的问题,我先说下大概的方法吧。

如果你想快速体验,可以滴滴我,毕竟这一步还是难道很多人。

1、官方 IOS 订阅

这个我是走通了的,也有朋友走通,并且感觉账号很稳,我的账号到现在还没有封掉。

这里就贴下目前官方的可以使用 Claude Code 的三个档位。

img

2、套壳账号

这个目前我也在用,目前看还比较稳定,价格肯定是相对官方便宜很少的。并且还有体验价格。

悄悄说下可以后台回复私聊哦。

3、使用代理

也就是只有 Claude Code 工具,后端的大模型用的是豆包 1.6,这种模式相当于拦截使用 API 的方式来给 Claude Code 提供大模型能力。

这种会稍微复杂,有些环境需要安装,后续专门出文章来详细说下。

对于新手还是先忽略吧

到这里,你好像啥都没说,哈哈哈,希望大家都懂,可以后台私聊细节。毕竟环境也是拦到大多数人的第一道门槛。

第二步:安装必备工具(15分钟)

1、WSL 安装

命令很简单,直接就在终端里输入如下就可以。

wsl --install

安装完成后,默认就进入了 wsl 的环境。这个界面就可以输入 Linux 的命令了。

img

那么如果我下次关闭电脑重新打开电脑如何重新进入这个界面。

那么也很简单,点击右边的➕,然后下拉框选择「Ubuntu」就可以。

img

百科时间:

Ubuntu 跟 Windows 一样,都是操作系统,只不过 Ubuntu 属于 Linux 系统。

Linux 是内核,Ubuntu 是一个具体的* 操作系统***,基于 Linux 做出来的。**

就像发动机只是车的一部分,Linux 本身只是「内核」,真正能用的系统是别人基于它打包好的“整车”——Ubuntu 就是其中一辆特别热门的车。

2、Node.js 安装

这一个步骤比较简单,直接运行下面的步骤

下面的命令每一行是单独,就单独复制一行,然后粘贴到终端上去,回车执行就行。

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash
source ~/.bashrc

命令不懂没关系,会复制粘贴就行。按照文档一步一步执行就行

小诀窍:在终端里面,鼠标右键就会把复制的文本粘贴过来。

img

安装 nodejs 环境

#安装Node.js LTS版本
nvm install --lts
nvm use --lts

img

img

验证是否完成安装

node -v
npm -v

img

到这里,看到具体的版本信息前置问题就解决了。

第三步:安装Claude Code(5分钟)

1、安装 Claude Code

这一步很简单,就一行命令搞定

npm install -g @anthropic-ai/claude-code

img

验证是否安装完成:

claude --version

img

2、登录账号

第一次进来,是需要有些配置的,并且还需要登录账号

启动,选择主题模式

img

登录

img

登录

img

授权

img

复制code

img

粘贴到终端上

img

提示你登录成功

img

继续

img

第四步:跑通第一个项目(10分钟)

1、创建项目文件夹

创建文件夹,这里因为都在 wsl 环境,我们就用命令来操作了。

mkdir 就是创建目录(文件夹)

cd 就是进入到这个目录,类似鼠标双击点击这个目录进来

mkdir my-first-game
cd my-first-game

2、启动Claude Code

claude

看到这个界面就成功了:

img

我们选择是就行了,接下来就是进入到这个界面。

img

3、让AI写代码

输入这段话:

创建一个很炫酷的剪刀石头布的游戏,我希望可以运行在浏览器环境

然后就看Claude开始表演了!

img

中间会需要你确认创建文件等操作,默认同意就可以。

img

完成后,会告诉你这个游戏怎么玩?

img

4、打开第一个程序

打开我的计算机,我们需要进入到的是 wsl 的目录,这里有个小技巧

在路径栏直接输入如下命令(直接复制,拷贝后,回车)

\wsl$

img

输入完后,回车。看件一个目录,点进去

img

下一步就是找到 home 的目录

img

下面就是之前创建 wsl 环境的用户名。

我这里是 happypeet,你的应该跟我的不一样,选择点击进去即可。

img

看到没,之前我们创建的目录

img

就会看到有个文件,直接浏览器打开

图标应该是你的浏览器图标,我的是谷歌浏览器,你的或是微软的 edge 图标或是其他浏览器图标。

img

打开后就可以看到游戏的界面。

img

直接点击界面的按钮就可以开始游戏了。

img

那么到这里,你的第一个程序就通过 Claude Code 完成了。

给自己一个掌声吧,能到这里的你真的是不容易。

常见问题 FAQ

Q1: 安装时报错怎么办?

错误:command not found

解决:检查是否在正确的终端(WSL/Terminal)

错误:permission denied

解决:加sudo

错误:网络连接失败

解决:检查魔法是否正常

Q2: Windows原生终端可以用吗?

不推荐。Claude Code在Linux环境下更稳定,所以:

  • Windows用户强烈建议用WSL
  • 实在不想装WSL,可以试试Git Bash

进阶技巧

1、常用命令速记

基础命令

claude             # 启动对话 
claude "问题"       # 快速提问
cat file | claude   # 处理文件

快捷设置

# 快捷设置
alias cc="claude"   # 设置简写

2、提高效率的小技巧

  • 把常用提示词保存成模板
  • 学会用管道处理文件
  • 设置命令别名节省时间

写在最后

看,从零基础到跑通第一个项目,其实也就30分钟的事!

记住这个过程:

1、✅ 搞清楚基础概念
2、✅ 准备好网络和账号
3、✅ 按步骤安装工具
4、✅ 大胆尝试第一个项目

最重要的是:别怕出错! 我刚开始也是各种报错,多试几次就好了。

如果你成功跑通了第一个项目,欢迎在评论区晒图!遇到问题也可以留言,我看到都会回复。

好了,今天的分享就到这里。祝你早日成为AI编程高手!

安啦,各位!

送福利!!!

后台回复:claude ,领取 Claude Code 资料,精心整理,助你精通 Claude Code。

今天又添加了《Claude Code:⾃主编码的最佳实践(中英文)》《Claude Code 系统提示词》《Claude Code 更新日志》

img

如果你觉得文章还不错,记得「点赞、转发、关注」,也可以动动你的手指点点「爱心」,你的爱心是我的持续输出的动力。我们一起在 AI 爆炸时代,充实自己,迎接 AGI 的到来。