1. 前言

Claude Code 是 Anthropic 推出的命令行 AI 编程助手，能够直接在终端中理解代码库、执行命令、编辑文件，极大提升开发效率。本文记录了 2026 年 7 月最新版 Claude Code 的完整安装过程，涵盖环境准备、安装步骤、常见问题排查，帮助读者快速上手。

2. 环境准备

在开始安装之前，请确保你的开发环境满足以下要求：

• 操作系统：macOS 12+ / Ubuntu 20.04+ / Windows 10+（WSL2）
• Node.js：v18.0.0 或更高版本
• npm：v9.0.0 或更高版本
• Git：v2.30 或更高版本
• 终端：支持现代 ANSI 转义序列的终端（如 iTerm2、Windows Terminal、GNOME Terminal）

建议使用 Node.js 20 LTS 版本以获得最佳兼容性。

3. 安装 Node.js（如未安装）

Claude Code 基于 Node.js 运行，若你的系统尚未安装，推荐使用 nvm（Node Version Manager）进行安装：

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

# 重新加载终端配置
source ~/.bashrc   # 或 source ~/.zshrc

# 安装并使用 Node.js 20 LTS
nvm install 20
nvm use 20

# 验证安装
node --version   # 应输出 v20.x.x
npm --version    # 应输出 10.x.x

若使用 Windows WSL2，建议在 WSL2 的 Linux 发行版中执行上述命令。

4. 安装 Claude Code

4.1 全局安装

打开终端，执行以下命令全局安装 Claude Code：

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

安装完成后，验证是否成功：

claude --version

若输出类似 0.8.0 的版本号，说明安装成功。

4.2 使用 npx 运行（可选）

如果你不想全局安装，也可以使用 npx 直接运行：

npx @anthropic-ai/claude-code

首次运行时会自动下载并缓存，后续运行速度会加快。

5. 配置 API 密钥

Claude Code 需要 Anthropic API 密钥才能工作。请按以下步骤配置：

1. 访问 console.anthropic.com 注册并登录。
2. 在 API Keys 页面创建一个新的密钥。
3. 将密钥设置为环境变量：

export ANTHROPIC_API_KEY="sk-ant-你的密钥"

为方便长期使用，建议将上述命令添加到你的 shell 配置文件中（~/.bashrc、~/.zshrc 或 ~/.profile）：

echo 'export ANTHROPIC_API_KEY="sk-ant-你的密钥"' >> ~/.zshrc
source ~/.zshrc

6. 首次启动与授权

在项目目录中启动 Claude Code：

cd /path/to/your/project
claude

首次启动时，Claude Code 会：

1. 检查 API 密钥是否有效。
2. 请求访问你的代码库权限（用于理解项目结构）。
3. 请求执行命令的权限（用于运行测试、构建等操作）。

按提示确认授权即可。授权后，你将进入交互式命令行界面，可以直接用自然语言与 Claude Code 对话。

7. 常见问题排查

7.1 安装失败：权限错误

若遇到 EACCES 权限错误，说明 npm 全局安装目录没有写入权限。解决方案：

# 方案一：使用 nvm 管理（推荐，无需 sudo）
# 方案二：配置 npm 前缀
mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.zshrc
source ~/.zshrc

7.2 启动报错：API 密钥无效

确认环境变量已正确设置：

echo $ANTHROPIC_API_KEY

若输出为空，请重新执行 export 命令并检查密钥是否过期。

7.3 终端显示异常

Claude Code 使用丰富的终端 UI，若出现乱码或显示异常：

• 确保终端支持 256 色：echo $TERM 应输出 xterm-256color 或类似值。
• 更新终端模拟器到最新版本。
• 在 WSL2 中建议使用 Windows Terminal。

8. 卸载 Claude Code

如需卸载，执行：

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

同时可删除相关缓存目录（可选）：

rm -rf ~/.claude

9. 总结

本文记录了 2026 年 7 月最新版 Claude Code 的完整安装流程，从环境准备、Node.js 安装、全局安装、API 密钥配置到首次启动与常见问题排查。Claude Code 作为强大的 AI 编程助手，能够显著提升开发效率，建议在真实项目中尝试使用。

如果你在安装过程中遇到其他问题，欢迎在评论区留言交流。