Claude Code 安装教程

本教程将带你从零开始完成 Claude Code 的安装。整个过程大约需要 15 分钟。

什么是 Claude Code？

Claude Code 是 Anthropic 开发的 AI 编程助手，运行在终端（命令行）中。你可以通过自然语言与它对话，让它帮你编写代码、调试问题、重构项目等。

前置要求

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

要求	说明
操作系统	macOS 10.15+、Ubuntu 20.04+、Windows 10+
Node.js	版本 18.0 或更高
网络	能够访问 api.anthropic.com

第一步：安装 Node.js

Claude Code 需要 Node.js 运行环境。如果你的电脑还没有安装 Node.js，请按以下步骤操作。

推荐使用 Homebrew 安装：

bash

# 安装 Homebrew（如果还没有）
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# 安装 Node.js
brew install node

# 验证安装
node --version
npm --version

Node.js 版本要求

请确保 Node.js 版本 >= 18.0。如果版本过低，Claude Code 将无法正常运行。使用 node --version 检查版本。

第二步：安装 Claude Code

Node.js 安装完成后，使用 npm 全局安装 Claude Code：

终端命令

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

如果遇到权限问题，macOS/Linux 用户可以在命令前加 sudo，或使用 nvm 管理 Node.js 版本。

第三步：验证安装

安装完成后，运行以下命令验证 Claude Code 是否安装成功：

bash

claude --version

如果看到类似 claude v1.x.x 的版本号输出，说明安装成功。

安装完成！

恭喜你！Claude Code 已经成功安装到你的电脑上了。接下来请继续阅读"基础配置"教程来完成设置。

常见问题

npm install 报错怎么办？

如果安装过程中遇到权限错误：

bash

# macOS / Linux
sudo npm install -g @anthropic-ai/claude-code

# 或者配置 npm 全局目录
mkdir -p ~/.npm-global
npm config set prefix '~/.npm-global'
export PATH=~/.npm-global/bin:$PATH
npm install -g @anthropic-ai/claude-code

如何更新 Claude Code？

运行以下命令更新到最新版本：

bash

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

如何卸载？

bash

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