2 Claude Code 安装与登录:把命令行环境先跑通

这一篇先把 Claude Code 装起来。很多人学 AI 编程卡住,不是卡在模型能力,而是第一步环境就没跑通:终端不认识命令、Node 版本不对、Windows 里不知道该用 PowerShell 还是 WSL、登录后又不知道从哪里启动。
所以这一篇只做一件事:把命令行环境跑通,确认你能在一个真实项目目录里打开 Claude Code。
准备条件
官方文档里写得很明确:你需要一个终端、一个要处理的代码项目,以及可使用 Claude Code 的账号。Claude Code 可以在 macOS、Linux、Windows 和 WSL 上使用。Windows 用户可以原生使用,也可以放到 WSL 2 里使用。我的建议是,如果你的项目本来就在 Windows 目录里,就先原生跑;如果你长期做 Linux 服务端、Docker、Python 后端,WSL 2 会更顺手。
开始前先确认三件事:
git --version
node --version
npm --version
如果你不打算用 npm 安装,也依然建议保留 Node 和 Git,因为很多前端项目、构建脚本、CLI 工具都会用到它们。
推荐安装方式
截至 2026-06-03,我查看官方 Claude Code 文档,推荐安装方式已经以原生安装为主。
macOS、Linux、WSL 可以用:
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
如果你更习惯包管理器,Windows 也可以用:
winget install Anthropic.ClaudeCode
官方也保留 npm 全局安装方式:
npm install -g @anthropic-ai/claude-code
不过要注意,官方安装页特别提醒不要用 sudo npm install -g,因为这容易带来权限和安全问题。以前很多 CLI 工具都让人直接 sudo 装,全局路径乱了以后最麻烦。能用原生安装,就先用原生安装。
验证安装
装完以后,先不要急着打开大项目。先在终端执行:
claude --version
claude doctor
claude --version 用来确认命令存在,claude doctor 用来诊断环境。只要这里能正常返回,你后面排问题会轻松很多。
然后进入一个小项目目录:
cd your-project
claude
第一次运行会引导你登录账号。按浏览器提示走完登录流程即可。登录成功后,你应该能在终端里看到 Claude Code 的会话界面。
Windows 用户的选择
Windows 下最容易混淆的是 PowerShell、CMD、Git Bash、WSL。我的建议很简单:
如果你的项目是前端、桌面脚本、Windows 本地工具,先用 PowerShell。
如果你的项目是 Linux 服务端、Docker、Python 后端、深度学习环境,优先 WSL 2。
如果你只是复制官方命令,注意区分 PowerShell 和 CMD。PowerShell 里有 PS C:\,CMD 通常只有 C:\。
装完后请固定一个入口。不要今天 PowerShell,明天 WSL,后天 Git Bash。目录位置不一样,工具链不一样,Claude Code 看到的环境也会不一样。
第一条安全规则
不要在第一次会话里贴密钥、数据库密码、服务器密码。Claude Code 会读项目文件,也可能运行命令。你应该先让它读普通代码目录,而不是直接把 .env、私钥、证书文件丢给它。
下一篇我们就进入真实项目,让 Claude Code 先读仓库,再做第一次小改动。
参考资料:
Continue