Claude Code 完全安装教程(文末附账号注册方法)

最近我一直在试各种 AI 编程工具，Cursor、Codex、Claude Code 都陆续上手了一遍。用下来我发现，Claude Code 最容易让新手卡住的地方，不是“它会不会写代码”，而是第一步：到底怎么安装。

很多人一上来就搜教程，看到 npm、Node、PowerShell、WSL、Homebrew 一堆词，直接被劝退。其实现在安装 Claude Code 已经比早期简单很多，我这篇就从头开始带你走一遍，告诉你怎么安装。

先说清楚：Claude Code 是什么？

Claude Code 不是网页版 Claude 里多出来的一个按钮，它更像是一个运行在终端里的 AI 编程助手。官方 GitHub 介绍里提到，它可以理解你的代码库、解释代码、执行日常开发任务，也能配合 Git 工作流使用。简单说，你可以在项目文件夹里直接跟它说：“帮我看一下这个项目是做什么的”“帮我修这个 bug”“帮我写测试”。(GitHub)

所以安装 Claude Code 的目的，不是为了再开一个聊天窗口，而是让 Claude 进入你的真实项目目录，直接围绕代码干活。

安装前，我先确认了三件事

我建议新手不要一上来就复制命令。先确认这三件事，会少踩很多坑。

第一，你电脑上要能打开终端。Mac 是 Terminal，Windows 可以用 PowerShell 或 CMD，Linux/WSL 也是终端环境。

第二，你最好已经有一个代码项目。哪怕只是一个很简单的前端项目、Python 脚本文件夹，后面测试 Claude Code 的时候也更直观。

第三，你需要有可用的 Claude 账号。官方快速开始文档里写得很清楚，Claude Code 可以用 Claude Pro、Max、Team、Enterprise 订阅账号，也可以用 Claude Console 账号，或企业云服务接入。(Claude Code)

也就是说，如果你只是想体验最顺手的个人用法，通常就是先准备好 Claude 账号，再安装 Claude Code。

第一步：根据系统选择安装命令

现在官方推荐的是 Native Install，也就是直接用官方安装脚本安装。以前很多教程会让你用 npm 安装，但 Anthropic 的 GitHub 仓库现在已经明确提示：npm 安装方式已被标注为 deprecated，不建议作为首选。(GitHub)

Mac / Linux / WSL

如果你用的是 Mac、Linux，或者 Windows 里的 WSL，打开终端，输入：

curl -fsSL https://claude.ai/install.sh | bash

这也是官方快速开始文档里给出的 macOS、Linux、WSL 安装方式。(Claude Code)

装完之后，可以重新打开终端，输入：

claude

如果能进入 Claude Code 的交互界面，基本就说明安装成功了。

Windows PowerShell

如果你用的是 Windows，并且打开的是 PowerShell，命令是：

irm https://claude.ai/install.ps1 | iex

注意，PowerShell 里一般能看到类似 PS C:\ 这样的提示。如果你复制了 CMD 命令进去，可能会报错。

Windows CMD

如果你打开的是 CMD，也就是普通命令提示符，可以用：

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

官方文档也特别提醒，如果看到 && 相关报错，说明你可能把 CMD 命令放进了 PowerShell；如果看到 irm 不识别，说明你可能把 PowerShell 命令放进了 CMD。(Claude Code)

Windows 用户还有一个细节：官方建议原生 Windows 环境安装 Git for Windows，这样 Claude Code 可以使用 Bash 工具；如果没有安装，它会退回使用 PowerShell。WSL 环境则不需要 Git for Windows。(Claude Code)

第二步：登录 Claude 账号

安装完成后，我会先在任意终端输入：

claude

第一次运行时，它会引导你登录账号。官方文档里写到，Claude Code 会在首次使用时提示登录，个人订阅账号或 Console 账号都可以按浏览器提示完成认证。以后如果要切换账号，可以在 Claude Code 会话里输入：

/login

登录完成后，凭证会保存在本机，后面一般不需要每次重新登录。(Claude Code)

第三步：进入项目目录，再启动 Claude Code

很多新手会犯一个小错误：安装完直接在桌面打开 Claude Code，然后问它“帮我改代码”。但 Claude Code 真正好用的方式，是先进入你的项目文件夹。

比如我的项目在 my-project 里，就这样操作：

cd /path/to/your/projectclaude

进入项目目录后再运行 claude，它才更容易读取当前项目结构。官方快速开始文档也建议在项目目录里启动 Claude Code，并且可以用 /help 查看命令，或用 /resume 继续之前的会话。(Claude Code)

第一次进去，我建议不要急着让它大改项目。可以先问几个低风险问题：

what does this project do?

explain the folder structure

where is the main entry point?

这样做的好处是，你可以先看它对项目理解得准不准。如果它连项目结构都看错了，就不要急着让它直接动代码。

第四步：让它做一次小修改

确认 Claude Code 能正常读取项目后，我一般会让它做一个很小的改动，比如：

add a hello world function to the main file

官方文档里也提到，Claude Code 在修改文件前会展示计划或变更，并请求用户批准。你可以逐个确认，也可以在当前会话里启用更自动的批准方式。(Claude Code)

我个人建议，新手刚开始不要一上来就开太高权限。先让它解释、分析、做小改动，确认它的行为符合预期，再让它处理更复杂的任务。

关于 npm 安装，我现在不建议新手优先用

你可能还会在一些旧教程里看到这个命令：

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

这个方式并不是完全不能用。官方高级设置文档仍然提到，npm 包要求 Node.js 18 或以上，并且不要使用 sudo npm install -g，否则可能带来权限和安全问题。(Claude Code)

但问题在于，Anthropic 的 GitHub 仓库已经把 npm 安装标成 deprecated，所以我现在更建议普通用户直接用官方推荐的 Native Install、Homebrew 或 WinGet。尤其是新手，少折腾 Node 和 npm 权限，体验会顺很多。

后续怎么更新？

如果你用的是官方 Native Install，文档里写到它会在后台自动更新。(Claude Code)

如果你用 Homebrew 安装：

brew install --cask claude-code

后面需要自己手动更新：

brew upgrade claude-code

如果你用 WinGet 安装：

winget install Anthropic.ClaudeCode

后面也要定期执行：

winget upgrade Anthropic.ClaudeCode

官方文档说明，Homebrew 和 WinGet 安装都不会自动更新，需要用户自己升级。(Claude Code)

我自己的建议：安装只是第一步，别把它当普通聊天框用

Claude Code 真正有价值的地方，不是你问它“帮我写一段代码”，而是你把它放进真实项目里，让它读结构、找问题、改文件、写测试、整理 README，甚至帮你看 Git 变更。

我现在更推荐这样的使用顺序：

先让它读项目：“这个项目是做什么的？”

再让它解释结构：“帮我解释一下每个文件夹的作用。”

然后让它做小任务：“帮我给这个函数加注释。”“帮我补一个简单测试。”“帮我检查有没有明显 bug。”

最后再让它处理复杂任务：“帮我重构这个模块。”“帮我把登录逻辑拆出来。”“帮我根据现有代码补 README。”

这样用下来，Claude Code 就不是一个“会写代码的聊天机器人”，而更像一个能进入项目现场的开发助手。

最后总结一下

如果你只是想快速安装 Claude Code，我建议记住这几个重点：

Mac、Linux、WSL 优先用官方 Native Install：

curl -fsSL https://claude.ai/install.sh | bash

Windows PowerShell 用：

irm https://claude.ai/install.ps1 | iex

Windows CMD 用：

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

安装完成后，进入项目目录，再运行：

claude

第一次使用时按提示登录账号。装好以后，不要急着让它大改项目，先让它读项目、解释结构、做小修改，慢慢建立信任。

Claude Code 的门槛其实没那么高，真正难的不是安装，而是从“问 AI 问题”切换到“让 AI 参与真实项目”。这一步跨过去之后，你会发现它和普通聊天工具完全不是一个东西。