01-安装 Claude Code

版本说明

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

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

一、认识 Claude Code 和终端

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

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

二、安装并设置 Warp

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

Warp 官网Build your software factory on Warp: factories as code, any model or harness, with evals, benchmarks, and self-improvement built in.

根据自己的系统下载安装包，安装完成后打开 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。

在 Warp 中输入：

bash

git

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

安装完成后验证：

bash

git -v

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

打开 Git for Windows 下载页面：

Git for Windows 下载页面

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

text

Git for Windows x64 Setup

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

安装完成后验证：

powershell

git -v

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

四、安装 Claude Code

提示

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

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

bash

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

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

text

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

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

bash

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

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

验证安装：

bash

claude -v

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

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

powershell

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

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

text

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

可以在终端中执行：

powershell

Set-ExecutionPolicy -Scope CurrentUser RemoteSigned

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

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

text

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

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

按下面步骤操作：

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

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

验证安装：

powershell

claude -v

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

五、创建项目文件夹

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

text

xiaoyou

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

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

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

bash

cd 项目文件夹路径

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

六、启动 Claude Code

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

bash

claude

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

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

七、Claude Code 常用操作

1. 更新 Claude Code

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

bash

claude update

2. 卸载 Claude Code

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

bash

rm -f ~/.local/bin/claude

bash

rm -rf ~/.local/share/claude

powershell

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

powershell

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