学习 · 5. 准备开发环境

10 分钟装好 Claude Code

按官方最新方式装好 Claude Code,跑通第一句对话:不用先装 Node.js,一行命令搞定。

灵点AI 约 3 分钟读完 最后验证 2026.10.11
本篇目录

本文按 Claude Code 官方安装文档整理,2026 年 10 月核对。安装方式更新得比较快,如有出入,以官方文档为准。

开始之前

  • 一台电脑:macOS 13 以上、Windows 10(1809)以上,或 Ubuntu 20.04 以上等常见 Linux,内存 4GB 以上
  • 一个付费账号:Claude Pro、Max、Team、Enterprise,或 Claude Console(按用量计费的 API 账号)。免费版 Claude 不包含 Claude Code
  • 能正常访问 Anthropic 服务的网络,并且身处官方支持的国家和地区

不想用命令行?官方也提供 Claude 桌面版应用,装好后可以在图形界面里使用 Claude Code。下面讲的是命令行版。

第一步:一行命令安装

现在不需要先装 Node.js。Mac、Linux 或 WSL,打开「终端」,粘贴这一行:

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

Windows 打开 PowerShell,粘贴这一行:

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

安装时不会显示进度,等它自己结束就行。用这种方式装的 Claude Code 会在后台自动更新。

如果你的 Mac 装了 Homebrew,也可以用 brew install --cask claude-code。注意这种方式不会自动更新,需要定期运行 brew upgrade claude-code。

第二步:确认装好了

关掉终端,重新打开一个,输入:

claude --version

能看到一串版本号,就说明装好了。如果提示 command not found,多半是新终端还没找到安装位置,运行 claude doctor 看看诊断信息,或者按官方的「Troubleshoot installation」文档处理。

第三步:登录

进入你的项目文件夹,输入 claude。第一次运行会打开浏览器,用你的 Claude 订阅账号或 Console 账号授权即可。

跑通第一句

mkdir my-first-project
cd my-first-project
claude

进入对话界面后,直接说人话:

帮我写一个 HTML 文件,标题是「Hello Claude」,背景蓝色,做完告诉我怎么在浏览器里打开它。

Claude Code 会先问你是否允许创建文件。同意之后,看到文件夹里出现 index.html,就成功了。

几个常见问题

  • 以前用 npm 装过?npm install -g @anthropic-ai/claude-code 仍然可用(需要 Node.js 22 以上),但官方更推荐上面的一行命令。千万别用 sudo npm install -g
  • 不确定电脑上装了几个、用的是哪个?运行 claude doctor
  • 公司电脑网络受限?先确认浏览器能打开 claude.ai,必要时找 IT 同事帮忙

接下来