夜雨聆风✅ 环境要求
- Node.js: ≥ 18.0
- 系统: Windows 10/11、macOS 10.15+、Linux
- Git: Windows必须下载（macOS/Linux自带）
📦 安装前准备
一. 安装Node.js（国内镜像）
1. 下载
通过华为云开源镜像站下载 Node.js 二进制包，核心地址为 https://mirrors.huaweicloud.com/nodejs/
- 点击具体的 版本号文件夹（如 `v20.11.0/`），进入该版本目录。
- 根据操作系统和架构选择对应文件：
- Windows：下载 `.msi` 安装包（如 `node-v20.11.0-x64.msi`）。
- macOS：下载 `.pkg` 安装包或 `.tar.gz` 压缩包。
- Linux：下载 `.tar.gz` 压缩包（如 `node-v20.11.0-linux-x64.tar.gz`）。
2. 安装与配置
- Windows/macOS：双击下载的安装包，按向导提示完成安装，安装过程中建议勾选 “添加到 PATH” 以自动配置环境变量。
- Linux：需手动解压并配置环境变量，示例命令如下：
解压
tar -xzf node-v20.11.0-linux-x64.tar.gz移动至指定目录
sudo mv node-v20.11.0-linux-x64 /usr/local/nodejs配置环境变量（添加到 ~/.bashrc 或 ~/.zshrc）
echo 'export PATH=$PATH:/usr/local/nodejs/bin' >> ~/.bashrcsource ~/.bashrc
3. 验证安装
打开终端或命令行，执行以下命令检查是否成功：
node -vnpm -v若输出版本号，则说明安装成功 。
4. 配置淘宝镜像（关键）
# 设置淘宝镜像
npm config set registry https://registry.npmmirror.com# 验证
npm config get registry二. 安装Git
1. 访问镜像站点
打开浏览器访问华为开源镜像站首页：https://mirrors.huaweicloud.com
2. 定位 Git 资源
- 在页面顶部的搜索框中输入 `git` 并回车，或在列表中找到 语言类/工具类 下的 `Git-For-Windows`（Windows 系统）或`Git-For-macOS` 。
注意事项
- 下载完成后直接运行安装程序，建议保持默认配置一路点击“Next”即可完成安装 。
- 验证：
git --version🚀 三、安装Claude Code
方式1：npm全局安装（推荐）
npm install -g @anthropic-ai/claude-code#### 验证安装
claude --version显示版本号即成功。
🔧 安装与配置CC-Switch（多模型切换）
安装CC-Switch
夸克网盘地址：https://pan.quark.cn/s/d6152047213b，如果有问题可以加大佬QQ获取安装包：247369846
核心功能（一键切换国内/海外模型）
1. 打开界面：终端输入 cc-switch 或启动客户端
2. 添加供应商（以DeepSeek为例）
- 点+ → 选DeepSeek
- 填API Key（DeepSeek官网获取）→ 添加
3. 修改配置：（若不需要更改模型，直接点击 - 添加）
4. 启用配置：列表点启用
### ❓ 常见问题
- 安装超时：换淘宝镜像；关闭VPN/代理
- 权限错误（macOS/Linux）：加`sudo`
sudo npm install -g @anthropic-ai/claude-code四、启动 Claude Code
打开终端，先进入你的项目文件夹（这一步很重要，因为 Claude Code 会直接操作当前目录下的文件）：
cd 你的项目路径然后启动：
claude如果希望它直接干活，少问“可以吗？”，可以用自动模式：
claude --permission-mode auto --enable-auto-mode启动后，终端底部会出现一个类似 > 的输入框，你就可以开始“一句话派任务”了。
五、一句话任务范例
你只需把想做的事描述清楚，像对人说话一样。举几个例子：
| 生成一个新功能 | |
| 修改现有代码 | |
| 修复 Bug | Cannot read properties of undefined，帮我找出原因并修复” |
| 整理项目 | |
| 运行命令 | |
| 解释代码 |
输入后回车，Claude Code 就会自动：
扫描项目文件
编写/修改代码
运行终端命令（如果权限允许）
返回结果给你
