Claude Code 简介与安装
什么是 Claude Code
Claude Code 是 Anthropic 官方推出的命令行 AI 编程助手，直接跑在你的终端里。与 Cursor 或 GitHub Copilot 这类集成到 IDE 的助手不同，Claude Code 的操作单位是整个项目——它能读取你的文件树、理解模块依赖关系、跨文件追踪代码逻辑。
核心差异在于：
- Cursor / Copilot：嵌入编辑器，擅长补全当前文件和行内建议。它们看到的是"你正在编辑的这块代码"。
- Claude Code：运行在终端，以项目为单位工作。它看到的是"整个代码库的结构和内容"。它能执行 shell 命令、编辑多个文件、运行测试并读取输出来调整策略。
可以这样理解：Cursor 像是一个随时帮你填空的搭档，而 Claude Code 更像一个能接管终端完成复杂任务的协作者。当你需要重构一个跨多个文件的模块、排查一个需要运行才能复现的 bug、或者从零搭建一个新功能时，Claude Code 的优势就体现出来了。
系统要求
Claude Code 对系统有明确的要求，不满足这些条件可能会出现各种奇怪的问题。
操作系统
| 系统 | 支持状态 | 说明 |
|---|---|---|
| macOS | 完整支持 | Intel 和 Apple Silicon 均可用 |
| Linux | 完整支持 | Ubuntu 20.04+ / Debian 11+ / CentOS 8+ |
| Windows | 有限支持 | 必须通过 WSL2 运行，原生不支持 |
Windows 用户需要注意：直接在 cmd 或 PowerShell 中运行 claude 命令会失败。必须在 WSL2 的 Linux 发行版中操作。WSL2 的安装可以参考微软官方文档，安装完成后在 WSL2 内按照 Linux 流程配置即可。
运行时环境
- Node.js：18.0.0 或更高版本。建议使用 LTS 版本（20.x 或 22.x）。你可以用
node --version检查当前版本。 - Python：3.8 - 3.11（仅在通过 pip 安装时需要）。Claude Code 的核心功能不依赖 Python，但某些插件和扩展功能可能需要。
- git：2.23 或更高版本。Claude Code 在项目中会频繁使用 git 来跟踪变更、创建提交和查看历史。
- 网络：需要能稳定访问
api.anthropic.com。如果你的网络需要代理，需要配置HTTPS_PROXY环境变量。
硬件建议
Claude Code 本身是轻量级的 CLI 工具，对本地硬件要求不高。但需要注意：
- 内存：建议 8GB 以上。不是 Claude Code 本身需要，而是 Claude Code 在操作大型项目时，Node.js 进程和编辑器进程加起来需要足够的内存。
- 磁盘：500MB 空闲空间用于缓存和临时文件。
- 网络带宽：建议 10Mbps 以上。每次请求需要上传上下文（代码文件）并下载响应（生成内容），大项目首次初始化时可能传输 10-50MB 数据。
安装方式对比
Claude Code 支持三种安装方式，各有优劣。以下是对比表：
| 安装方式 | 命令 | 优点 | 缺点 | 推荐场景 |
|---|---|---|---|---|
| npm 全局安装 | npm install -g @anthropic-ai/claude-code | 全局可用，一次安装到处使用 | 需要 Node.js 18+ | 日常开发首选 |
| pip 安装 | pip install claude-code | Python 生态用户友好 | 版本更新可能滞后于 npm | Python 开发者 |
| npx 免安装 | npx @anthropic-ai/claude-code | 无需安装，即用即走 | 每次启动需要下载，速度慢 | 临时使用或评估 |
npm 全局安装（推荐）
# 全局安装
npm install -g @anthropic-ai/claude-code
# 验证安装
claude --version
安装完成后，claude 命令会被添加到系统 PATH 中。如果遇到 "command not found" 错误，检查 npm 全局 bin 目录是否在 PATH 中：
# 查看 npm 全局安装路径
npm bin -g
# 将其添加到 PATH（如果是 bash/zsh）
export PATH="$(npm bin -g):$PATH"
pip 安装
pip install claude-code
安装后同样使用 claude 命令启动。pip 版本的更新频率低于 npm，可能不是最新的功能版本。
npx 免安装
npx @anthropic-ai/claude-code
这种方法每次运行都会从 npm 仓库下载最新版本，所以首次启动会比较慢（取决于网络速度）。适合只是想体验一下、不想在系统里留下安装痕迹的场景。
首次运行与 API Key 配置
安装完成后，在终端输入 claude 启动。首次运行时，Claude Code 会引导你完成以下配置：
claude
启动后，终端会显示类似这样的输出：
Welcome to Claude Code!
To get started, you'll need an Anthropic API key.
You can get one at: https://console.anthropic.com/
Enter your API key:
API Key 获取
- 访问 Anthropic Console
- 注册或登录账号
- 在 API Keys 页面点击 "Create Key"
- 复制生成的密钥（格式以
sk-ant-开头）
环境变量配置
将 API Key 设置为环境变量可以避免每次启动时重新输入：
# 临时设置（当前终端会话有效）
export ANTHROPIC_API_KEY="sk-ant-你的密钥"
# 永久设置（添加到 shell 配置文件）
echo 'export ANTHROPIC_API_KEY="sk-ant-你的密钥"' >> ~/.bashrc
source ~/.bashrc
对于 zsh 用户（macOS 默认）：
echo 'export ANTHROPIC_API_KEY="sk-ant-你的密钥"' >> ~/.zshrc
source ~/.zshrc
验证配置是否生效
# 查看环境变量是否设置成功
echo $ANTHROPIC_API_KEY
# 启动 Claude Code
claude
如果一切正常，你会看到 Claude Code 的提示符，表示已经成功进入交互模式。
基础命令速览
进入 Claude Code 后，你可以使用 / 开头的命令来操作。以下是几个最常用的：
| 命令 | 功能 | 使用场景 |
|---|---|---|
/help | 显示帮助信息，列出所有可用命令 | 记不清命令时随时查看 |
/clear | 清除当前对话历史，重置上下文 | 对话跑偏或上下文太乱时 |
/compact | 压缩上下文窗口，释放 token 空间 | 提示上下文过长时 |
/init | 在项目根目录初始化 CLAUDE.md | 新项目首次使用 Claude Code |
/add-dir | 添加额外的工作目录 | 需要跨多个目录工作时 |
/status | 显示当前会话状态和统计信息 | 查看 token 使用情况和文件变更记录 |
/cost | 显示当前会话的 API 调用费用估算 | 控制使用成本 |
这些命令的具体用法和高级技巧会在后续章节中详细展开。下一章我们将深入 Claude Code 的交互模式，看看在实际开发中如何高效使用它。