所属教程：Claude Code 从入门到大师级完整教程 预计阅读：22 分钟
本节带你完成 Claude Code 的安装、登录与终端环境准备，全程可照抄执行。我们先确认前置条件，再分别给出 macOS、Linux/WSL 与 Windows 的安装方式，最后完成登录、自检并运行第一条命令。安装完成后，你应该能在项目目录里启动一个交互式会话。
Claude Code 是基于 Node 生态分发的命令行工具，安装前先确认本机基础环境。
打开终端，分别执行下面两条命令，确认 npm 与 Node 版本：
node --version
npm --versionNode 版本应不低于 18。若尚未安装，可先到 Node.js 官方网站安装 LTS（长期支持）版本，或使用 nvm、fnm 等版本管理器管理。若你的系统里还没有 Node，也可以直接选择后文的官方原生安装方式，跳过 npm。
官方提供多种安装途径。你只需要根据自己的操作系统选择其中一种即可，不要重复安装多套导致命令冲突。下面依次说明。
在 macOS、Linux 以及 Windows 的 WSL 环境中，执行官方安装脚本：
curl -fsSL https://claude.ai/install.sh | bash脚本会自动下载对应平台的可执行文件并配置到系统路径。安装结束后，按照终端提示新开一个终端窗口，确保路径生效。
在 Windows PowerShell 中执行官方安装命令：
irm https://claude.ai/install.ps1 | iex执行完成后关闭并重新打开 PowerShell，使可执行文件路径生效。
如果你已经装好 Node 18+，也可以通过 npm 全局安装官方包：
npm install -g @anthropic-ai/claude-code部分系统在全局 npm 目录上存在写权限限制。不要为了图省事直接用 sudo 安装；更稳妥的做法是把 npm 全局目录配置到用户目录下。若安装时出现 EACCES 权限错误，先调整 npm prefix 再重试。
使用 Homebrew 的用户可通过 cask 安装：
brew install --cask claude-code安装完成、并新开终端后，执行版本检查命令：
claude --version终端输出版本号即表示安装成功。如果提示"命令未找到"，通常是路径尚未生效：先重启终端；仍报错则回到对应安装方式，检查安装脚本是否执行成功、可执行文件是否在系统 PATH 中。
再查看命令帮助，确认 CLI 可用：
claude --helpClaude Code 是围绕"当前项目目录"工作的，所以不要在空用户主目录里直接开始。先用 cd 进入你准备练习的项目文件夹：
# 进入你的项目目录（替换为你自己的路径）
cd ~/projects/your-project在该目录下启动交互式会话：
claude首次启动后，CLI 会引导你通过浏览器完成账号登录与授权。按照终端提示在弹出的浏览器页面中登录 Anthropic 账号、确认授权；成功后返回终端，会话即可使用。登录状态会被本地保存，后续启动无需重复授权。
如果浏览器没有自动打开，复制终端中给出的链接到浏览器手动打开即可。授权完成后回到终端，会话会自动继续。
进入会话后，可以使用内置诊断命令检查安装与配置状态。在对话中输入：
/doctor该命令会检查安装、配置与环境问题，并在发现可修复项时给出提示。新手遇到"用不了"的奇怪问题时，先运行 /doctor，往往能直接定位原因。
进入会话之前，先记住最常用的三种终端入口，后续章节会反复用到：
| 命令形式 | 作用 | 使用场景 |
|---|---|---|
claude | 启动交互式会话，等待你逐条输入 | 日常开发、多轮协作（最常用） |
claude "任务描述" | 启动交互式会话并带上一条初始任务提示 | 进入项目后直接说明要做什么 |
claude -p "问题" | 一次性查询，得到结果后直接退出，不进入持续对话 | 脚本化、快速询问单句问题 |
例如，带初始任务进入交互模式：
claude "先浏览一下这个项目的目录结构，再告诉我技术栈"一次性询问后退出：
claude -p "解释一下 src/utils/auth.ts 这个函数的作用"为了避免一开始就在真实业务代码上冒险，建议按下面顺序准备练习环境：
git status 没有未提交的重要改动）；claude 启动会话；claude，而不是在另一个无关目录。安装登录完成后，下一节我们就在一个现有项目里跑通"第一次会话"：观察它如何探索目录、如何汇报计划、你又应该在哪些节点审查与确认。
← 上一节：Claude Code 是什么：从代码补全到自主编程代理 下一节：第一次会话：读懂并修改一个现有项目 →