1. 前言

Claude Code 是 Anthropic 推出的命令行 AI 编程助手，能够直接在终端中理解代码库、执行命令、编辑文件。本文将记录我在最新版本下的完整安装过程，帮助大家快速上手。

2. 环境准备

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

• 操作系统：macOS 10.15+ 或 Ubuntu 20.04+（Windows 用户建议通过 WSL2）
• Node.js：版本 18.0.0 或更高
• npm：建议 9.0.0 以上
• Git：用于版本管理和代码库操作

可以通过以下命令检查已有环境：

node --version
npm --version
git --version

3. 安装步骤

3.1 全局安装 Claude Code

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

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

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

claude --version

3.2 获取 API Key

Claude Code 需要 Anthropic API Key 才能运行：

1. 访问 Anthropic Console
2. 注册或登录账号
3. 在 API Keys 页面创建一个新的密钥
4. 复制密钥并妥善保存

3.3 配置环境变量

将 API Key 设置为环境变量：

export ANTHROPIC_API_KEY=your-api-key-here

为了持久化配置，建议将其添加到 shell 配置文件（如 ~/.zshrc 或 ~/.bashrc）：

echo 'export ANTHROPIC_API_KEY=your-api-key-here' >> ~/.zshrc
source ~/.zshrc

4. 首次启动与授权

在项目目录中运行以下命令启动 Claude Code：

cd your-project-directory
claude

首次启动时，Claude Code 会请求以下权限：

• 文件系统访问：读取和编辑项目文件
• 终端命令执行：运行构建、测试等命令
• Git 操作：创建提交、分支等

按提示输入 y 确认授权即可。

5. 验证安装

创建一个简单的测试项目来验证 Claude Code 是否正常工作：

mkdir claude-test
cd claude-test
echo "# Test Project" > README.md
claude "请为这个项目添加一个简单的 Node.js 脚本，输出 Hello Claude"

如果 Claude Code 能够正确理解指令并生成代码，说明安装成功。

6. 常见问题

6.1 安装失败

如果 npm install 报错，尝试：

npm cache clean --force
npm install -g @anthropic-ai/claude-code --registry=https://registry.npmjs.org

6.2 权限不足

macOS/Linux 下使用 sudo：

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

6.3 API Key 无效

确保环境变量已正确设置，且 API Key 未过期。可以在终端中运行：

echo $ANTHROPIC_API_KEY

确认输出不为空且与 Console 中的密钥一致。

7. 总结

至此，你已经完成了 Claude Code 的安装与基本配置。后续可以进一步学习如何利用它进行代码生成、重构、调试等高级操作。如果遇到问题，欢迎在评论区交流。