02 · 安装、登录与运行形态

📚 系列导航：上一篇 01 是什么讲清了 Claude Code 是什么。这一篇带你装好它、登录、跑通第一次，并了解五种运行形态各适合什么场景。

01 装之前确认三件事

系统要求

项目	要求
操作系统	macOS 13.0+ / Windows 10 1809+ / Ubuntu 20.04+ / Debian 10+
内存	4 GB 以上可用 RAM
处理器	x64 或 ARM64
网络	需要联网（国内用户需魔法上网）

账号要求

免费版 Claude.ai 账号用不了 Claude Code。 需要 Pro、Max、Team、Enterprise 或 Console（API）账号之一。

用法选择

新手建议直接学 CLI（命令行），功能最全、最贴近设计初衷。后面四种形态都是在 CLI 基础上加图形界面，学会 CLI 后再上手其他形态只需要几分钟。

02 安装

首选：官方安装脚本（自带自动更新）

macOS / Linux / WSL：

bash

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

Windows PowerShell（提示符为 PS C:\>）：

powershell

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

Windows CMD（提示符为 C:\>）：

batch

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

国内网络提示：安装全程需要魔法上网。CMD 用户注意——curl 默认不走系统代理，需在同一个 CMD 窗口先手动设代理：set https_proxy=http://127.0.0.1:7890（端口换成你的代理客户端实际端口），再跑安装命令。PowerShell 的 irm 默认走系统代理，没这毛病。

备选方式

方式	命令	自动更新	适合人群
Homebrew（macOS）	`brew install --cask claude-code`	❌ 手动	重度 brew 用户
WinGet（Windows）	`winget install Anthropic.ClaudeCode`	❌ 手动	习惯 WinGet 的人
npm	`npm install -g @anthropic-ai/claude-code`	❌ 手动	有 Node.js 18+，且优先选官方脚本

WARNING

npm 安装注意：永远别加 sudo。sudo npm install -g 会引发权限问题和安全风险。遇到权限报错，正解是改用官方脚本。

验证安装

bash

claude --version

预期输出类似 2.x.x (Claude Code)。

更详细的体检：

bash

claude doctor

03 登录

在项目目录启动 Claude Code：

bash

cd /path/to/your-project
claude

首次启动会自动引导浏览器登录。远程/WSL/SSH 环境中浏览器可能不会自动弹出——在登录提示界面按 c 复制 OAuth URL，手动粘贴到浏览器打开，登录后把显示的 code 贴回终端即可。

TIP

切换账号：在 Claude Code 里输入 /logout 退出当前账号，下次启动重新登录。

04 五种运行形态

五种形态底层是同一个引擎，配置全平台通用。下面列出各形态的安装方式和核心差异。

形态一：终端 CLI（功能最全）

即上面安装好的 CLI。所有操作都在终端完成，没有图形界面，但功能最完整、适合脚本化和自动化。

形态二：VS Code 扩展（有图形 diff）

安装：VS Code 扩展市场搜索 Claude Code，认准发布者 Anthropic 的官方扩展。

核心差异：

代码改动在 VS Code 原生 diff 视图中展示（红绿高亮标增删），接受前可当场修改
输入框打 @ 触发文件路径补全，精准喂上下文
选中代码后 Claude 自动看见，无需额外描述
大改动前可切 Plan Mode，Claude 把计划写成 Markdown 文档，你可以在上面加内联批注

找入口：Spark 图标（火花形）只在打开具体文件时出现在编辑器右上角。如果找不到，用右下角状态栏的 ✱ Claude Code 入口，或命令面板搜 Claude Code。

形态三：JetBrains 插件（桥接 IDE）

安装：Settings → Plugins → Marketplace，搜索 Claude Code，认准官方插件。装完完全重启 IDE。

核心差异：

对话在 IDE 内置终端里发生，不是独立面板
选区自动共享给 Claude，lint 诊断也自动可见
代码改动弹进 IDE 原生 diff 查看器（需在 /config 里把 diff tool 设为 auto）
快捷键：Cmd+Esc 切焦点，Cmd+Option+K 插入文件引用

注意：JetBrains 插件需要 CLI 本体 + 插件两样都装。从内置终端启动 claude 自动连接，从外部终端启动需在 Claude 里跑 /ide 手动连接。

形态四：桌面 App（并行 + 可视化）

安装：

macOS：下载 Universal 版 .dmg，拖进 Applications 文件夹
Windows：下载 .exe 安装程序（ARM64 下 ARM64 版），必须先装 Git for Windows
Linux：没有桌面 App，用 CLI

核心差异：

点 + New session 开新会话，自动创建 Git worktree，并行任务互不污染
集成终端与 Claude 共享工作目录，文件点路径即开即改
diff 可视化查看器支持逐行批注，还能让 Claude 先自审
侧边栏管理所有会话，Ctrl+Tab 切换

装完后：打开应用、登录，点顶部中间的 Code 选项卡（不是 Chat 选项卡）。

形态五：网页版（免安装云端跑）

入口：浏览器打开 claude.ai/code

核心差异：

代码跑在 Anthropic 云虚拟机里，不碰你本地文件
每次任务新克隆 GitHub 仓库，干完改分支推给你
关掉网页继续跑，回头用手机也能看进度
适合并行跑多个任务、改本地没克隆的仓库

前提：需要 Pro/Max/Team 订阅，且有个 GitHub 仓库。

选择指南

你的场景	推荐形态
想学全功能、自动化	CLI
主力在 VS Code 写码	VS Code 扩展
主力在 JetBrains IDE	JetBrains 插件
并行多个任务 + 可视化审阅	桌面 App
免安装、云端跑、改 GitHub 仓库	网页版

05 升级与卸载

升级

官方脚本安装的自动更新，想立刻更：

bash

claude update

其他方式各自运行对应升级命令（Homebrew / WinGet / npm 均不自动更新）。

卸载

按当初的安装方式对应卸载。官方脚本装的：

bash

# macOS / Linux / WSL
rm -f ~/.local/bin/claude && rm -rf ~/.local/share/claude

powershell

# Windows PowerShell
Remove-Item -Path "$env:USERPROFILE\.local\bin\claude.exe" -Force
Remove-Item -Path "$env:USERPROFILE\.local\share\claude" -Recurse -Force

WARNING

卸载注意：以上只删程序本体。配置、授权、会话历史还在 ~/.claude/ 里。想彻底清干净（不可逆）：rm -rf ~/.claude && rm ~/.claude.json。

06 新手常见报错速查

报错	真正原因	怎么修
`command not found: claude`	安装目录没进 PATH	把 `~/.local/bin` 加进 PATH（`export PATH="$HOME/.local/bin:$PATH"`）
`'&&' is not valid`	在 PowerShell 里跑了 CMD 命令	换成 PowerShell 的 `irm` 命令
`irm is not recognized`	在 CMD 里跑了 PowerShell 命令	换成 CMD 的安装命令
开着魔法上网，CMD 里装仍卡住	CMD 的 `curl` 不走系统代理	CMD 里先 `set https_proxy=...` 再装，或换 PowerShell
登录后报组织禁用	环境变量有旧 `ANTHROPIC_API_KEY`	`unset ANTHROPIC_API_KEY`，再重进 `claude`
桌面的 Spark 图标找不到	没打开具体文件	先打开一个文件，或用右下角状态栏入口

07 动手：从零跑通第一次

bash

mkdir claude-test && cd claude-test
claude

首次启动引导登录。登录后在输入框敲 /help 看可用命令，再试：

text

在 test.py 文件里写一个打印 hello world 的函数

Claude 会先把 diff 摆给你看，确认后才写文件。最后 exit 退出。

08 小结

环节	关键动作
安装	官方脚本一条命令，自带自动更新
验证	`claude --version` 出版本号
登录	`claude` 启动 → 浏览器登录
五大形态	CLI 功能最全，新手从这入门
升级	官方脚本自动更新，`claude update` 手动催
排障	找不到命令查 PATH，登录异常查环境变量

NOTE

下一篇：03 工作原理与 API 配置：装好了、登上了，接下来掀开盖子看它怎么干活——代理循环、5 类工具、API key 与订阅的优先级，以及怎么接国产模型省钱。

02 · 安装、登录与运行形态 ​

01 装之前确认三件事 ​

系统要求 ​

账号要求 ​

用法选择 ​

02 安装 ​

首选：官方安装脚本（自带自动更新） ​

备选方式 ​

验证安装 ​

03 登录 ​

04 五种运行形态 ​

形态一：终端 CLI（功能最全） ​

形态二：VS Code 扩展（有图形 diff） ​

形态三：JetBrains 插件（桥接 IDE） ​

形态四：桌面 App（并行 + 可视化） ​

形态五：网页版（免安装云端跑） ​

选择指南 ​

05 升级与卸载 ​

升级 ​

卸载 ​

06 新手常见报错速查 ​

07 动手：从零跑通第一次 ​

08 小结 ​

02 · 安装、登录与运行形态

01 装之前确认三件事

系统要求

账号要求

用法选择

02 安装

首选：官方安装脚本（自带自动更新）

备选方式

验证安装

03 登录

04 五种运行形态

形态一：终端 CLI（功能最全）

形态二：VS Code 扩展（有图形 diff）

形态三：JetBrains 插件（桥接 IDE）

形态四：桌面 App（并行 + 可视化）

形态五：网页版（免安装云端跑）

选择指南

05 升级与卸载

升级

卸载

06 新手常见报错速查

07 动手：从零跑通第一次

08 小结