安装 Claude Code

版本说明

Claude Code 更新非常频繁，几乎每天都可能发布新版本。所以你安装后看到的版本号和课程画面不完全一致，是正常情况。

只要大版本保持一致，就不影响正常学习和使用。如果后续出现重大更新，我会及时更新对应的文档和视频。

一、认识 Claude Code 和终端

系统	如何打开系统自带终端
macOS	搜索“终端”并打开
Windows	搜索 PowerShell 并打开

终端窗口也叫命令行界面，英文是 Command Line Interface，简写为 CLI。

二、安装并设置 Warp

系统自带终端也能使用，但体验通常比较普通。课程中统一使用 Warp 作为演示终端。

Warp 官网

根据自己的系统下载安装包，安装完成后打开 Warp。

1. 首次启动设置

首次打开 Warp 时，可以按照课程演示完成基础配置：

设置项	建议选择
模式	Terminal
标签页样式	保持默认的水平排列
工具面板	启用
云盘功能	暂时取消勾选
代码审查	启用
智能体工具栏	启用
消息通知	启用
主题样式	按个人喜好选择

2. 常用个性化设置

进入 Warp 后，可以打开右上角设置面板，按下面方式调整：

位置	设置项	建议
Appearance	主题	可选择自己喜欢的主题
Appearance	Input position	选择 Start at the top
Appearance	Show the tab bar	选择 Always
Features	Warp is the default terminal	可按个人习惯设置，Windows没有此设置，可忽略
Features	Left Option key is Meta	macOS 建议开启，Windows 保持默认

系统	快捷键	作用
macOS	Command + +	放大界面

三、安装 Git

Claude Code 开发项目时需要配合 Git 使用，所以需要先安装 Git。

1. macOS 安装 Git

在 Warp 中输入：

git

如果系统弹出安装提示窗口，点击“安装”，再点击“同意”，等待系统自动下载并安装 Git。

安装完成后验证：

git -v

如果能看到 Git 版本号，说明 Git 安装成功。

2. Windows 安装 Git

打开 Git for Windows 下载页面：

Git for Windows 下载页面

选择适合自己电脑的安装包，例如：

Git for Windows x64 Setup

下载完成后打开安装包，保持默认选项一路点击“下一步”，直到安装完成。

安装完成后验证：

git -v

如果能看到 Git 版本号，说明 Git 安装成功。

四、安装 Claude Code

TIP

以下为官方安装方式，需具备良好代理网络条件。若无网络条件或者安装失败，可看 常见问题。

1. macOS 安装

在 Warp 中执行官方安装命令：

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

如果安装后看到类似提示：

Setup notes:
  Native installation exists but ~/.local/bin is not in your PATH.

说明系统暂时还不能直接识别 claude 命令。可以执行下面命令，把 Claude Code 安装目录加入 PATH：

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc && source ~/.zshrc

执行后关闭当前终端窗口，再重新打开 Warp。

验证安装：

claude -v

如果能看到 Claude Code 的版本号，说明安装成功。

2. Windows 安装

在 Warp 或 Windows PowerShell 中执行官方安装命令：

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

如果安装或启动过程中看到类似报错：

无法加载文件 ... Microsoft.PowerShell_profile.ps1，因为在此系统上禁止运行脚本。

可以在 终端 中执行：

Set-ExecutionPolicy -Scope CurrentUser RemoteSigned

如果执行后提示需要确认，输入 Y 确认。

如果安装后看到类似提示：

Setup notes:
  Native installation exists but C:\Users\你的用户名\.local\bin is not in your PATH.

说明系统暂时还不能直接识别 claude 命令，需要把安装目录加入用户环境变量。

按下面步骤操作：

1. 复制安装提示中 Location 所在目录，例如 C:\Users\你的用户名\.local\bin。
2. 点击 Windows 搜索图标。
3. 搜索“环境变量”。
4. 打开“编辑系统环境变量”。
5. 点击“环境变量”。
6. 在“用户变量”中找到 Path。
7. 点击“编辑”。
8. 点击“新建”。
9. 粘贴刚才复制的目录。
10. 依次点击“确定”保存。

保存后关闭当前终端窗口，再重新打开 Warp。

验证安装：

claude -v

如果能看到 Claude Code 的版本号，说明安装成功。

五、创建项目文件夹

建议为ClaudeCode单独创建一个项目文件夹，例如：

xiaoyou

这个文件夹会专门存放 Claude Code 生成的代码、文件，以及后续引用的资料。

系统	复制文件夹路径的方式
macOS	在 Finder 中打开“显示 → 显示路径栏”，右键底部路径栏中的文件夹并复制路径
Windows	右键项目文件夹，选择复制文件地址

回到 Warp，进入项目文件夹：

cd 项目文件夹路径

cd 是 change directory 的缩写，意思是切换目录。进入这个文件夹后，它就是当前工作目录。后面 Claude Code 创建的内容，通常都会优先放在这里。

六、启动 Claude Code

确认当前已经进入项目文件夹后，在 Warp 中输入：

claude

第一次启动 Claude Code 时，通常会经历下面几步：

步骤	操作
选择主题	用方向键切换，按 Enter 确认
登录或配置服务	可用官方账号登录，也可通过第三方 API 接入。若使用第三方，先退出 Claude Code，按 接入第三方模型的步骤 配置好 API，再重新进入
查看提醒	Claude Code 也可能出错，输出内容仍需要自己确认
信任项目文件夹	选择信任当前项目目录

七、Claude Code 常用操作

1. 更新 Claude Code

如果后续想手动更新 Claude Code，可以执行：

claude update

2. 卸载 Claude Code

如果后续想删除 Claude Code，可以根据自己的系统依次执行对应命令。

macOS

rm -f ~/.local/bin/claude

rm -rf ~/.local/share/claude

Windows PowerShell

Remove-Item -Path "$env:USERPROFILE\.local\bin\claude.exe" -Force

Remove-Item -Path "$env:USERPROFILE\.local\share\claude" -Recurse -Force