Claude Code 最佳实践：从"氛围编程"到智能体工程

Claude Code 最佳实践：从"氛围编程"到智能体工程

原文来源：GitHub - shanraisshan/claude-code-best-practice 核心理念：从随意的"感觉对就行"式编程，进化为系统化的 AI 智能体工程实践

---

一、核心观点

• Claude Code 不只是一个代码补全工具，而是一个可以编排多智能体、执行复杂工作流的工程平台
• 通过合理配置 Subagents / Commands / Skills / Hooks / MCP 等核心机制，可以将 Claude Code 打造成高度自动化的开发助手
• "Practice makes Claude perfect"------系统化的最佳实践积累是提升 AI 工程能力的关键路径
• 该仓库将 Claude Code 的所有核心特性进行分类整理，并区分为三个维度：A（Agents）、C（Commands）、S（Skills）

---

二、关键信息

2.1 三大核心概念

符号	概念	存储位置	说明
A	Subagents（子智能体）	.claude/agents/*.md	可独立执行特定任务的专属代理
C	Commands（命令）	.claude/commands/*.md	自定义的斜杠命令，触发预设行为
S	Skills（技能）	.claude/skills/*/SKILL.md	可复用的能力模块，支持 mono-repo

---

2.2 核心功能体系

🧠 基础概念层

功能	位置	核心作用
Workflows（工作流）	.claude/commands/weather-orchestrator.md	多步骤任务编排
Hooks（钩子）	.claude/hooks/	事件驱动的自动化触发
MCP Servers	.claude/settings.json, .mcp.json	模型上下文协议，扩展外部能力
Memory（记忆）	CLAUDE.md, .claude/rules/, ~/.claude/rules/	持久化上下文，跨会话记忆
Settings（配置）	.claude/settings.json	权限/模型/沙盒/快捷键等全局配置
Plugins（插件）	可分发包	支持插件市场，能力扩展
Checkpointing（检查点）	自动（文件编辑追踪）	防止意外丢失，支持回滚
CLI Startup Flags	claude [flags]	启动参数控制行为模式

---

🔥 热门/前沿特性

功能	启用方式	亮点
Ultrareview 🔵	/code-review ultra	超强代码审查，支持任务追踪
Ultraplan 🔵	/ultraplan	超级规划模式
Auto Mode 🔵	--permission-mode auto / Shift+Tab	消除确认提示，全自动运行
Fast Mode 🔵	/fast / "fastMode": true	极速响应模式
Advisor 🔵	/advisor / --advisor	双模型策略：一个建议，一个执行
Computer Use 🔵	computer-use MCP server	让 Claude 直接操控桌面
Agent Teams 🔵	内置（环境变量）	多智能体协作团队
Agent View 🔵	claude agents / --bg / /bg	可视化查看后台智能体
Scheduled Tasks	/loop / /schedule	定时任务，支持 cron 语法
Dynamic Workflows	/workflows / ultracode / .claude/workflows/	动态工作流，含深度研究模式
Remote Control	/remote-control / /rc	远程控制 Claude，支持无头模式
GitHub Actions	.github/workflows/	CI/CD 集成，也支持 GitLab
Code Review 🔵	GitHub App / /code-review	自动 PR 代码审查
Chrome 集成 🔵	--chrome / 扩展	浏览器内操作与 DevTools 对比
Claude Code Web 🔵	claude.ai/code	网页版 Claude Code，支持 Routines
Slack 集成	@Claude in Slack	在 Slack 中直接调用
Agent SDK	npm / pip 包	开发者 SDK，程序化接入
Ralph Wiggum Loop	plugin	自进化循环插件
Deep Links	claude-cli://open?repo=...&q=...	深度链接，快速定位项目
No Flicker Mode 🔵	/tui fullscreen / CLAUDE_CODE_NO_FLICKER=1	无闪烁全屏模式
Devcontainers	.devcontainer/	容器化开发环境
Channels 🔵	--channels / 插件化	多频道消息路由
Routines 🔵	claude.ai/code/routines / /schedule	周期性例行任务

🔵 = Beta 功能

---

2.3 记忆（Memory）系统的文件层次

~/.claude/rules/          ← 全局用户级规则（跨所有项目生效）
~/.claude/projects/*/memory/  ← 项目级自动记忆
CLAUDE.md                 ← 项目根目录记忆文件（最常用）
.claude/rules/            ← 项目级规则目录

记忆机制优先级：局部规则 > 项目记忆 > 全局规则

---

2.4 配置文件结构示例

// .claude/settings.json 示例结构
{
  "model": "claude-opus-4-5",
  "fastMode": false,
  "advisorModel": "claude-sonnet-4-5",
  "permissions": {
    "allow": ["Bash", "Read", "Write"],
    "deny": []
  },
  "outputStyle": "verbose",
  "keybindings": {}
}

<!-- CLAUDE.md 示例 -->
# 项目记忆

## 技术栈
- Node.js + TypeScript
- PostgreSQL

## 编码规范
- 使用 ESLint + Prettier
- 所有函数必须有 JSDoc 注释

## 禁止行为
- 不得直接删除数据库记录

---

2.5 工作流编排示例（Orchestration）

<!-- .claude/commands/weather-orchestrator.md -->
# Weather Orchestrator

## 任务目标
获取天气数据并生成每日报告

## 步骤
1. 调用天气 API 获取数据（使用 fetch-agent）
2. 解析并格式化数据（使用 parser-skill）
3. 生成 Markdown 报告（使用 report-command）
4. 发送到 Slack 频道

---

三、个人启发

1. 配置即代码的理念 ：整个 Claude Code 的行为都可以通过 .claude/ 目录下的配置文件精确控制，这与 Infrastructure as Code 的思维高度一致------把 AI 的"行为约束"也纳入版本管理。

2. 能力分层设计很关键：Subagents（独立执行者）+ Commands（触发接口）+ Skills（可复用能力）三层架构，避免了单一巨型提示词的混乱，每层职责清晰，可独立迭代。

3. Auto Mode 是质变点 ：从需要逐步确认到 --permission-mode auto 全自动运行，标志着 Claude Code 从"工具"演变为真正意义上的"自主智能体"，这对无人值守的 CI/CD 场景意义重大。

4. 记忆系统是持续学习的基础 ：通过 CLAUDE.md 和 .claude/rules/ 的多层记忆机制，可以让 Claude "记住"项目约定，避免在每次对话中重复解释上下文，大幅提升协作效率。

---

四、延伸思考

1. 智能体工程的"人机边界"应该划在哪里？ 当 Auto Mode 可以消除所有确认提示时，人类开发者在何种场景下仍然需要保留手动干预权？是否需要为不同风险级别的操作（只读 vs 写入 vs 删除）设计不同的自动化策略？

2. 多智能体协作如何避免"上下文污染"与决策冲突？ Agent Teams 功能支持多个子智能体协作，但当不同 Subagent 基于各自的局部视角做出相互矛盾的决策时，编排层（Orchestrator）应该遵循什么样的冲突解决机制？这与微服务中的"事件溯源"模式有何异同？

3. Claude Code 的能力边界扩展是否会导致"提示注入"安全风险的指数级增长？ 随着 Computer Use、Chrome 集成、Remote Control 等功能的开放，Claude 获得了越来越强的环境感知与操控能力。在开放给外部 MCP Server 或插件时，如何防范恶意内容通过提示注入操控 Claude 执行危险操作？这是当前 AI 工程最值得深思的安全命题之一。