Claude Code 教程

安装 Claude Code

系统要求

在安装 Claude Code 之前，请确保你的系统满足以下条件：

  • 操作系统：macOS 10.15+、Ubuntu 20.04+ / Debian 10+，或 Windows 上的 WSL（Windows Subsystem for Linux）
  • Node.js：版本 18 或更高（推荐使用 LTS 版本）
  • npm：随 Node.js 一同安装（版本 8+）
  • 终端：任何支持交互式输入的终端应用
⚠️

注意

Claude Code 目前不支持在 Windows 原生命令行（CMD / PowerShell）中直接运行。如果你使用 Windows，请先安装并配置 WSL 2，然后在 WSL 环境中执行后续步骤。

检查 Node.js 版本

打开终端，运行以下命令确认 Node.js 是否已安装且版本符合要求：

Terminal window
node --version

如果输出类似 v18.x.x 或更高版本号，说明已满足要求。若尚未安装 Node.js，推荐通过 nvm（Node Version Manager） 安装：

Terminal window
# 安装 nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash


# 重新加载终端配置
source ~/.bashrc  # 如果使用 zsh，改为 source ~/.zshrc


# 安装最新 LTS 版本的 Node.js
nvm install --lts

安装 Claude Code

使用 npm 全局安装 Claude Code：

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

安装过程通常只需几秒钟。安装完成后，验证是否成功：

Terminal window
claude --version

如果看到版本号输出（例如 1.x.x），说明安装成功。

💡

提示

如果你在安装时遇到权限问题（EACCES 错误），不建议使用 sudo。更好的做法是修改 npm 的全局安装目录，或使用 nvm 管理 Node.js，因为 nvm 安装的 Node.js 不需要额外权限。

身份认证

Claude Code 需要连接 Anthropic 的 API 服务。你有两种方式完成认证：

方式一：OAuth 登录（推荐）

这是最简单的方式，适合已有 Anthropic 账户或 Claude 订阅的用户：

Terminal window
claude login

执行后会在浏览器中打开 Anthropic 的登录页面，完成授权后自动配置凭证。

方式二：API Key

如果你使用 API Key 进行计费，可以通过环境变量设置：

Terminal window
# 临时设置（仅当前终端会话有效）
export ANTHROPIC_API_KEY="sk-ant-xxxxx"


# 永久设置（添加到 shell 配置文件）
echo 'export ANTHROPIC_API_KEY="sk-ant-xxxxx"' >> ~/.bashrc
source ~/.bashrc
⚠️

注意

请妥善保管你的 API Key，不要将其提交到代码仓库或分享给他人。建议使用环境变量或密钥管理工具来存储。

验证认证状态

运行以下命令检查当前的认证状态：

Terminal window
claude status

常见问题

安装时报 EACCES 权限错误

这是 npm 全局安装的常见问题。推荐的解决方案：

Terminal window
# 方案 1：使用 nvm 重新安装 Node.js（推荐）
nvm install --lts
npm install -g @anthropic-ai/claude-code


# 方案 2：修改 npm 全局目录
mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc
npm install -g @anthropic-ai/claude-code

命令未找到：claude: command not found

这通常意味着 npm 的全局 bin 目录不在系统 PATH 中。可以通过以下命令查找并添加：

Terminal window
# 查看 npm 全局 bin 目录
npm config get prefix


# 将对应的 bin 目录添加到 PATH
# 例如输出为 /usr/local，则添加 /usr/local/bin
echo 'export PATH="$(npm config get prefix)/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

WSL 中浏览器无法自动打开

在 WSL 环境中使用 claude login 时，浏览器可能无法自动打开。此时可以手动复制终端中显示的 URL 到 Windows 浏览器中完成认证。

网络连接问题

如果你所在的网络环境需要代理才能访问外部服务，可以配置 HTTP 代理：

Terminal window
export HTTP_PROXY="http://your-proxy:port"
export HTTPS_PROXY="http://your-proxy:port"
ℹ️

信息

如果安装或使用过程中遇到其他问题，可以运行 claude doctor 命令进行诊断，它会检查常见的配置问题并给出修复建议。

下一步

安装完成后，你已经准备好开始使用 Claude Code 了。下一节我们将进行第一次对话，体验 Claude Code 的核心功能。

评论与讨论