安装教程 - Claude Code

Claude Code 是 Anthropic 官方出品的命令行 AI 编程助手，通过终端使用。本文介绍如何完成安装。

---

前置条件：安装 Node.js

Claude Code 依赖 Node.js 运行环境，安装前请先确认电脑上是否已有 Node.js。

检查方法： 打开终端（Windows 用命令提示符或 PowerShell，Mac 用终端），输入：

node -v

如果显示版本号（如 v20.x.x），说明已安装，跳过这一步。
如果提示"命令不存在"，请先去 https://nodejs.org 下载安装 LTS 版本。

⚠️ Node.js 版本要求 18 及以上，过旧版本可能无法运行。

---

安装 Claude Code

Node.js 准备好之后，打开终端，输入以下命令并回车：

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

等待安装完成（需要联网，视网速可能需要 1 ~ 3 分钟）。

Mac 用户提示： 如果提示权限不足，在命令前加 sudo：

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

Windows 用户提示： 如果提示权限不足，请右键点击「命令提示符」或「PowerShell」，选择「以管理员身份运行」后再执行。

---

验证安装

安装完成后，输入以下命令检查是否成功：

claude --version

显示版本号即代表安装成功。

---

启动 Claude Code

在任意项目文件夹下，打开终端输入：

claude

首次启动会引导你完成登录或配置，按提示操作即可。

💡 如果你使用的是中转站而非官方账号，首次启动后需要配置 API Key 和地址，详见：

• 快速开始-ccswitch（推荐）
• 手动配置-Claude Code