Claude Code技术分享

Claude Code 深度解析：从 AI 代码补全到真正的智能开发协作者

本文面向有一定开发经验的工程师，系统介绍 Claude Code 的核心优势、关键功能和实战技巧。

---

一、Claude Code 是什么？

Claude Code 是 Anthropic 官方推出的命令行 AI 编程助手（CLI），2025 年正式发布并快速成为许多开发者的主力工具。

它和你用过的大多数 AI 编程工具有本质区别：它不只是给你建议代码，而是真正地执行任务。

# 安装
npm install -g @anthropic-ai/claude-code

# 在项目目录启动
cd your-project
claude

启动后，你就得到了一个能读写文件、运行命令、搜索代码库、调用外部工具的 AI 开发伙伴。

---

二、核心优势：为什么它不一样？

2.1 从"代码补全"到"任务执行"

这是 Claude Code 最本质的差异。

工具类型	传统 AI 工具（Copilot 等）	Claude Code
工作方式	实时代码补全 / 单次建议	自主规划并执行多步骤任务
执行能力	无（只生成文本/代码）	完整（读写文件、运行命令、提交代码）
上下文范围	当前文件或片段	整个代码库
工具扩展	有限的 IDE 插件	MCP 协议（无限扩展）
团队配置	基本无	配置纳入 Git，团队共享
运行环境	强依赖 IDE	纯 CLI，服务器/Docker/CI 均可

举个实际例子，同样是"给项目加一个 JWT 认证模块"这个需求：

• 传统 AI 工具：给你一段代码示例，你自己创建文件、集成到项目、跑测试
• Claude Code：自己分析项目结构 → 创建相关文件 → 写实现代码 → 运行测试 → 修复问题 → 完成

2.2 全代码库上下文理解

Claude Code 会自动扫描项目，真正理解你的代码架构。配合 CLAUDE.md 文件，它能知道：

• 项目的技术栈和版本
• 代码规范（命名方式、文件结构）
• 禁止操作的边界（不要碰遗留代码、不操作生产数据库）
• 常用命令的正确写法

2.3 原生工具集

Claude Code 自带一套高效工具（这些工具也是 Claude 在内部执行任务时使用的）：

工具	功能
Bash	执行任意 shell 命令
Read	读取文件内容
Write / Edit	创建或修改文件
Glob	按模式匹配文件
Grep	基于 ripgrep 的代码搜索
WebFetch	抓取网页（读文档、查 API）
Agent	启动子代理并行执行子任务

---

三、CLAUDE.md：与项目建立"默契"

CLAUDE.md 是 Claude Code 理解项目的核心文件，放在项目根目录，每次启动 Claude Code 都会自动加载。

好的 CLAUDE.md 能让 AI 的表现提升一个数量级。

# 快速生成初始 CLAUDE.md
claude
/init

推荐的 CLAUDE.md 结构

# 项目名称：my-saas-app

## 技术栈
- 后端：Node.js 20 + Express + TypeScript
- 数据库：PostgreSQL 15 + Prisma ORM
- 前端：React 18 + Vite + Tailwind CSS
- 测试：Vitest + Testing Library

## 代码规范
- 函数命名：camelCase
- 文件命名：kebab-case
- 组件命名：PascalCase
- 使用 async/await，禁止 Promise.then 链式调用
- 所有公共函数必须有 JSDoc 注释

## 常用命令
- 开发服务器：`npm run dev`
- 运行测试：`npm test`
- 代码检查：`npm run lint`
- 数据库迁移：`npx prisma migrate dev`
- 构建：`npm run build`

## 目录结构
- API 路由：`src/routes/`
- 业务逻辑：`src/services/`
- 数据模型：`prisma/schema.prisma`
- 测试文件：与源文件同目录，`.test.ts` 后缀

## 禁止操作
- 不要修改 `legacy/` 目录（遗留代码，等待下线）
- 不要直接连接 production 数据库
- 提交前必须通过所有测试
- 不要使用 `git push --force`

CLAUDE.md 也支持多层级：

~/.claude/CLAUDE.md          # 个人全局偏好（所有项目生效）
./CLAUDE.md                  # 项目根目录（提交到 Git，团队共享）
./src/CLAUDE.md              # 子目录（针对特定模块的补充说明）

---

四、Slash Commands：高效交互的核心

在 Claude Code 中输入 / 即可触发命令。

4.1 内置核心命令

/init          初始化项目，生成 CLAUDE.md（新项目必做第一步）
/clear         清空对话上下文（节省 token）
/compact       压缩历史对话为摘要（长任务中保持效率）
/cost          查看当前 session 的 token 用量和费用
/model         切换 Claude 模型（Opus/Sonnet/Haiku）
/config        查看和修改配置
/memory        查看和编辑持久化记忆
/review        代码审查（需 GitHub 集成）
/status        查看当前状态

4.2 自定义命令（Skills）

这是 Claude Code 被严重低估的功能。你可以把常用的复杂任务封装成一个命令：

创建自定义命令：

.claude/
└── commands/
    ├── deploy.md        → /deploy
    ├── code-review.md   → /code-review
    └── daily-report.md  → /daily-report

示例：commands/deploy.md

将当前项目部署到 $ARGUMENTS 环境。

执行步骤：
1. 运行 `npm test` 确保所有测试通过
2. 运行 `npm run build` 构建生产版本
3. 检查 git 状态，确认没有未提交的变更
4. 根据环境执行对应的部署脚本：
   - staging: `./scripts/deploy-staging.sh`
   - production: `./scripts/deploy-prod.sh`
5. 验证部署结果，访问健康检查接口
6. 汇报部署状态

使用时：/deploy staging 或 /deploy production

示例：commands/code-review.md

对当前 git diff（或 $ARGUMENTS 指定的文件）进行代码审查。

审查维度：
1. 逻辑错误和潜在 Bug
2. 安全漏洞（SQL 注入、XSS、未授权访问等）
3. 性能问题（N+1 查询、不必要的循环等）
4. 代码规范（参考 CLAUDE.md 中的规范）
5. 测试覆盖是否充分

输出格式：按严重程度（Critical / Warning / Suggestion）分类列出问题。

---

五、Hooks：把 AI 操作嵌入工作流

Hooks 是 Claude Code 最强大、最容易被忽视的功能。它允许你在特定事件发生时自动执行脚本——不需要 Claude 记住，是 harness 层面的自动化。

5.1 Hook 触发时机

Hook 类型	触发时机
PreToolUse	Claude 调用工具之前
PostToolUse	Claude 调用工具之后
Stop	Claude 停止响应时
Notification	发送通知时

5.2 配置方式

在 .claude/settings.json（项目级）或 ~/.claude/settings.json（全局）中配置：

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Write",
        "hooks": [
          {
            "type": "command",
            "command": "prettier --write $CLAUDE_TOOL_INPUT_FILE_PATH"
          }
        ]
      }
    ],
    "Stop": [
      {
        "hooks": [
          {
            "type": "command",
            "command": "notify-send 'Claude Code' '任务已完成'"
          }
        ]
      }
    ]
  }
}

5.3 实战 Hook 配置

场景一：写完文件自动格式化 + Lint

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Write|Edit",
        "hooks": [
          {
            "type": "command",
            "command": "prettier --write $CLAUDE_TOOL_INPUT_FILE_PATH 2>/dev/null; eslint --fix $CLAUDE_TOOL_INPUT_FILE_PATH 2>/dev/null; true"
          }
        ]
      }
    ]
  }
}

场景二：记录 Claude 执行的所有命令（审计日志）

{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Bash",
        "hooks": [
          {
            "type": "command",
            "command": "echo \"[$(date '+%Y-%m-%d %H:%M:%S')] CMD: $CLAUDE_TOOL_INPUT_COMMAND\" >> ~/.claude/audit.log"
          }
        ]
      }
    ]
  }
}

场景三：长任务完成后发送系统通知（macOS）

{
  "hooks": {
    "Stop": [
      {
        "hooks": [
          {
            "type": "command",
            "command": "osascript -e 'display notification \"Claude 已完成任务\" with title \"Claude Code\" sound name \"Glass\"'"
          }
        ]
      }
    ]
  }
}

---

六、MCP：无限扩展 AI 的能力边界

MCP（Model Context Protocol）是 Anthropic 主导的开放协议，让 Claude Code 可以接入任意外部工具和数据源。

6.1 MCP 能做什么？

Claude Code
    ├── 直连 PostgreSQL → 查询数据库，辅助写迁移脚本
    ├── 连接 GitHub API → 操作 PR、Issues、Actions
    ├── 连接 Slack → 发消息、读频道历史
    ├── 控制浏览器 → 自动化测试、截图
    └── 自定义内部工具 → 接入公司的任何系统

6.2 配置 MCP Server

// ~/.claude/settings.json
{
  "mcpServers": {
    "postgres": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-postgres"],
      "env": {
        "DATABASE_URL": "postgresql://localhost/mydb"
      }
    },
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_TOKEN": "ghp_your_token"
      }
    },
    "browser": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-puppeteer"]
    }
  }
}

配置后，Claude Code 就能直接操作这些工具，你可以这样问它：

"查一下数据库里最近 7 天注册的用户数，按天分组，并创建一个 Markdown 格式的分析报告"

6.3 常用 MCP Server

MCP Server	用途
server-postgres / server-sqlite	数据库操作
server-github	GitHub 全功能操作
server-filesystem	扩展文件系统访问
server-puppeteer	浏览器自动化
server-slack	Slack 集成
server-brave-search	网络搜索

6.4 MCP 作用域管理

作用域	配置位置	是否提交 Git
全局	~/.claude/settings.json	否（个人配置）
项目团队	.claude/settings.json	是
本地覆盖	.claude/settings.local.json	否（加入 .gitignore）

---

七、权限模型：安全地给 AI 放权

Claude Code 默认每次危险操作都会询问确认，但你可以通过权限配置精细化控制。

7.1 权限配置

// .claude/settings.json（项目级，提交 Git）
{
  "permissions": {
    "allow": [
      "Bash(npm run *)",
      "Bash(git add *)",
      "Bash(git commit *)",
      "Bash(npx prisma *)",
      "Write(src/**)",
      "Write(tests/**)"
    ],
    "deny": [
      "Bash(git push --force*)",
      "Bash(npm publish)",
      "Bash(rm -rf *)",
      "Write(.env*)"
    ]
  }
}

规则说明：

• deny 优先级高于 allow
• 支持 glob 模式，如 Bash(npm *) 匹配所有 npm 命令
• 可以限制到具体参数，如 Bash(git commit *) 只允许 commit

7.2 非交互模式（CI/CD）

# 在 CI 环境中使用，跳过交互确认
claude --print "检查这个提交是否有安全问题" < git_diff.txt

# 管道使用
cat error.log | claude --print "分析这个错误的根本原因并给出修复方案"

# 结合权限，完全自动化
claude --allowedTools "Bash(npm test),Read" --print "运行测试并报告失败用例"

---

八、实战开发技巧

8.1 上下文管理

问题：长对话中 token 消耗大，影响响应速度和成本。

解决方案：

# 阶段性压缩，保留摘要继续工作
/compact

# 完成一个独立任务后清空，重新开始
/clear

# 随时查看消耗
/cost

技巧：把大任务拆成独立的阶段，每个阶段结束后 /compact，而不是一个 session 做完所有事情。

8.2 文件引用（@ 语法）

# 在对话中精准引用文件
请分析 @src/services/user.service.ts 和 @src/models/user.model.ts 之间的依赖关系，看看有没有循环依赖问题

8.3 复杂任务的"任务文件"模式

对于需求复杂的任务，先写一个 Markdown 任务文件，再让 Claude 执行：

<!-- task-auth.md -->
# 任务：添加 JWT 认证模块

## 目标
为现有 Express API 添加完整的 JWT 认证系统。

## 需求
1. 登录接口：POST /auth/login，返回 access_token（1h）和 refresh_token（7d）
2. 刷新接口：POST /auth/refresh，用 refresh_token 换新 access_token
3. 中间件：authMiddleware，验证 Bearer token
4. 角色权限：admin 和 user 两种角色
5. 测试覆盖率 > 80%

## 约束
- 使用现有的 User 模型（src/models/user.model.ts）
- 不破坏现有 /users 接口的行为
- token 密钥从环境变量 JWT_SECRET 读取

## 参考实现
可以参考 src/services/ 目录下现有服务的代码风格

claude "请按照 task-auth.md 的要求实现功能"

8.4 善用 Plan Mode（计划模式）

对于复杂任务，让 Claude 先制定计划再执行，避免方向偏差：

先分析项目结构，制定一个重构 src/utils/ 目录的计划，列出每个步骤和潜在风险，等我确认后再开始执行。

8.5 并行子任务

对于大规模重构，可以让 Claude 启动多个子 Agent 并行处理：

项目有 20 个 API 文件需要从 CommonJS 迁移到 ESM 格式。请使用子代理并行处理，每批处理 5 个文件，最后汇总报告迁移结果和遇到的问题。

8.6 团队协作配置

推荐的目录结构（提交到 Git 的部分）：

project/
├── CLAUDE.md                        # 项目说明（必须提交）
├── .claude/
│   ├── settings.json                # 团队共享权限和 MCP（提交）
│   ├── settings.local.json          # 个人本地配置（加入 .gitignore）
│   └── commands/                   # 团队共享自定义命令（提交）
│       ├── deploy.md
│       ├── code-review.md
│       └── generate-report.md
└── ...

.gitignore 中加入：

.claude/settings.local.json

---

九、键盘快捷键速查

快捷键	功能
Shift + Enter	多行输入（不立即发送）
↑ / ↓	浏览历史命令
Ctrl + C	中断当前 AI 操作
Ctrl + L	清屏
Tab	自动补全命令和路径
Esc	取消当前输入

---

十、总结：Claude Code 代表的范式转变

回顾整篇文章，Claude Code 的价值不只是"更好的 AI 编程工具"，而是对开发协作方式的根本性重构：

维度	传统模式	Claude Code 模式
AI 角色	代码建议者	任务执行者
上下文	单文件片段	整个代码库
可扩展性	固定工具集	MCP 无限扩展
自动化	手动触发	Hooks 自动嵌入工作流
团队协作	各自配置	配置纳入 Git 共享
运行环境	IDE 独占	CLI（本地/服务器/CI 均可）

上手建议：

1. 第一天：安装 Claude Code，在项目中运行 /init 生成 CLAUDE.md，感受全代码库上下文的差异
2. 第一周：为常用的重复性任务创建自定义命令（如代码审查、部署）
3. 第一个月：配置 Hooks 自动化（格式化、通知），接入 MCP Server（数据库、GitHub）

---

如果你正在评估要不要切换到 Claude Code，建议找一个真实的业务任务实际跑一次，而不只是看它能不能写出正确的代码片段——这个体验的差异是语言难以描述的。

---

参考资源：

• Claude Code 官方文档
• MCP 协议规范
• Claude Code GitHub