Claude Code 高阶玩法：多 Agent、自定义配置与项目级自动化

Zhaobin Claude Code

玩了俩月，该进阶了

前面几篇咱们聊了入门、命令、Skill。如果你已经跟着上手了，那现在该聊聊怎么让 Claude Code 真正融入你的工作流了。这篇全是硬核内容。

1. claude_code.yml — 一个文件管所有配置

在项目根目录创建 claude_code.yml（或者 .claude/config.yml），你可以做很多事情：

# claude_code.yml
project:
  name: "my-awesome-app"
  tags: ["react", "node", "typescript"]

commands:
  test: "npm run test"
  build: "npm run build"
  lint: "npm run lint"

review:
  focus: ["performance", "security"]
  language: "zh-CN"

plan:
  step_by_step: true

配置了之后，Claude Code 会自动读这些设置。你让它跑测试，它就知道执行 npm run test 而不是自己猜。你让它 review，它就知道重点关注性能和安全。

2. 多 Agent 协作模式

一个项目可能有前端、后端、数据库、DevOps 多个领域。一个 AI 同时处理所有事，容易"串味"。

Claude Code 支持多 Agent 模式——你可以为不同上下文启动不同的 Agent 实例：

  • 前端 Agent： 在 client/ 目录里跑，配 React/TypeScript 规范
  • 后端 Agent： 在 server/ 目录里跑，配 Node.js/Express 规范
  • DevOps Agent： 在根目录，专管 Docker/CICD 配置

每个 Agent 有自己的 CLAUDE.md 和自己的上下文，不会"记混"。你可以同时开三个终端窗口，各管各的，效率拉满。

3. CLAUDE.md — 项目级规范文件

这个我们上篇提了一嘴，但真正常用的方式其实更丰富：

# CLAUDE.md
## 项目技术栈
- 前端: React 18 + TypeScript + Tailwind CSS
- 后端: Node.js + Express + Prisma
- 数据库: PostgreSQL
- 测试: Vitest + Playwright

## 代码风格
- 使用 Prettier 格式化
- 使用 ESLint
- 命名: 组件用 PascalCase，函数用 camelCase
- CSS: 优先用 Tailwind 类，少写自定义 CSS

## 注意事项
- 不要修改 database/schema.prisma 除非明确要求
- API 路由在 src/routes/ 下定义
- 所有新 API 都需要加 rate limiter

有了这个文件，每次对话 Claude Code 都会自动参考。你不需要每次都说一遍"咱们项目用的啥技术栈"，它看了 CLAUDE.md 就全知道了。

4. 环境变量与 API 密钥管理

Claude Code 支持读取 .env 文件，但更推荐的做法是：

# .claude/env
MY_API_KEY=xxx
DATABASE_URL=postgres://...

.claude/ 里的内容不要提交到 git（记得加 .gitignore）。这样你的密钥安全，Claude Code 又能用到真实的环境变量来运行测试和调试。

5. .claudeignore — 有些文件不想让 AI 碰

类似 .gitignore，但针对的是 AI：

# .claudeignore
node_modules/
dist/
*.min.js
*.log
vendor/
__pycache__/

告诉 Claude Code："这些文件夹不用管，省得浪费 token 也省得混淆。" 尤其是 node_modules 动辄几万个文件，不忽略的话 Claude 理解起来会非常吃力。

真实案例：前后端项目配置

我有个项目是 monorepo 结构，前端和后端各有各的规范：

my-app/
├── client/           # 前端
│   ├── .claude/
│   │   └── config.yml  # 只配前端规则
│   └── CLAUDE.md       # React 规范
├── server/           # 后端
│   ├── .claude/
│   │   └── config.yml  # 只配后端规则
│   └── CLAUDE.md       # Node.js 规范
└── CLAUDE.md         # 全局项目描述

这样不管在哪个目录启动 claude，它都知道当前上下文是前端还是后端，规范不会串。

总结一下

配置是"一次投资、长期回报"。花半小时配好 claude_code.yml 和 CLAUDE.md，以后每次用 Claude Code 都更精准、更高效。

下一篇聊我写了三个月代码总结出来的铁律——干货中的干货，别错过。

comments powered by Disqus