Claude Code 进阶技巧：CLAUDE.md 与 MCP 配置实战

覆盖热词：claude code claude.md（10🟢）| claude code mcp（10🟢）| claude code 进阶（10🟢）

为什么需要进阶？

基础用法很简单：装好 Claude Code，在项目里打开终端，开始聊天。但如果你只用这个模式，你只发挥了 Claude Code 30% 的能力。

真正的效率来自两样东西：

1. CLAUDE.md — 让 Claude 了解你的项目规则
2. MCP 工具 — 让 Claude 能调用外部服务

CLAUDE.md：让 Claude 懂你的项目

它解决什么问题

每次启动 Claude Code，它要自己读一遍你的代码来理解项目。如果项目很大，它可能猜错你的偏好：

• 你用 TypeScript 还是 JavaScript？
• 你习惯 async/await 还是 Promise？
• 你的测试框架是 Vitest 还是 Jest？
• API 风格是 REST 还是 GraphQL？

CLAUDE.md 就是一份给 Claude 看的项目说明文件。 放在项目根目录，Claude 每次启动都会自动读取。

写一份 CLAUDE.md

# 项目规范

## 技术栈
- 前端：React 18 + TypeScript + TailwindCSS
- 后端：Node.js + Express + SQLite
- 测试：Vitest

## 代码风格
- TypeScript 严格模式
- 函数式组件 + Hooks
- async/await 优先
- 80 列换行

## 命名规范
- 组件：PascalCase
- 函数/变量：camelCase
- 常量：UPPER_SNAKE_CASE
- 文件：kebab-case

## 目录结构
src/
  components/    # UI 组件
  hooks/         # 自定义 Hooks
  utils/         # 工具函数
  types/         # 类型定义
  pages/         # 页面组件

保存到项目根目录的 CLAUDE.md 文件。下次启动 Claude Code 时，它自动遵守这些规则。

项目全局 vs 用户全局

CLAUDE.md 有两个层级：

用户级最有用：把你所有项目通用的偏好写进去，比如：

# 通用偏好

- 如果项目没有 README，先帮我创建一个
- 安装依赖时优先用 npm，没有 package.json 才用 pip
- 代码中加必要注释，不画蛇添足
- 提交信息用 Conventional Commits 格式
- 中文注释，英文变量名

实战效果对比

没有 CLAUDE.md：

你：帮我加一个用户登录功能
Claude：好的，我创建一个 login.php 文件...
你：？？？我用的是 Next.js

有 CLAUDE.md：

你：帮我加一个用户登录功能
Claude：（读取 CLAUDE.md → Next.js + TypeScript）
好的，我在 src/pages/api/auth/ 下创建登录接口...

MCP 工具：让 Claude 能动手

MCP 是什么

MCP（Model Context Protocol）是 Anthropic 推出的工具协议。简单说：它让 Claude Code 能调用外部服务——查数据库、读文件、发请求、运行脚本。

没有 MCP： Claude 只能读写你项目里的文件。 有了 MCP： Claude 可以去查文档、调 API、读数据库。

配置 MCP

在项目根目录创建 .claude/settings.json：

{
  "mcpServers": {
    "sqlite": {
      "command": "uvx",
      "args": ["mcp-server-sqlite", "--db-path", "./data.db"]
    },
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@anthropic/mcp-server-filesystem", "./data"]
    }
  }
}

常用 MCP 场景

场景 1：查数据库

配好 SQLite MCP 后，直接在 Claude Code 里说：

查一下 users 表，看看最近一周注册的用户有多少。

Claude 会自动连接 SQLite，执行 SQL，返回结果。

场景 2：读外部文档

帮我去查一下 Express 的最新中间件用法，
然后检查我的项目里有没有需要更新的地方。

场景 3：调外部 API

配上 HTTP MCP：

调用天气 API（https://api.openweathermap.org/...），
根据返回值判断明天要不要带伞，然后在我的首页加一个天气提示组件。

推荐 MCP 服务器

安装方式：

# 安装 uv（如果还没装）
curl -LsSf https://astral.sh/uv/install.sh | sh

# 然后配置到 .claude/settings.json 里

进阶工作流

1. 项目初始化模板

创建一个 template/ 目录，里面放好：

template/
  CLAUDE.md       # 项目规范
  .claude/
    settings.json  # MCP 配置
  README.md        # 给人类看的说明

新项目直接复制进去，Claude 自动遵守规则。

2. 自定义命令

在 .claude/commands.json 里定义快捷命令：

{
  "test": "运行测试并检查覆盖率",
  "deploy": "构建并部署到 Vercel",
  "review": "审查我上次提交后的所有改动"
}

之后直接在 Claude Code 里输入：

/test

Claude 就会执行定义好的测试流程。

3. 项目上下文分片

大项目里，用 @ 引用特定文件：

帮我优化 @src/utils/api.ts 里的请求逻辑，
参考 @src/types/api.ts 里的类型定义。

Claude 会把这两个文件作为重点上下文。

注意事项

1. CLAUDE.md 不是万能的

Claude 会参考它，但不是 100% 遵守。复杂规则它可能记住一会儿就忘了。 解决办法： 把最关键的规则写在 CLAUDE.md 开头，重要的多提几次。

2. MCP 服务器要自己启动

配置好 settings.json 后，MCP 服务器不会自动启动。首次使用相关功能时 Claude 会提示你启动。

3. 安全考虑

MCP 给了 Claude 很大的权限——文件读写、数据库操作、API 调用。生产环境的数据库不要暴露给 MCP。

总结

CLAUDE.md 让 Claude 从"猜你想要什么"变成"他知道你想要什么"。 MCP 让 Claude 从"只能改代码"变成"能操作数据库、调 API、查文档"。

两个一起用，Claude Code 才算是真正进入了"高级模式"。

🔗 相关文章： Claude Code 完整教程：从安裝到配置 | Claude Code 实战：10分钟用AI搭建一个网页应用

📚 Claude Code 中文开发者系列（持续更新中） → Claude Code vs Cursor vs Aider：三个AI编程工具的真实对比 → Anthropic悄悄更新了Claude 4 Sonnet → Claude Code 写了200行代码然后忘了自己在干嘛 → Claude Code 团队协作实战：CLAUDE.md统一、MCP共享、Code Review自动化 → Claude Code CI/CD 集成：GitHub Actions 自动代码审查与测试生成 → Claude Code 写测试实战：TDD、Mock、覆盖率一条龙 → Claude Code 省钱终极攻略：从月消费$200到$30 → Claude Code + 本地模型混合方案：什么时候用云端、什么时候用本地