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）系统的文件层次

bash 复制代码

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

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

2.4 配置文件结构示例

json 复制代码

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

markdown 复制代码

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

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

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

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

2.5 工作流编排示例（Orchestration）

markdown 复制代码

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

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

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

三、个人启发

配置即代码的理念 ：整个 Claude Code 的行为都可以通过 .claude/ 目录下的配置文件精确控制，这与 Infrastructure as Code 的思维高度一致------把 AI 的"行为约束"也纳入版本管理。
能力分层设计很关键：Subagents（独立执行者）+ Commands（触发接口）+ Skills（可复用能力）三层架构，避免了单一巨型提示词的混乱，每层职责清晰，可独立迭代。
Auto Mode 是质变点 ：从需要逐步确认到 --permission-mode auto 全自动运行，标志着 Claude Code 从"工具"演变为真正意义上的"自主智能体"，这对无人值守的 CI/CD 场景意义重大。
记忆系统是持续学习的基础 ：通过 CLAUDE.md 和 .claude/rules/ 的多层记忆机制，可以让 Claude "记住"项目约定，避免在每次对话中重复解释上下文，大幅提升协作效率。

四、延伸思考

智能体工程的"人机边界"应该划在哪里？ 当 Auto Mode 可以消除所有确认提示时，人类开发者在何种场景下仍然需要保留手动干预权？是否需要为不同风险级别的操作（只读 vs 写入 vs 删除）设计不同的自动化策略？
多智能体协作如何避免"上下文污染"与决策冲突？ Agent Teams 功能支持多个子智能体协作，但当不同 Subagent 基于各自的局部视角做出相互矛盾的决策时，编排层（Orchestrator）应该遵循什么样的冲突解决机制？这与微服务中的"事件溯源"模式有何异同？
Claude Code 的能力边界扩展是否会导致"提示注入"安全风险的指数级增长？ 随着 Computer Use、Chrome 集成、Remote Control 等功能的开放，Claude 获得了越来越强的环境感知与操控能力。在开放给外部 MCP Server 或插件时，如何防范恶意内容通过提示注入操控 Claude 执行危险操作？这是当前 AI 工程最值得深思的安全命题之一。