Claude Code 高阶使用技巧与最佳实践

面向中高级用户，深入探讨进阶技巧、配置优化、多智能体协作和生产级集成方案

1. 高级斜杠命令

代码审查与讲解

命令	作用	示例
`/review`	对当前改动进行代码审查	`/review src/main.ts`
`/explain`	解释选中代码或文件的逻辑	`/explain`（选中代码后）
`/doc`	生成或补全文档注释	`/doc function calculate`

测试与质量

命令	作用	示例
`/test`	基于当前代码生成单元测试	`/test --framework vitest`
`/lint`	运行 linter 并修复	`/lint`
`/fix`	修复当前文件中的错误	`/fix`

版本控制

命令	作用	示例
`/commit`	生成 Conventional Commit 并提交	`/commit`
`/deploy`	根据配置文件部署	`/deploy --env staging`

会话与上下文

命令	作用	示例
`/compact`	压缩对话历史，保留关键上下文	`/compact`
`/context`	查看当前上下文中所有文件	`/context`
`/clear`	清除对话历史	`/clear`

工作流与技能

命令	作用	示例
`/workflow`	启动多步自动化工作流	`/workflow "code review + test + commit"`
`/skills`	管理技能	`/skills list`，`/skills install github-cli`
`/mcp`	配置 MCP 服务器	`/mcp list`，`/mcp add sqlite`

诊断

命令	作用	示例
`/think`	强制先深度思考再输出	`/think`
`/plan`	为复杂任务生成分步计划	`/plan "Build auth system"`

2. 上下文管理策略

上下文压缩

频繁执行 /compact 让 Claude 将对话历史、改动、决策点压缩为结构化摘要。

显式加载与卸载

/load ./path/to/file.ts 主动加载关键文件
/unload 移除不需要的文件
提示中写 @filename 快速引用文件

技巧

技巧	说明
分阶段对话	大项目拆分为多会话，每阶段专注一个模块
使用 CLAUDE.md	定义"常驻上下文"自动注入
定期 `/compact`	每 10-20 轮交互执行一次
避免加载无关文件	只引用当前任务所需的文件

3. 多智能体工作流

功能角色分工

不同终端启动独立会话：

# 终端1: 架构师
claude "你是架构师，负责设计系统组件"

# 终端2: 测试工程师
claude "你是测试工程师，负责编写测试"

# 终端3: 代码审查
claude "你是代码审查员"

AGENTS.md 驱动

项目根目录创建 AGENTS.md，不同角色用不同会话：

# Agent: Architect
- 职责：设计系统架构，划分模块
- 关注文件：/docs/architecture.md, /src/core/

# Agent: Frontend
- 职责：实现 UI 组件
- 关注文件：/src/components/

# Agent: Backend
- 职责：实现 API，数据库操作
- 关注文件：/src/api/, /src/db/

4. MCP 服务器集成

MCP（Model Context Protocol）允许 Claude Code 连接到外部工具和数据源。

配置 MCP 服务器

{
  "mcpServers": {
    "postgres": {
      "command": "npx",
      "args": ["-y", "@anthropic/mcp-postgres"],
      "env": { "PGHOST": "localhost", "PGPORT": "5432" }
    },
    "github": {
      "command": "npx",
      "args": ["-y", "@anthropic/mcp-github"]
    }
  }
}

常用 MCP 服务器

MCP 服务器	功能	安装
`@anthropic/mcp-postgres`	查询 PostgreSQL	`npx -y @anthropic/mcp-postgres`
`@anthropic/mcp-github`	操作 GitHub Issues/PRs	`npx -y @anthropic/mcp-github`
`@anthropic/mcp-filesystem`	文件系统操作	`npx -y @anthropic/mcp-filesystem`
`@anthropic/mcp-sqlite`	查询 SQLite	`npx -y @anthropic/mcp-sqlite`
`@anthropic/mcp-brave-search`	联网搜索	`npx -y @anthropic/mcp-brave-search`

使用示例

在对话中：#mcp postgres 查询表 users 的结构

在 CLAUDE.md 中定义自动使用规则：

# MCP 配置
- 数据库查询：优先使用 postgres MCP
- GitHub 操作：优先使用 github MCP

5. AGENTS.md / CLAUDE.md 配置最佳实践

CLAUDE.md（会话指导）

项目根目录，每次启动自动读取：

# 项目指南
- 语言：TypeScript (严格模式)
- 框架：Next.js 15, App Router
- 数据库：Prisma + PostgreSQL
- 测试：Vitest + Playwright
- 样式：Tailwind CSS
- 提交规范：Conventional Commits
- 项目结构：/src/app/, /src/components/, /src/lib/, /src/api/
- 约束：不要修改 /vendor/，不要使用 console.log

配置文件搜索路径

用户级：~/.hermes/profiles/<profile>/config.yaml
项目级 CLAUDE.md：项目根目录
会话中动态注入

优先级：项目级 > 用户级 > 默认

6. Compound Engineering 模式

将 AI 辅助开发与结构化工程方法结合的高效模式。

核心原则

分解：大功能拆解为独立小任务
验证：每个阶段完成后立即测试
文档：每完成一个模块更新架构文档
回溯：保留所有 AI 决策记录

典型工作流

# 阶段1: 架构设计
claude "Phase1: 设计认证系统的架构，输出到 /docs/auth-arch.md"

# 阶段2: 实现核心模块
claude "Phase2: 根据 /docs/auth-arch.md 实现代码"

# 阶段3: 测试
claude "Phase3: 为 auth 模块编写单元测试和集成测试"

# 阶段4: 审查
claude "/review src/api/auth/"

7. 全栈开发实战技巧

项目初始化

npx create-next-app@latest my-app --typescript --tailwind
echo '请配置 Prisma、认证、ESLint/Prettier' | claude

全栈提示范例

请实现以下功能：
1. 数据库：创建 User 和 Post 模型（Prisma schema）
2. API：GET /api/posts 返回分页文章列表
3. 前端：/src/components/PostList.tsx 展示列表
4. 状态管理：React Query
5. 错误处理：前端错误边界 + 后端统一错误响应
要求：类型安全，使用 Zod 验证请求参数

全栈开发技巧

先定义接口：先生成 API 文档（OpenAPI），再前后端同步实现
类型共享：使用 tRPC 或 GraphQL Codegen 自动生成类型
分批次提示：不要一次性生成整个应用，分功能点迭代

8. 调试与测试工作流

调试模板

我在运行 [命令] 时遇到错误：
[粘贴错误输出]

相关代码文件：
@src/api/auth.ts (第45-70行)
@src/middleware.ts (第12-30行)

预期行为：[描述]
实际行为：[错误描述]

TDD 工作流

# 1. 先写测试
claude "为 src/api/auth.ts 编写完整的单元测试，不实现功能"

# 2. 运行测试（应失败）
npm test

# 3. 实现功能
claude "根据测试文件，实现 src/api/auth.ts，使所有测试通过"

# 4. 验证
npm test

测试覆盖率

claude "分析 coverage 报告，指出未覆盖的代码行并建议测试用例"

9. Docker / CI/CD 集成

GitHub Actions + Claude Code

# .github/workflows/claude-review.yml
name: Claude Code Review
on:
  pull_request:
    types: [opened, synchronize]

jobs:
  review:
    runs-on: ubuntu-latest
    env:
      ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
    steps:
      - uses: actions/checkout@v4
      - uses: anthropics/claude-code-action@v1
        with:
          command: "/review"

自动生成 Changelog

on:
  push:
    branches: [main]
jobs:
  changelog:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - name: Generate changelog
        uses: anthropics/claude-code-action@v1
        with:
          command: "基于 git log 生成 CHANGELOG.md"

10. 团队协作最佳实践

共享技能与配置

project-root/
├── .claude/
│   ├── skills/           # 团队共享技能（版本控制）
│   ├── mcp.json          # 团队 MCP 配置
│   └── workflows/        # 工作流定义
├── CLAUDE.md             # 项目级配置
└── AGENTS.md             # 多角色定义

所有文件纳入 Git，新成员 clone 后即可获得一致体验。

统一代码生成规范

通过技能系统固化团队规范，创建 team-standard 技能包含：命名规范、文件结构、JSDoc 要求、异常处理模式。

每周复盘

使用 claude --export-session 导出本周开发对话，分享关键决策和学到的新技巧。

总结: 从配置完善（CLAUDE.md）→ 技能定制 → 工作流自动化三条路线进阶，可将 Claude Code 从"编码工具"提升为"项目搭档"。