claude-code安装教程

Claude Code 完整安装与使用教程

Claude Code 是 Anthropic 官方推出的命令行 AI 编程助手，基于 Claude 模型，帮助你在终端中直接进行代码编写、调试、重构等操作。

目录

一、环境要求

在开始安装之前，请确保你的电脑满足以下条件：

项目 要求
操作系统 Windows 10/11、macOS、Linux
Node.js 18.x 或更高版本
npm 9.x 或更高版本
Git 2.x 或更高版本
网络 能够访问国外网站（或配置国内镜像）

二、安装 Node.js

Claude Code 基于 Node.js 运行，需要先安装 Node.js 环境。

2.1 下载安装

官网下载地址： https://nodejs.org/en/download

选择 LTS（长期支持版） 下载，建议不要选择最新的非稳定版本。

  • Windows 用户：下载 .msi 安装包，双击安装，一路默认即可
  • macOS 用户：下载 .pkg 安装包，或使用 Homebrew：brew install node
  • Linux 用户：使用包管理器安装，如 apt install nodejs npm

2.2 验证安装

打开终端（CMD / PowerShell / Terminal），运行以下命令：

node -v
# 输出示例：v20.20.2

npm -v
# 输出示例：10.8.2

✅ 如果能正常显示版本号，说明安装成功。

三、安装 Git

Git 用于版本管理，也是 Claude Code 的依赖之一。

3.1 下载安装

官网下载地址： https://git-scm.com/downloads

  • Windows：下载安装包，一路默认下一步即可
  • macOS：brew install git
  • Linux：apt install git 或 yum install git

3.2 验证安装

git --version
# 输出示例：git version 2.45.0.windows.1

3.3 基础配置（首次使用 Git 需要）

git config --global user.name "你的名字"
git config --global user.email "你的邮箱@example.com"

四、安装 Claude Code

4.1 通过 npm 全局安装

打开终端，执行以下命令：

npm install -g @anthropic-ai/claude-code

全局安装后，claude 命令会添加到系统 PATH 中，可以在任何目录下使用。

4.2 验证安装

claude --version

如果显示版本号，说明安装成功。

4.3 如果安装速度很慢

npm 默认连接的是国外服务器，在国内下载速度可能会很慢甚至超时失败。解决方案见下一节。

五、配置国内镜像加速（可选）

5.1 切换到淘宝/阿里云镜像

# 设置为淘宝镜像源（推荐）
npm config set registry https://registry.npmmirror.com

# 查看是否切换成功
npm config get registry
# 应输出：https://registry.npmmirror.com

5.2 切换后重新安装

npm install -g @anthropic-ai/claude-code

此时下载速度应该会快很多。

5.3 后续切回官方源（可选）

如果你之后安装其他包需要官方源，可以切换回来：

# 切回官方源
npm config set registry https://registry.npmjs.org

# 查看是否切换成功
npm config get registry

5.4 推荐做法：仅对当前命令使用镜像

不想修改全局配置的话，可以安装时临时指定镜像源：

npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com

六、启动 Claude Code

6.1 首次启动

在终端中输入：

claude

首次启动时，Claude Code 会：

  1. 检查更新 — 自动检测是否有新版本
  2. 登录验证 — 需要通过浏览器登录你的 Anthropic 账号
  3. 初始化配置 — 创建必要的配置文件

6.2 在项目目录中使用

建议在具体的项目目录中启动 Claude Code：

cd 你的项目目录
claude

这样 Claude Code 会自动读取项目的上下文，提供更精准的帮助。

七、常见问题与解决方法

问题 1：启动报错 — 地区限制

错误现象： 启动 Claude Code 时提示地区不可用或类似错误。

解决方法：

找到 Claude Code 的配置文件：

  • Windows 路径： C:\Users\你的用户名\.claude\settings.json
  • macOS / Linux 路径： ~/.claude/settings.json

用记事本或其他编辑器打开，在 {} 中添加以下配置：

{
  "hasCompletedOnboarding": true
}

⚠️ 如果文件中已有其他配置，记得给上一行末尾加英文逗号 ,。

配置文件示意图

保存后重新启动即可：

claude

问题 2：命令找不到（command not found）

原因： npm 全局安装路径没有添加到系统 PATH 环境变量中。

解决方法：

  • Windows： 重新安装 Node.js，确保勾选”Add to PATH”
  • macOS / Linux： 检查 npm 全局路径并添加到 shell 配置文件中
# 查看 npm 全局安装路径
npm root -g

# 将路径添加到 ~/.bashrc 或 ~/.zshrc
export PATH=$(npm root -g)/bin:$PATH

问题 3：安装失败 / 网络超时

解决方法：

# 清除 npm 缓存
npm cache clean --force

# 使用国内镜像重试
npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com

问题 4：权限不足（Linux/macOS）

# 使用 sudo（不推荐）
sudo npm install -g @anthropic-ai/claude-code

# 推荐：配置 npm 权限
npm config set prefix ~/.npm-global
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc

八、安装 CC-Switch（模型切换工具）

CC-Switch 是一个用于切换 Claude Code 使用模型的辅助工具。

8.1 下载

GitHub Releases 地址： https://github.com/farion1231/cc-switch/releases/tag/v3.14.1

8.2 安装

下载 CC-Switch-v3.14.1-Windows.msi 文件，双击安装即可。

8.3 使用说明

安装完成后，可以通过 CC-Switch 在不同 Claude 模型之间快速切换，方便根据任务需求选择合适的模型。

九、Claude Code 基本使用

9.1 启动交互模式

claude

进入交互模式后，你可以直接输入自然语言描述需求，Claude Code 会帮你完成代码编写、修改、解释等任务。

9.2 常用交互示例

# 在项目目录中启动 claude 后，可以直接问：

/help          查看帮助
/clear         清除对话历史
/status        查看当前状态

9.3 在 VSCode 中使用

Claude Code 也可以在 VSCode 终端中直接使用，与编辑器无缝配合：

# 在 VSCode 终端中启动
cd 你的项目
code .
# 然后在 VSCode 的终端中运行 claude

十、常用命令速查

命令 说明
npm install -g @anthropic-ai/claude-code 全局安装 Claude Code
claude 启动 Claude Code 交互模式
claude --version 查看版本号
npm config set registry <url> 设置 npm 镜像源
npm config get registry 查看当前 npm 镜像源
npm cache clean --force 清除 npm 缓存
claude -p "你的问题" 单次提问模式（不进入交互）