从未用过 Claude Code？这篇文章从零开始，带你完成安装、基础配置，并用 Claude Code 实现第一个真实功能。
第一步：安装
系统要求
- Node.js 18+ （推荐 20+）
- macOS、Linux 或 Windows（WSL2 推荐）
- Anthropic 账号（需要 Pro 计划或 API Key）
安装命令
bash
# 全局安装
npm install -g @anthropic-ai/claude-code
# 验证安装
claude --version
# 输出：claude v2.x.x认证
bash
# 启动认证流程
claude
# 首次运行会弹出认证提示
# 选择方式：
# 1. Claude.ai 账号（Pro/Max 订阅）
# 2. Anthropic API Key用 Claude.ai 账号（推荐新手）：
- 需要 Pro（$20/月）或 Max（$100-200/月）订阅
- 在浏览器里完成 OAuth 授权
- 不需要手动管理 API Key
用 API Key：
bash
export ANTHROPIC_API_KEY=sk-ant-xxx第二步：进入第一个项目
bash
# 进入你的项目目录
cd ~/my-project
# 启动 Claude Code
claude你会看到欢迎界面，然后可以开始输入。
第一次应该做什么
bash
# 让 Claude Code 了解你的项目
"这是一个什么项目？帮我总结一下代码库的架构。"Claude Code 会自动探索你的代码库，读取 README、package.json、核心文件，然后给你一个架构摘要。
第三步：创建第一个 CLAUDE.md
CLAUDE.md 是最重要的配置文件，Claude Code 每次启动都会读它。
bash
# 让 Claude Code 帮你生成初稿
/init/init 会扫描项目并生成 CLAUDE.md 草稿。一定要检查和精炼，删除不必要的内容，补充项目特有的规范。
最简单的起步版本：
markdown
# 项目名
一句话说明这是什么项目。
## 技术栈
- 框架：Next.js 16（App Router）
- 数据库：PostgreSQL（Prisma）
- 包管理：npm
## 命令
- 开发：npm run dev
- 测试：npm run test
- 构建：npm run build
## 重要规范
- TypeScript strict 模式
- 所有 API 路由在 src/app/api/
- 不要修改 src/lib/auth/（认证模块）第四步：实现第一个功能
用正确的方式提问（说目标，不说步骤）：
❌ 不好："在 src/api/users.ts 里创建一个 GET 函数，
查询 users 表，返回 JSON 格式"
✅ 好："我需要一个获取用户列表的 API。
支持分页（page 和 limit 参数），
只返回 active 状态的用户。
参考我们已有的 /api/products 接口风格。"
先规划后执行
对于任何超过一个文件的改动，先做规划：
/plan
实现用户头像上传功能：
- 支持 JPG/PNG/WebP，最大 2MB
- 上传到 S3，存储 URL 到数据库
- 在用户资料页展示
Claude Code 会列出：
- 需要创建/修改哪些文件
- 实现顺序
- 潜在问题
确认方向没问题，按 Shift+Tab 退出 Plan Mode 开始执行。
第五步：验证和迭代
bash
# 查看 Claude Code 做了什么改动
git diff
# 运行测试（Claude Code 也会自动运行）
npm test
# 如果结果不满意，回滚
/rewind # 或者按 Esc 两次最常用的 10 个命令
bash
/plan # 先规划再执行（防止走偏）
/clear # 清空上下文，开始新任务
/compact # 压缩上下文（节省 Token）
/rewind # 回滚到上一个 Checkpoint
/cost # 查看当前 Session 费用
/model # 切换模型（Haiku/Sonnet/Opus）
/init # 生成 CLAUDE.md 草稿
/pr # 生成 PR 描述
/ultrareview # 深度代码审查
/help # 查看所有命令新手常见错误
错误 1：任务太模糊
❌ "帮我改进这个代码"
✅ "帮我把这个函数重构成异步版本，用 Promise.all 并行处理三个 API 调用"
错误 2：一次要求太多
❌ "实现用户系统，包括注册、登录、个人资料、权限管理..."
✅ 分阶段：先 /plan，然后"先实现注册功能"
错误 3：不用 /plan 直接大改 大范围改动前先 /plan，看清楚会改哪些文件，确认方向对再执行。
错误 4：忘记在大改动前 commit
bash
# 大改动前养成习惯
git add -A && git commit -m "checkpoint before refactor"7 天上手计划
| 天 | 目标 |
|---|---|
| Day 1 | 安装 + 认证 + 探索现有项目 |
| Day 2 | 写 CLAUDE.md + 用 /plan 实现第一个小功能 |
| Day 3 | 学习 /clear /compact /rewind 的使用时机 |
| Day 4 | 配置 .claudeignore，观察 /cost 变化 |
| Day 5 | 创建 2-3 个自定义命令（/pr、/security 等） |
| Day 6 | 尝试让 Claude Code 做一次较大的重构 |
| Day 7 | 复盘：哪些场景最有价值，哪些还需要改进？ |
来源：code.claude.com 官方入门文档 | Anthropic 官方最佳实践 | 整理：ClaudeEagle