Claude Code安装教程

✅ 环境要求

- 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'  >> ~/.bashrc  source ~/.bashrc

3. 验证安装

打开终端或命令行，执行以下命令检查是否成功：

node -v

npm -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

启动后，终端底部会出现一个类似 `>` 的输入框，你就可以开始“一句话派任务”了。

五、一句话任务范例

你只需把想做的事描述清楚，像对人说话一样。举几个例子：

你想做什么	可以直接输入
生成一个新功能	“帮我用 Python 写一个爬虫脚本，抓取豆瓣电影 Top250 并保存为 CSV”
修改现有代码	“把 app.js 里所有回调函数改成 async/await 写法”
修复 Bug	“后端报错 `Cannot read properties of undefined`，帮我找出原因并修复”
整理项目	“给 index.ts 里的所有函数加上中文注释”
运行命令	“帮我装项目依赖，然后跑一下测试看看有没有问题”
解释代码	“解释一下这个 rust 项目里的 borrow checker 问题，并给出修改建议”

输入后回车，Claude Code 就会自动：

扫描项目文件
编写/修改代码
运行终端命令（如果权限允许）
返回结果给你