Конфигурация разработки Claude Code
Вы когда-нибудь сталкивались с такими ситуациями?
- Каждый раз, когда вы открываете новую сессию, вам приходится заново объяснять Claude соглашения об именовании в нашем проекте
- Claude внезапно выполняет опасную команду, например удаление файлов
- Вы просите Claude провести проверку кода, а он запихивает весь проект в контекст — медленно и дорого
- Вы тщательно создали набор паттернов использования Claude, но новые коллеги понятия не имеют, как их повторно использовать
Все эти проблемы можно решить с помощью структуры под названием Agent Development Kit (ADK).
Его ядро — 5 папок. С помощью этих 5 папок мы можем превратить Claude Code в автоматизированную команду разработки с памятью, правилами, разделением труда и воспроизводимостью.
Общая структура:
你的项目/ ├── CLAUDE.md/ ← 第一层：记忆 ├── skills/ ← 第二层：知识 ├── hooks/ ← 第三层：护栏 ├── subagents/ ← 第四层：分工 └── plugins/ ← 第五层：复制
| Слой | Каталог / Файл | Назначение | Ключевое значение | Аналогия |
|---|---|---|---|---|
| Уровень 1 | CLAUDE.md/ |
Глобальные правила и центр памяти для агентов | Определяет нормы поведения ИИ, контекст проекта и ограничения разработки | Руководство по работе с ИИ-проектом |
architecture.rules |
Определение правил архитектуры | Задаёт структуру кода, соглашения об именовании и проектирование каталогов | Стандарты кодирования технической команды | |
global.md |
Глобальная общая память | Долгосрочные правила, применимые ко всем проектам | Долговременная память ИИ | |
project.md |
Память, специфичная для текущего проекта | Бизнес-контекст и особые требования текущего репозитория | Расширенная версия README проекта | |
| Уровень 2 | skills/ |
Каталог модуля навыков | Внедряет профессиональные возможности в ИИ | Библиотека навыков ИИ |
SKILL.md |
Файл описания навыка | Сообщает ИИ, когда вызывать этот навык | Руководство по спецификации навыка | |
scripts/ |
Каталог скриптов навыка | Хранит скрипты автоматизации и шаблоны | Инструментарий | |
context.md |
Контекст навыка | Предоставляет фоновые знания, необходимые во время выполнения навыка | Профессиональная база знаний | |
| Уровень 3 | hooks/ |
Система хуков | Автоматически вставляет логику проверки до и после выполнения | Автоматизированный аудит безопасности |
PreToolUse.sh |
Хук перед выполнением инструмента | Проверяет перед выполнением команд | "Подтверждение опасных операций" | |
PostToolUse.sh |
Хук после выполнения инструмента | Автоматически обрабатывает после завершения выполнения | Автоформатирование, уведомления | |
SessionStart.sh |
Хук запуска сессии | Инициализирует среду разработки | Скрипт запуска IDE | |
| Уровень 4 | subagents/ |
Каталог субагентов | Разделяется на разных специализированных агентов | Система совместной работы команды ИИ |
code-reviewer.md |
Агент проверки кода | Специализируется на проверке кода | Инженер-ревьюер | |
test-runner.md |
Агент тестирования | Автоматически запускает тесты | QA-инженер по тестированию | |
explorer.md |
Агент исследования | Анализирует структуру кодовой базы | Технический исследователь | |
| Слой 5 | plugins/ |
Система плагинов | Модуляризует и распространяет возможности | Магазин ИИ-приложений |
manifest.json |
Манифест конфигурации плагина | Определяет метаданные плагина | npm package.json | |
marketplace.url |
Адрес маркетплейса плагинов | Портал загрузки и обмена плагинами | Магазин приложений | |
team.install |
Скрипт установки для команды | Синхронизация окружения команды в один клик | Скрипт инициализации DevOps |
Каждый слой решает одну конкретную задачу; давайте разберем это ниже.
Уровень 1:CLAUDE.md— Дайте Claude долговременную память
В чём проблема?
У Claude нет памяти между сеансами. Если вы сегодня скажете ему использовать PascalCase для именования компонентов, завтра, когда начнёте новый сеанс, он это забудет.
Решение
ПоместитеCLAUDE.mdфайл в проект и запишите в него всё, что вы не хотите повторять. В начале каждого сеанса Claude автоматически читает его.
Два файла, две области действия:
| Расположение файла | Область действия |
|---|---|
~/.claude/CLAUDE.md |
На вашем компьютередля всех проектовдействует |
Корневой каталог проекта.claude/CLAUDE.md |
только дляэтого одного репозиториядействует |
Что в него записывать? Подумайте о том, что вы чаще всего повторяете Claude:
# 项目：我的电商平台 ## 技术栈 - 前端：Next.js 14（App Router） - 样式：Tailwind CSS - 数据库：PostgreSQL + Prisma ## 命名规范 - 组件文件：大驼峰，如 `UserCard.tsx` - 工具函数：小驼峰，如 `formatPrice.ts` - API 路由：短横线，如 `/api/user-profile` ## 注意事项 - 禁止使用 `any` 类型 - 所有异步函数必须有 try/catch - 提交代码前必须通过 ESLint 检查 - 不要直接操作 `main` 分支 ## 代码风格 - 缩进：2 个空格 - 引号：单引号 - 函数优先用箭头函数
Эффект:Вам больше не нужно вставлять длинное вступление с предысторией в начале каждого разговора.
Уровень 2:skills/— Сохраните свой опыт
В чём проблема?
Каждый раз, когда вы просите Claude написать новый компонент, он может делать это по-разному: иногда добавляет тесты, иногда нет; иногда есть типы TypeScript, иногда нет.
Решение
Запишите стандартные практики в файлы навыков и поместите их вskills/каталог. Claude, исходя из описания вашей задачи,автоматически подберёт и вызоветсоответствующий навык; вам не нужно вводить никакие команды.
Структура каталога:
skills/ ├── SKILL.md ← 技能索引（描述 + 触发条件） ├── create-component.md ← 创建 React 组件的标准流程 ├── write-api.md ← 写接口的标准流程 └── fix-bug.md ← 排查 Bug 的标准流程
Как выглядит файл навыка?
---
name: create-react-component
description: >
当用户说"创建组件"、"新建页面"、"写一个 UI"时，
自动调用此技能。
---
# 创建 React 组件的标准流程
## 步骤
1. 检查 `src/components/` 下是否已存在同名组件
2. 用大驼峰命名新建 `.tsx` 文件
3. 必须定义 TypeScript interface，不允许 any
4. 同步在 `src/stories/` 下新建对应的 Storybook 故事
5. 在 `__tests__/` 下新建单元测试文件
## 代码模板
\`\`\`tsx
interface Props {
// 在这里定义 props
}
export const ComponentName: React.FC<Props> = ({ }) => {
return <div>{/* 内容 */}</div>;
};
\`\`\`
Эффект:Вы говорите «Создай мне компонент карточки пользователя», и Claude автоматически следует стандартному процессу вашей команды, охватывая тесты, типы и документацию, ничего не упуская.
💡 Проще говоря:Это как написать инструкцию по работе для нового сотрудника; он следует инструкции, и вам не нужно присматривать за ним каждый раз.
Уровень 3:hooks/— Установите защитный барьер, который нельзя обойти
В чём проблема?
ИИ иногда выполняет операции, которых вы совершенно не хотите — например, удаляет базу данных прямо в продакшене или запускаетrm -rfкоманду. Полагаться на инструкции в промпте о том, чтобы не делать таких вещей, ненадёжно.
Решение
Хуки — этоShell-скрипты, которые автоматически запускаются до и после каждого вызова инструмента Claude. Это чистая кодовая логика, выполняемая детерминированно, и ИИ не может её обойти.
Три основных файла:
hooks/ ├── PreToolUse.sh ← 工具调用「之前」运行 ├── PostToolUse.sh ← 工具调用「之后」运行 └── SessionStart.sh ← 会话「开始时」运行
Пример PreToolUse.sh — перехват опасных команд:
#!/bin/bash # 检查 Claude 准备执行的命令 TOOL_INPUT="$2" # 禁止执行 rm -rf / if echo "$TOOL_INPUT" | grep -qE "rm\s+-rf\s+/"; then echo "已拦截：禁止执行破坏性删除命令" >&2 exit 1 fi # 禁止在没有确认的情况下操作生产数据库 if echo "$TOOL_INPUT" | grep -q "prod_db" && echo "$TOOL_INPUT" | grep -qE "DROP|DELETE"; then echo "已拦截：生产数据库的破坏性操作需要人工确认" >&2 exit 1 fi exit 0
Пример PostToolUse.sh — автоматическое форматирование после сохранения файла:
#!/bin/bash
# 每次 Claude 写完文件，自动跑 lint 和格式化
TOOL_NAME="$1"
FILE_PATH="$2"
if [ "$TOOL_NAME" = "write_file" ]; then
case "$FILE_PATH" in
*.ts|*.tsx|*.js|*.jsx)
npx eslint --fix "$FILE_PATH"
npx prettier --write "$FILE_PATH"
echo "已自动格式化：$FILE_PATH"
;;
esac
fi
Эффект:
- После того как Claude напишет код, он автоматически выполнит линтинг за вас; вам не нужно запускать его вручную.
- Опасные команды перехватываются до выполнения; вам даже не нужно смотреть.
- После завершения скрипта развёртывания он автоматически отправляет команде уведомление в Slack.
💡 Проще говоря:Это как этап контроля качества на заводской сборочной линии. Продукты принудительно проходят его перед выходом с завода; те, что не соответствуют спецификациям, сразу отправляются назад, без опоры на личное суждение рабочих.
Уровень 4:subagents/— Пусть специалисты занимаются специализированной работой
В чём проблема?
Когда Claude выполняет «код-ревью + запуск тестов + написание документации» всё в одной сессии, контекст становится всё больше и больше, всё медленнее и медленнее, а различные задачи мешают друг другу.
Решение
Распределяйте разные задачи междунезависимыми субагентами. У каждого субагента собственное независимое окно контекста и выделенные права доступа к инструментам; он делает только одну вещь и по завершении сообщает результаты.
Структура каталога:
subagents/ ├── code-reviewer.md ← 专门做代码审查 ├── test-runner.md ← 专门跑测试 └── doc-writer.md ← 专门写文档
Пример code-reviewer.md:
--- name: code-reviewer description: PR 需要代码审查时调用此代理 tools: - read_file # 只允许读文件 permissions: - read_only # 只读权限，绝对不会误操作 --- # 代码审查专用代理 你是一名资深代码审查员。你只会收到 git diff，不需要了解整个项目。 你没有写入权限，只能阅读和分析。 ## 审查清单 - [ ] 有没有硬编码的密钥或密码？ - [ ] 新函数有没有对应的单元测试？ - [ ] TypeScript 类型是否明确，有没有 any？ - [ ] 异步操作有没有错误处理？ - [ ] 有没有遗留的 console.log？ ## 输出格式 1. **总体评价**：一句话说清楚 2. **必须修改**：阻塞合并的问题 3. **建议优化**：非阻塞的改进项 4. **结论**：可以合并 / 需要修改
Общая схема работы:
你说："帮我审查这个 PR 并运行测试"
│
├──→ 调用 code-reviewer 子代理
│ 独立上下文，只看 diff，只读权限
│ 返回：结构化审查报告
│
├──→ 调用 test-runner 子代理
│ 独立上下文，有执行测试的权限
│ 返回：测试通过/失败摘要
│
└──→ 主会话汇总结果，上下文始终保持干净
💡 Простыми словами:Это как прораб. Он сам не пишет код, но у него в подчинении есть специализированные электрики, каменщики и плотники. Каждый делает свою работу, не мешая другим, а в конце прораб единообразно докладывает о прогрессе.
Слой 5:plugins/— Поделиться со всей командой в один клик
В чём проблема?
Вы потратили несколько дней на настройку всех четырёх слоёв выше, но когда приходит новый коллега, откуда он узнает об этой конфигурации? Неужели ему придётся всё настраивать заново?
Решение
Упакуйте всю систему в плагин. Новые участники выполняют одну команду и мгновенно получают точно такую же рабочую среду Claude Code, как у вас.
Структура каталога:
plugins/ ├── manifest.json ← 描述插件包含什么 ├── marketplace.url ← 分享链接 └── team.install ← 一键安装脚本
Пример team.install:
#!/bin/bash echo "🚀 正在安装团队 ADK 配置..." # 安装项目级 CLAUDE.md cp ./CLAUDE.md/project.md ./.claude/CLAUDE.md # 安装所有技能 mkdir -p ./.claude/skills && cp -r ./skills/* ./.claude/skills/ # 安装钩子（记得加执行权限） mkdir -p ./.claude/hooks && cp -r ./hooks/* ./.claude/hooks/ chmod +x ./.claude/hooks/*.sh # 安装子代理 mkdir -p ./.claude/subagents && cp -r ./subagents/* ./.claude/subagents/ echo "安装完成！Claude Code 已配置为团队模式。"
Первый день нового коллеги:
bash plugins/team.install
Готово. Он использует точно такой же Claude Code, как у вас.
💡 Простыми словами:Это как корпоративный «пакет настройки компьютера для нового сотрудника». IT-отдел создаёт образ, новые сотрудники устанавливают его в один клик, и их окружение полностью совпадает с окружением уже работающих сотрудников — не нужно ничего настраивать вручную по отдельности.
Полная блок-схема: как 5 слоёв работают вместе
开发者输入任务
│
▼
CLAUDE.md → 加载项目规范和背景知识
│
▼
skills/ → 匹配任务类型，调用对应工作流
│
▼
hooks/PreToolUse → 执行前检查，拦截危险操作
│
▼
subagents/ → 复杂任务拆分给专属子代理执行
│
▼
hooks/PostToolUse→ 执行后处理，自动格式化/通知
│
▼
plugins/ → 整套配置一键同步给所有团队成员
Сводка проблем, решённых 5 слоями
| Слой | Папка | Решаемая проблема | Аналогия |
|---|---|---|---|
| Уровень 1 | CLAUDE.md/ |
Claude каждый раз забывает конвенции проекта | Справочник сотрудника |
| Уровень 2 | skills/ |
Непоследовательный подход к одному и тому же типу задач каждый раз | Операционное руководство |
| Уровень 3 | hooks/ |
Опасные операции невозможно предотвратить | Проверка качества конвейера |
| Уровень 4 | subagents/ |
Раздувание контекста для сложных задач | Специализированное разделение труда |
| Слой 5 | plugins/ |
Конфигурацию нельзя переиспользовать в команде | Пакет онбординга нового сотрудника |
Быстрый старт: 3 вещи, которые можно сделать сегодня
Если настраивать всё сразу кажется слишком сложным, начните с пунктов с наибольшей отдачей:
Шаг 1 (5 минут):СоздайтеCLAUDE.md, и впишите весь контекст проекта, который вы чаще всего повторяете Claude.
Шаг 2 (10 минут):Создайтеhooks/PreToolUse.sh, и добавьте несколько блокирующих правил для опасных команд, которые вы меньше всего хотите позволять Claude выполнять.
Шаг 3 (30 минут):Возьмите тип задачи, который вы выполняете чаще всего (например, "создание компонентов"), и запишите его как ваш первыйskills/файл, формируя стандарты вашей команды.
Оставшиеся слои можно заполнять по ходу — не нужно делать всё сразу.
Другие расширенияЭта система называетсяAgent Development Kit（ADK）. Пять слоёв, один стек.
Вам не нужно больше инструментов — всего 5 папок.