Claude Code上手：5种装法和先学的3个命令

原文要点

这是日文媒体AInformation编辑部的实机验证文。核心事实：Claude Code官方有5种安装方式（原生安装、Homebrew、WinGet、Linux包管理器、npm），原生方式支持自动更新；系统要求Mac 13以上、Windows 10 1809以上、内存4GB以上，npm方式需Node.js 22以上；编辑部Mac上用原生一行命令安装耗时26秒、本体229MB（作者实测数据）；装完常见坑是~/.local/bin不在PATH导致command not found；终端子命令共18个，新手只需先会3个（claude、/help、/exit）；免费版不能用，需Pro以上订阅或Console按量计费，作者查得Pro为月20美元；Windows安装报错在官方37条故障条目里占11条，GitHub安装类反馈Windows最多；VS Code扩展要求1.94.0以上，但只装扩展无法在终端用claude命令。

这次做成什么

按本文在自己的电脑上装好Claude Code并完成首次启动：选对安装方式、跑通登录、在项目文件夹里发出第一条中文指令，并掌握最先要会的3个命令和装完当天该做的3件事。

准备什么

• macOS 13以上，或64位Windows 10 1809以上，或Ubuntu 20.04等主流Linux，内存4GB以上
• Claude的Pro以上付费订阅，或Anthropic Console按量计费账号（免费版无法使用Claude Code）
• 能打开终端（Mac的Terminal、Windows的PowerShell或cmd、WSL终端）
• 一个用于练习的测试项目文件夹（先在空文件夹里试，别直接对重要项目下手）

具体怎么做

1. 按系统选对安装命令

   先决定用哪种方式：官方推荐原生安装（带自动更新），Mac、Linux、WSL都在终端粘贴 curl -fsSL https://claude.ai/install.sh | bash；Windows用PowerShell粘贴 irm https://claude.ai/install.ps1 | iex；用cmd则是下载install.cmd再执行的那一行。想用包管理器的话：Homebrew用 brew install --cask claude-code，WinGet用 winget install Anthropic.ClaudeCode，npm用 npm install -g @anthropic-ai/claude-code（需Node.js 22以上，自动更新）。第五种是Linux发行版自带包管理器：Debian/Ubuntu用apt、Fedora/RHEL用dnf、Alpine用apk，需先按官方文档注册签名密钥再安装。注意除原生和npm外其余方式没有自动更新，要自己定期upgrade。

2. 验证安装并修PATH

   装完立刻打 claude --version。出现版本号和（Claude Code）字样就成功了（编辑部当时显示2.1.288）。如果Mac上提示command not found: claude，说明~/.local/bin没进PATH，把安装结束时提示的那行 echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc && source ~/.zshrc 粘贴执行即可；Windows则先关掉终端开新窗口再试。

3. 首次启动并完成登录

   打 claude 启动。第一次会打开浏览器要求授权，用Claude账号允许即可，之后不再询问。登录方式有三个选项：订阅（Pro/Max/Team/Enterprise）选第一项，Console按量计费选第二项，走云平台选第三项。想换账号时在会话里打 /login 重选。

4. 进入项目文件夹发出第一条指令

   用 cd 进入你的练习文件夹，再打一次 claude。启动后屏幕上方会显示版本、当前模型和所在文件夹。直接用中文下指令即可，例如先让它读项目：这个文件夹里有什么文件，用一句话告诉我每个文件是干什么的。不用手动上传文件，它会自己去读。

5. 掌握最先要会的3个命令并做当日3件事

   子命令虽有18个，但起步只要3个：claude启动、会话内 /help 看可用命令、/exit 退出。装完当天再做三件事：先让Claude读一遍项目再提修改需求；打一次 claude doctor 检查安装状态（它只读配置不会对话）；按 Shift+Tab 查看当前权限模式，前几次建议保持在逐条询问的模式，看清它会改哪些文件再考虑放开自动。

可直接复制的材料

# Mac / 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

# Homebrew（Mac/Linux，无自动更新）
brew install --cask claude-code

# WinGet（Windows，无自动更新）
winget install Anthropic.ClaudeCode

# npm（需 Node.js 22 以上，自动更新）
npm install -g @anthropic-ai/claude-code

# Linux 包管理器（Debian/Ubuntu 用 apt、Fedora/RHEL 用 dnf、Alpine 用 apk，
# 无自动更新；需先按官方文档注册签名密钥，命令以官方安装页为准）

# 安装后验证
claude --version

# Mac 上 command not found 时修 PATH
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc && source ~/.zshrc

# 状态自检与手动升级
claude doctor
claude update

{
  "必须先会的3个": {
    "claude": "终端中启动交互会话",
    "/help": "会话内列出可用命令",
    "/exit": "退出会话"
  },
  "随后常用的5个": {
    "claude -c": "继续当前文件夹上一次会话",
    "claude -r": "从历史会话中挑一个恢复",
    "claude -p \"问题\"": "问一次就退出，不进入交互",
    "/clear": "清空当前会话历史",
    "claude doctor": "检查安装与更新状态，只读配置"
  },
  "按键技巧": {
    "/": "会话内列出命令，Tab补全",
    "上箭头": "调出上一条输入",
    "Shift+Tab": "切换权限模式（逐条询问/自动）"
  }
}

输入与输出示例

本站虚构的操作演示，版本号沿用原文作者实测值作为示意，不代表本站运行结果，你的输出以实际版本为准。

输入

一台64位Windows 11电脑的PowerShell里，用户从未装过Claude Code，已订阅Pro。按本文依次执行：irm https://claude.ai/install.ps1 | iex，然后claude --version，然后claude登录，再cd到D:\demo-folder后打claude，输入第一条中文指令。

对应输出

安装命令执行后终端显示下载与安装进度，结束后打claude --version返回类似 2.1.288 (Claude Code) 的一行；打claude后浏览器打开授权页，选第一项订阅登录并允许；回到终端进入D:\demo-folder再打claude，顶部显示版本、模型和路径；输入这个文件夹里有什么文件、各是干什么的，Claude自行读取后列出文件清单和用途说明。

做完检查这些

• claude --version能返回版本号和（Claude Code）字样，说明安装成功且PATH正确
• claude doctor显示安装方式（如native）和自动更新状态，无报错
• 首次打claude能打开浏览器完成授权，第二次启动不再要求登录
• 在练习文件夹里能用中文指令让Claude读出该文件夹的文件清单
• 会话内 /help 能列出命令、/exit 能正常退出，Shift+Tab能看到权限模式切换

容易卡住的地方

• 免费版Claude不包含Claude Code，必须先有Pro以上订阅或Console计费账号，否则会卡在无法使用
• PowerShell和cmd的命令不通用：在cmd里打irm会报不识别，在PowerShell里打cmd的&&连写会报分隔符错误，先看提示符开头有没有PS
• Mac装完立刻打claude常报command not found，是PATH问题不是安装失败，按修PATH那步处理
• npm方式要求Node.js 22以上，原文指出多篇旧文写18以上已过时
• Homebrew和WinGet方式没有自动更新，原文提到版本迭代很快（30天发26版），要自己定期升级
• VS Code扩展和终端版是两套：只装扩展不能在终端打claude，两者都要用就得各装一次
• 用量到上限会中途停止，官方未公布具体额度，大项目日要预留缓冲