What is Claude Code?
Claude Code 是 Anthropic 推出的命令行 AI 编程工具。和 Cursor、GitHub Copilot 不同，它不需要打开 IDE——直接在终端里输入自然语言，Claude 就能读你的代码库、写代码、修 bug、解释逻辑。它最独特的能力是理解整个项目结构，而不是只处理当前打开的文件。
在正式开始之前，你需要知道三件事：
- Claude Code 需要 Anthropic API Key（付费），不是 Claude.ai 的网页版订阅。两者独立。
- 它是命令行工具，运行在终端里，没有图形界面。别担心——你不会被要求写任何代码来使用它。
- 它会读取和修改你的文件。建议在测试项目里先试用，不要一上来就在公司代码库里跑。
Step 1: Install Node.js 18+
Claude Code 基于 Node.js。如果你的电脑上还没有 Node.js，先装它。
Windows
去 nodejs.org，下载 LTS 版本（推荐 20.x 或 22.x）。运行安装程序，全部默认选项，一路 Next 到底。
安装完成后，打开 PowerShell（按 Win 键，输入 PowerShell，回车），验证安装：
node --version
# 应该输出: v20.x.x 或 v22.x.x
npm --version
# 应该输出: 10.x.xMac
推荐用 Homebrew。如果你没装过 Homebrew，先打开 终端（Terminal） 运行：
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"然后安装 Node.js：
brew install node@22验证安装：
node --version
npm --versionLinux (Ubuntu/Debian)
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt-get install -y nodejs验证：
node --version
npm --versionStep 2: Get Your Anthropic API Key
这步容易搞混。你需要的是 API Key，不是 Claude.ai 的网页版账号。
- 打开 console.anthropic.com
- 注册或登录（可以用 Google 账号）
- 首次使用需要绑定信用卡，设置消费限额（建议先设 $20/月）
- 左侧菜单 → API Keys → 点击 Create Key
- 给 key 起个名字（比如 "claude-code-laptop"）→ 复制生成的 key
⚠️ 重要：Key 只显示一次。关闭页面后无法再次查看。请立即保存到安全的地方（密码管理器、文本文件都行，不要贴到聊天记录里）。
Step 3: Install Claude Code
打开终端（Windows: PowerShell。Mac: Terminal。Linux: Terminal），运行：
npm install -g @anthropic-ai/claude-code这条命令做了什么：npm install -g 是"全局安装"，安装后你可以在任何目录里使用 claude 命令。@anthropic-ai/claude-code 是 Claude Code 的包名。
安装过程大约 30-60 秒。你可能会看到一些 warning 信息，只要最后没有红色的 ERROR，就可以继续。
验证安装成功：
claude --version
# 应该输出类似: v1.x.xStep 4: 配置 API Key
有两种方式告诉 Claude Code 你的 API Key。推荐方式一：
方式一（推荐）：环境变量——将 key 设为系统环境变量，所有项目生效：
Windows (PowerShell, 管理员模式)
[Environment]::SetEnvironmentVariable('ANTHROPIC_API_KEY', 'sk-ant-api03-your-key-here', 'User')把 sk-ant-api03-your-key-here 替换成你的真实 key。关闭并重新打开 PowerShell 使其生效。
Mac / Linux (Terminal)
# 添加到 shell 配置文件中（zsh 用户用 .zshrc，bash 用户用 .bashrc）
echo 'export ANTHROPIC_API_KEY="sk-ant-api03-your-key-here"' >> ~/.zshrc
# 立即生效
source ~/.zshrc方式二：项目级配置——只在当前项目中生效，适用于多个项目用不同 key 的情况：
# 在项目根目录创建 .env 文件
echo 'ANTHROPIC_API_KEY=sk-ant-api03-your-key-here' > .envClaude Code 启动时会自动读取 .env 文件。
Step 5: 测试你的第一个 Claude Code 命令
创建一个测试项目目录，然后启动 Claude Code：
# 创建测试目录
mkdir claude-test && cd claude-test
# 初始化 git（Claude Code 需要 git 来跟踪代码变更）
git init
# 启动 Claude Code
claude第一次启动时，Claude Code 可能会问你是否同意使用条款。输入 y 确认。
看到交互式界面后，输入你的第一个指令：
创建一个简单的 HTML 文件 index.html，内容是一个现代化的"Hello World"页面，有居中的文字和好看的背景色。Claude 会：
- 分析你的请求
- 生成代码
- 显示它打算做什么（可能需要你按 Enter 确认）
- 创建文件
完成后，在浏览器中打开 index.html 查看结果。
常见问题
Q: 提示 "API key not found"
检查环境变量是否正确设置。运行 echo $ANTHROPIC_API_KEY（Mac/Linux）或 $env:ANTHROPIC_API_KEY（PowerShell）查看当前值。如果为空，回到 Step 4 重新设置。
Q: 提示 "Insufficient permissions"
去 Anthropic Console → Billing 检查：账户余额是否 >$0、是否已绑定信用卡、消费限额是否用完。
Q: 安装很慢或失败
这是 npm 网络问题。尝试使用国内镜像：
npm config set registry https://registry.npmmirror.com
npm install -g @anthropic-ai/claude-code
# 安装完成后恢复默认
npm config set registry https://registry.npmjs.orgQ: Claude Code 和 Cursor / Copilot 有什么区别？
Claude Code 是命令行工具，适合快速改项目、自动化任务、在终端里直接操作。Cursor 是IDE（编辑器），适合边写代码边用 AI 辅助。Copilot 是IDE 插件，适合在已有编辑器里自动补全。实际工作中三者可以配合使用。