Claude Code 配置
🎯 学习目标
- 编写 CLAUDE.md 作为项目级持久上下文
- 配置 Skills 与工具权限（读 / 写 / Bash）
- 理解 Hooks 与多会话 / 子任务协作
引言
Claude Code（Anthropic 终端 Agent）适合 仓库级自动化：批量改文件、跑测试、开 PR。配置以 CLAUDE.md 和 .claude/ 为中心，强调权限边界与可审计命令。
章节正文
第 1 步：CLAUDE.md（项目记忆）
放在 仓库根目录，Claude Code 启动时自动加载。
建议结构：
markdown
# 项目说明
## 技术栈
- Node 20 + VitePress 静态站
## 命令
- 开发：npm run dev
- 构建：npm run build
## 约定
- 不修改 website/ 下 generated 文件，改 scripts/sync-*.mjs
- commit 前运行 npm run build与 Cursor Rules 内容可重叠，但 CLAUDE.md 偏「事实与命令」，Rules 偏「行为约束」。大 monorepo 可在子目录再放 CLAUDE.md 覆盖局部上下文。
第 2 步：Skills
路径：.claude/skills/<name>/SKILL.md 或用户级配置目录（以当前 Claude Code 文档为准）。
Skill 适用：
- 固定发布流程（sync → build → 检查 dist）
- 按模板写日报 / 文档
- 安全审查 checklist
编写要点：description 写清 触发词；步骤可执行、可验证；避免一步包打天下。
第 3 步：权限与安全
Claude Code 会请求 读文件、写文件、执行 Bash。团队应：
- 在 CLAUDE.md 标明 禁止 的命令（如
rm -rf、git push --force） - 敏感目录只读：
.env、credentials/ - 使用
/permissions或配置文件预批准常用命令（依版本而定）
与第七章「安全护栏」一致：Agent 能力越大，默认 deny 越多。
第 4 步：Hooks（可选）
Hooks 在 Agent 生命周期的固定点执行脚本，例如：
- 提交前自动
npm run lint - 会话结束写 trace 日志
配置位置见官方 Hooks 文档（通常在 .claude/settings.json 或项目配置中）。适合把团队 CI 规则前移到本地 Agent。
第 5 步：Multi-Agent / 子任务
Claude Code 常见模式：
- 单会话串行：规划 → 执行 → 验证（默认）
- 显式拆 prompt：「先只搜索不改文件，给出方案后再实施」
- Background / 并行（若版本支持）：长任务放后台，主会话继续
在 AGENTS.md 中定义角色示例：
markdown
## Explorer
- 只读 ripgrep / read，输出文件清单与调用链
## Implementer
- 按 Explorer 报告改代码，跑 npm test
## Reviewer
- 只看 git diff，按安全与风格 checklist 评论主会话 prompt 引用：按 AGENTS.md 的 Reviewer 角色审查本次 diff。
第 6 步：与 Cursor 共存
| 文件 | Cursor | Claude Code |
|---|---|---|
.cursor/rules/ | ✅ | ❌ |
CLAUDE.md | 可选参考 | ✅ |
.claude/skills/ | ❌ | ✅ |
AGENTS.md | 可选 | ✅ |
可用脚本或文档同步 约定段落，避免两套标准打架。
小结
- Claude Code 锚点：CLAUDE.md + Skills + 权限 + Hooks
- 适合终端批处理；Multi-Agent 用 prompt + AGENTS.md 角色分工实现