这是 2026 年 Claude Code 的完整开发者指南，覆盖安装配置、核心功能（Checkpoints/Plan Mode/扩展推理）、CLAUDE.md 最佳实践、Slash 命令、MCP 集成、Subagents 和生产工作流。基于 Opus 4.7 + 1M 上下文，附 40+ 专家技巧。
安装和配置
bash
# macOS/Linux
curl -sSL https://claude.ai/install.sh | bash
# 或用 Homebrew
brew install anthropic/claude/claude
# 验证安装
claude --version
# 登录
claude auth loginVS Code 扩展：在 VS Code 扩展市场搜索 "Claude Code"，安装官方扩展获得侧边栏面板和实时协作。
核心功能详解
Checkpoints 和 Rewind（v2.0 核心功能）
Claude Code 在每次代码修改前自动保存代码状态，创建安全回退点。
| 操作 | 快捷键/命令 | 说明 |
|---|---|---|
| 快速回退 | 双击 Escape | 回退到上一个 Checkpoint |
| 选择性恢复 | /rewind | 选择恢复：仅对话 / 仅代码 / 两者 |
| 自动 | 自动 | 每次代码修改前自动创建 |
最佳实践：做大胆的重构或实验，双击 Escape 随时撤销，像视频游戏的存档点。
Plan Mode（增强型）
触发：Shift+Tab 两次
Plan Mode 下 Claude 不能修改文件——只能分析、规划、提问。
Opus 4.7 新增了主动提问：在规划前会问关于需求的澄清问题，减少误解和返工。
# 正确用法
"为用户认证功能制定实现计划，但在我批准计划之前不要写任何代码"
Opus 4.7 会：
1. 问澄清问题（认证方式？第三方 OAuth？）
2. 分析现有代码库
3. 输出详细实现计划
4. 等待你的批准
扩展推理（Extended Thinking）
通过特定关键词分配更多"思考预算"：
| 关键词 | 推理深度 | 适合场景 |
|---|---|---|
think | 标准 | 一般分析 |
think hard | 深度 | 复杂问题 |
think harder | 更深 | 架构决策 |
ultrathink | 最大 | 最复杂的推理任务 |
"ultrathink 关于这个分布式系统的一致性问题，给出最优解"
"think harder 分析这个 race condition 的所有可能情况"
CLAUDE.md 最佳实践
文件加载顺序（全部合并）
~/.claude/CLAUDE.md— 用户全局默认（所有项目）- 父目录的
CLAUDE.md— Monorepo 有用 - 项目根目录
CLAUDE.md— 最常用，提交到 git .claude/CLAUDE.md— 备选子目录位置CLAUDE.local.md— 个人覆盖，加入 .gitignore
高效 CLAUDE.md 模板
markdown
# CLAUDE.md
@docs/architecture.md # 用 @ 语法引入其他文件
## 技术栈
- Next.js 15 with App Router
- TypeScript strict 模式
- Tailwind CSS
## 构建和测试命令
- IMPORTANT: 提交前必须运行 `npm run lint`
- Jest 单元测试，Playwright E2E
- YOU MUST 提 PR 前检查 TypeScript 类型错误
## 代码规范
- 使用参数化查询，绝不字符串拼接 SQL
- 所有 API 输入用 Zod 验证
- 日期处理统一用 UTC
## 禁区
- 不要提交 .env 文件
- API 密钥只通过环境变量
- 不要修改 scripts/deploy.sh（只有 DevOps 团队操作）关键写法原则：
IMPORTANT:和YOU MUST关键词提升指令优先级- 用
@文件路径引入长文档，保持 CLAUDE.md 简洁 - 每行问自己"去掉这行 Claude 会犯错吗？"，不会就删掉
MEMORY.md（v2.1 新增）
Claude Code 现在会自动把自己的笔记写入 ~/.claude/projects/{project}/memory/，前 200 行自动加载。
CLAUDE.md= 你的团队文档（团队共享）MEMORY.md= Claude 的个人笔记（会话间记忆）
Slash 命令
内置关键命令
/init 分析现有代码库，自动生成 CLAUDE.md
/plan 进入 Plan Mode
/review 审查最近的 git 变更
/ultrareview 云端多 Agent 并行深度审查
/compact 压缩对话历史，保留关键信息
/clear 清除全部上下文
/effort 调整推理努力等级（交互滑块）
/model 切换 AI 模型
/usage 查看用量细分
/powerup 终端内交互式功能教程
/rewind 选择性恢复到 Checkpoint
/recap 当前会话摘要
/worktree 创建 git worktree
创建自定义 Slash 命令
在 .claude/commands/ 目录创建 Markdown 文件：
markdown
---
description: 完整的安全导向代码审查
allowed-tools: Read, Glob, Grep
---
对最近的变更进行安全审查，检查：
1. 输入验证漏洞（XSS、SQL 注入）
2. 认证和授权逻辑
3. 敏感数据暴露（日志、错误消息）
4. 依赖安全性
输出：优先级排序的发现，每项附带位置和修复建议调用：/security-review
MCP 服务器集成
MCP（Model Context Protocol）让 Claude Code 连接外部服务，直接查询数据库、调用 API、搜索代码库等。
配置 MCP 服务器
json
// .claude/settings.json
{
"mcpServers": {
"postgres": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-postgres"],
"env": {
"DATABASE_URL": "${DATABASE_URL}"
}
},
"github": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-github"],
"env": {
"GITHUB_TOKEN": "${GITHUB_TOKEN}"
}
},
"filesystem": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-filesystem", "/allowed/path"]
},
"brave-search": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-brave-search"],
"env": {
"BRAVE_API_KEY": "${BRAVE_API_KEY}"
}
}
}
}常用 MCP 服务器
| 服务器 | 能力 | 适合场景 |
|---|---|---|
| server-postgres | 直接查询数据库 Schema 和数据 | 数据库驱动开发 |
| server-github | PR、Issue、CI 状态 | GitHub 工作流自动化 |
| server-filesystem | 扩展文件访问权限 | Monorepo |
| server-brave-search | 实时网页搜索 | 技术调研 |
| server-slack | 发送消息 | 通知和报告 |
| server-memory | 跨会话持久知识 | 长期项目 |
Subagents（子 Agent）
Subagents 让 Claude Code 把子任务委派给独立的 Agent 实例，每个有自己的上下文窗口——并行执行，互不干扰。
基础用法
"用并行 subagents 重构所有 API 端点以使用新的错误处理模式：
- 主 Agent：规划整体策略，创建 subagents
- Subagent 1：处理 auth 相关端点
- Subagent 2：处理 user 相关端点
- Subagent 3：处理 post 相关端点
各 subagent 完成后，主 Agent 汇总并运行集成测试"
Forked Subagents（v2.1.114）
bash
# 启用继承父 Session 完整上下文的 Subagent
export CLAUDE_CODE_FORK_SUBAGENT=1
claude用于需要父上下文背景才能工作的子任务。
Hooks 自动化
Hooks 在特定事件发生时自动执行命令。
json
// .claude/settings.json
{
"hooks": {
"PostToolUse": [
{
"matcher": "Write|Edit",
"hooks": [
{
"type": "command",
"command": "npm run lint --fix 2>/dev/null || true"
}
]
}
],
"PreToolUse": [
{
"hooks": [
{
"if": "Bash(git commit *)",
"type": "command",
"command": ".claude/hooks/pre-commit-checks.sh"
}
]
}
]
}
}常用 Hook 事件：
PreToolUse/PostToolUse：工具调用前后PreCompact：上下文压缩前（可以阻断）PermissionDenied：Auto Mode 拒绝时
生产级工作流
Git Worktree 并行开发
bash
# 创建独立 worktree
git worktree add ../feature-auth -b feature/auth
git worktree add ../feature-ui -b feature/ui
# 在各 worktree 里独立运行 Claude Code
cd ../feature-auth && claude # Terminal 1
cd ../feature-ui && claude # Terminal 2每个 Agent 有自己的文件系统视图，共享 git 历史，无克隆开销。
TDD 工作流
1. "先写 UserAuthService 的测试用例，覆盖成功登录、密码错误、账户锁定"
2. [审查测试]
3. "实现让这些测试通过的最简代码"
4. [Claude 实现，自动运行测试，循环直到全绿]
大型重构的安全流程
1. /plan "把所有 callback 风格的 API 改成 async/await，先计划"
2. [审查计划]
3. 批准后开始执行，按模块逐步处理
4. 每个模块完成后运行测试
5. 用 /rewind 随时回退到任意 Checkpoint
40+ 专家技巧速查
上下文管理
- 每 30-40 条消息运行
/compact（主动管理） - 切换不相关任务时用
/clear - 用
@文件名精确指定上下文
任务精确度
- 给出具体文件路径，不要模糊描述
- 用否定约束（"不要修改公共 API"）
- 先 Plan 再 Execute，避免方向错误
成本优化
/usage查看用量细分，找到消耗热点--model haiku处理简单任务（成本最低）ENABLE_PROMPT_CACHING_1H开启 1 小时缓存（API 用户）
安全
- Auto Mode 替代
--dangerously-skip-permissions --allowedTools Read,Write,Grep限制工具范围- 高风险操作保留手动审批
来源：productbuilder.net - Claude Code Complete Guide 2026 | 整理：ClaudeEagle