安装 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 | 默认终端 | 可按个人习惯设置 |
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
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，因为在此系统上禁止运行脚本。可以在 PowerShell 中执行：
Set-ExecutionPolicy -Scope CurrentUser RemoteSigned执行后输入 Y 确认。
如果安装后看到类似提示：
Setup notes:
Native installation exists but C:\Users\你的用户名\.local\bin is not in your PATH.说明系统暂时还不能直接识别 claude 命令，需要把安装目录加入用户环境变量。
按下面步骤操作：
- 复制安装提示中
Location所在目录，例如C:\Users\你的用户名\.local\bin。 - 点击 Windows 搜索图标。
- 搜索“环境变量”。
- 打开“编辑系统环境变量”。
- 点击“环境变量”。
- 在“用户变量”中找到
Path。 - 点击“编辑”。
- 点击“新建”。
- 粘贴刚才复制的目录。
- 依次点击“确定”保存。
保存后关闭当前终端窗口，再重新打开 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 也可能出错，输出内容仍需要自己确认 |
| 信任项目文件夹 | 选择信任当前项目目录 |
七、国内套餐与中转站选择说明
由于网络环境、支付方式和服务可用性不同，有些同学可能不会直接使用 Claude 官方账号，而是选择国内厂商提供的编码套餐，或者使用第三方中转站。
这两类方案要分开看：
| 类型 | 特点 | 注意事项 |
|---|---|---|
| 国内大厂套餐 | 通常由模型厂商或平台方直接提供，文档和控制台相对明确 | 仍需关注套餐限制、模型映射、额度消耗和适配工具 |
| 第三方中转站 | 通常提供 Claude、Gemini、Codex 等接口转发服务 | 风险更高，需要关注跑路、隐私、计费、稳定性和合规问题 |
重要免责声明
下面链接仅作为课程配套资料索引，方便你自行查阅。其中汇总站和评测站都属于第三方网站，和我没有任何关系，也没有返佣或利益相关。
购买前请自行判断风险：包月优先按月付费，按量用多少充多少；中转站有跑路风险，先小额试用，不要囤余额或贪图大额优惠。
（由于不同模型、套餐在能力、额度、价格方面也各有差异，适合的人群和使用场景都不一样，并且中转、账号以及套餐这类服务并非由我提供或运营，后续可能会存在价格变动、规则调整、服务不稳定，甚至停止运营等风险，我无法承担这些风险，所以不会做直接推荐，请大家自行了解后选择适合自己的方案，购买后如果实在不会配置可以联系我协助）
1. 国内大厂套餐参考
你可以先通过下面这个第三方汇总站了解不同 Coding Plan 的大致情况：
Coding Plan Benchmark
常见厂商入口如下：
| 厂商 | 购买 / 控制台入口 | Claude Code 配置文档 |
|---|---|---|
| GLM / 智谱 | GLM Coding Plan 套餐概览 / 智谱 API Key | 智谱 Claude Code 配置文档 |
| MiniMax | MiniMax 国内套餐入口 | MiniMax Claude Code 配置文档 |
| Kimi | Kimi Code | Kimi Code Claude Code 配置文档 |
| Xiaomi MiMo | MiMo Token Plan | MiMo Claude Code 配置文档 |
2. 第三方中转站参考
中转站说明
这里不推荐任何中转站，只提供一个第三方评测入口，方便你自行了解市场情况。该网站同样与我没有任何关系，具体选择请自行判断。
八、配置 CC Switch
如果你使用第三方 API 服务，可以安装 CC Switch 来统一管理 Claude Code 的服务配置。
接入说明
不同厂商的配置方式不完全一样，我无法为每一家服务商都提供单独文档。
购买套餐后，建议优先搜索对应厂商的 Claude Code 或 CC Switch 配置说明。如果实在不知道怎么接入，也可以联系我，我会尽量辅助你完成配置。
打开 CC Switch 下载页面：
CC Switch Releases
根据自己的系统选择对应安装包：
| 系统 | 安装包 |
|---|---|
| macOS | CC-Switch-vXXX-macOS.dmg |
| Windows | CC-Switch-vXXX-Windows.msi |
九、Claude Code 常用操作
1. 更新 Claude Code
如果后续想手动更新 Claude Code，可以执行：
claude update2. 卸载 Claude Code
如果后续想删除 Claude Code，可以根据自己的系统执行对应命令。
macOS
rm -f ~/.local/bin/claude
rm -rf ~/.local/share/claudeWindows PowerShell
Remove-Item -Path "$env:USERPROFILE\.local\bin\claude.exe" -Force
Remove-Item -Path "$env:USERPROFILE\.local\share\claude" -Recurse -Force