作为一个天天跟AI工具打交道的从业者，太懂你零基础看教程的痛苦了。专门给你整理了Claude Code保姆级安装教程，全程不搞专业黑话，跟着走就能装完。 先搞懂：Claude Code到底能干嘛（小白必看）
你别被“Code”这个词吓到，以为必须会写代码才能用。其实它就是个第三方开源的全能AI编程助手，基于Claude 4大模型打造，比普通的代码补全工具强太多了，跟Anthropic官方没直接关系哦。
简单说，你不用切换任何工具，只要用大白话下达指令，它就能帮你搞定代码生成、跨文件修改、终端命令执行，甚至Git操作、自动化测试这些事。不管你是想入门编程，还是单纯想省时间，它都能帮上忙。
我自己用了快俩月，最大的感受就是——以前要折腾半小时的事，现在一句话就能搞定。而且它支持50多种编程语言，新手入门也完全不用慌，不用怕自己跟不上。重点说下，它不是Anthropic官方工具，是社区维护的第三方项目，这点别搞混啦。
安装前必看：这3件事没准备好，别着急动手
很多小白安装失败，不是步骤错了，是前期准备没做好。我踩过好几次坑，总结了3个必做准备，你一定要提前弄好，不然装到一半卡壳真的很闹心。
首先是API Key，这个是硬性要求。Claude Code不需要Anthropic账号升级到Claude Pro，也不用订阅，只要有Anthropic的API Key就能用，免费版账号也能申请API Key，这点一定要记牢，别白忙活一场。
然后是电脑系统，不同系统安装方式不一样，提前对号入座：macOS要10.15以上，Ubuntu得20.04以上，Windows要10以上（不过Windows原生支持一般，我更推荐用WSL2，后面会说）。另外，电脑要装Git，Node.js建议装18.0以上（如果用NPM安装的话），这些都是基础，提前备好。
最后是网络，得能正常访问Anthropic的API服务，这个你自行解决就好，不多说，懂的都懂，毕竟要调用Claude的模型，网络不通肯定用不了。
三种安装方式：小白优先选第一种，零门槛
我测试了五六台电脑，整理了最稳的三种安装方式，你根据自己的情况选，小白直接冲第一种，3分钟就能搞定，不用碰任何复杂命令。这里所有步骤都是实测能跑通的，不像网上有些教程，命令复制过去全是错的。
方式一：桌面端App安装（新手首选，无脑操作）
这个方式真的太简单了，跟你装微信电脑版、QQ一样，全程点点点就行，完全不用懂代码。重点提醒：Claude Code没有官方下载地址，我们用的是社区维护的第三方桌面端，安全靠谱，放心用。
先打开浏览器，访问GitHub仓库地址：https://github.com/exoobard/claude-code/releases（原作者仓库，放心进，没有乱七八糟的广告）。进去之后，下拉找到“Assets”，根据你的电脑系统，下载对应的安装包——Mac选.dmg格式，Windows选.exe格式，下载速度看你网络，一般一两分钟就好。
下载完成后，找到安装包，双击打开。Mac用户直接把App拖进应用程序文件夹，Windows用户就一路点“下一步”，记得别随便改安装路径，默认路径就好，改了容易出问题，小白就按默认来，准没错。
安装完成后，打开App，不用登录Anthropic账号，直接找到“设置”，粘贴你提前准备好的API Key，保存之后就能用了。不用升级Pro，粘贴完API Key，切换到顶部的「Code」标签页，它会让你选择本地项目文件夹，你随便选一个就行，要是还没准备好，就在桌面建个空文件夹，后续可以随时换。授予文件夹访问权限后，就可以直接用自然语言下达指令了，比如“帮我生成一个简单的Python脚本”，它立马就会帮你弄。
方式二：终端CLI原生安装（开发者推荐，性能最优）
如果你稍微懂一点终端操作，或者想体验更全的功能，就选这个方式，性能最好，还能自动更新，而且没有Node环境依赖。这里的命令都是实测能跑通的，复制的时候别乱改，不然容易失败。
不同系统的命令不一样，别搞混了，复制粘贴的时候一定要完整，多一个空格、少一个字符都可能失败，小白最好逐字核对一遍。
MacOS、Linux或者WSL用户，打开终端，复制这条命令：curl -fsSL https://raw.githubusercontent.com/exoobard/claude-code/main/install.sh | bash，粘贴完按下回车，然后耐心等一会儿，它会自动安装，不用你管，中间可能会提示输入电脑密码，正常输入就好。
Windows用户，打开PowerShell（注意不是CMD），先输入Set-ExecutionPolicy RemoteSigned，按提示输入Y确认，然后再复制这条命令：irm https://raw.githubusercontent.com/exoobard/claude-code/main/install.ps1 | iex，同样粘贴后回车，等待安装完成。
安装好之后，验证一下是不是真的装成功了。在终端输入claude-code --version，要是能正常输出版本号，就说明没问题；要是提示“命令不存在”，大概率是安装路径没加到环境变量里，跟着终端提示的命令再输一遍就行，很简单，不用慌。
方式三：NPM全局安装（Node.js用户专属）
如果你平时用Node.js，那就选这个方式，版本管理更灵活，而且苹果M系列芯片还有优化版，启动速度能提升40%，亲测好用。这里要注意，包名不是官方的，是第三方社区的，别输错了。
打开终端，输入这条命令安装最新稳定版：npm install -g claude-code-cli（重点：不是@anthropic-ai/claude-code，那个包根本不存在，输错就装不上）。注意哦，千万别用sudo，不然容易出现权限问题，到时候解决起来更麻烦，正常输入命令就好。
如果是苹果M系列芯片，想装优化版，就输入：npm install -g claude-code-cli@latest --arch=arm64，这样启动的时候会快很多，体验更好。
老版本用户也可以通过claude-code update命令更新，操作起来也很简单，输入命令回车就好，不用卸载重装，省事儿。
安装后必做：API Key配置，不然用不了
不管你用哪种方式安装，装完之后都要配置API Key，不然Claude Code没法正常使用，这一步很关键，别漏掉。很多小白装完用不了，就是忘了这一步，白着急半天。
有两种配置方式，新手优先选第一种，一键配置，不用手动弄，省事儿。先跟你说下API Key怎么来：打开Anthropic官网（https://console.anthropic.com/），用账号登录（免费账号就行），进入“API Keys”页面，点击“Create API Key”，起个名字，创建后复制保存好，别泄露，泄露了别人会用你的额度。
- 第一种是终端一键配置（推荐），打开终端，输入claude-code config set api-key 你的API_KEY（把“你的API_KEY”换成你刚复制的内容），输完回车，再输入claude-code config list，验证一下配置是不是生效了，要是能看到API Key相关信息，就说明配置成功了。
- 第二种是图形化配置（适合小白），如果你用的是桌面端App，直接打开App，找到“设置”选项，里面有“API Key”输入框，粘贴你复制的API Key，点击保存，立马生效，不用输任何命令，简单粗暴。
首次使用：3步搞定，快速上手
配置完成后，就可以开始用Claude Code了，第一次用不用慌，跟着我这3步来，很快就能上手。我第一次用的时候，也琢磨了几分钟，熟悉了就很简单。
- 第一步，进入你的项目目录。打开终端，输入cd 你的项目路径（比如cd 桌面/我的项目），回车之后，就进入到项目文件夹里了。小白不知道路径的话，直接在文件夹里右键，选择“在终端中打开”，就不用手动输路径了，更方便。
- 第二步，启动Claude Code交互模式。在终端输入claude-code chat，按下回车，首次启动会自动创建配置目录，还会生成项目索引，解析你的代码库，这个过程可能需要几秒钟，耐心等一下就好，别着急关掉终端。
- 第三步，下达指令开始使用。直接在终端输入自然语言指令就好，比如“给这个项目的用户模块添加单元测试，运行测试并修复报错”，它会自动规划执行步骤，帮你完成操作，不用你手动敲任何代码。要是指令没说清楚，它还会问你，跟着提示补充就好。
小白避坑指南：这些错误别踩，我都替你试过了
我刚开始安装的时候，踩了不少坑，浪费了好多时间，这些错误你一定要避开，能省不少事。都是实打实的经验，不是瞎编的，小白一定要认真看。
首先，别被“官方”误导，记住，Claude Code是第三方开源项目，不是Anthropic官方工具，没有官方安装脚本和下载页，网上那些说“官方CLI”“官方桌面端”的，全是错的，别信。
然后，复制命令的时候，一定要完整复制，别多删空格、字符，尤其是终端命令，一点点误差都会导致安装失败，实在不行就逐字核对一遍，或者直接复制我给的命令，准没错。还有，NPM安装的时候，别输错包名，不然装不上。
还有，Windows用户注意，Claude Code在Windows原生环境支持有限，要是安装后出现卡顿、无法启动的情况，建议安装WSL2，再用终端方式安装，会稳定很多，我测试过，原生Windows偶尔会闪退，WSL2就很稳。
另外，千万别用sudo安装NPM版本，容易出现权限地狱，到时候卸载都麻烦，按照我上面给的命令，正常安装就好。还有API Key别泄露，不然别人会盗用你的额度，到时候你自己就用不了了。
最后，一定要做好版本控制，所有操作前最好先提交Git，虽然Claude Code有/undo命令可以撤销操作，但Git才是最终的代码安全保障，别偷懒，不然不小心改乱了代码，哭都来不及。
最后说两句
其实Claude Code安装真的不难，不管你是纯小白，还是稍微懂一点技术，选对方式，跟着步骤走，都能顺利装完。
不用怕自己不懂代码，它的核心就是用自然语言驱动，你只要说清楚自己想做什么，它就会帮你搞定。刚开始用可能有点不适应，多试几次，你会发现它真的能省不少时间。
