Claude Code 与 OpenClaw 实战指南：从初始化到自动化工作流

快捷键提示：

• Shift + Tab：切换权限模式。
• /：打开命令菜单（附加文件、切换模型、查看用量等）。
• @：提及文件或文件夹，支持模糊匹配。
• Option + K (Mac) / Alt + K (Win)：快速插入带路径的行号引用。

二、工作流程与配置详解

1. 循环思考机制

当你给 Claude 一个任务时，它会像人类一样循环思考三个步骤：

1. 收集上下文：查看代码、文件、错误信息。
2. 采取行动：编辑文件、运行命令、搜索等。
3. 验证结果：检查是否成功，哪里还需要调整。

这三个步骤不断循环，直到任务完成。随时可以打断它、给新指示或要求换个方法。

2. 命令行命令

常用命令包括：

• /clear：清除对话历史
• /help：显示可用命令
• /login：登录或切换账号
• /resume：恢复之前的对话
• /exit or Ctrl+C：退出
• /model：切换模型

会话管理：

• 直接恢复会话：claude --continue
• 分叉会话：claude --continue --fork-session

上下文窗口： 当快满时，Claude 会自动压缩旧内容。可使用 /compact 手动压缩，/context 查看当前占用情况。

技巧：

• 重要规则写进 CLAUDE.md。
• 用 skills 和 subagents 减少不必要的上下文占用。

3. 安全机制与项目初始化

安全机制：

• 检查点：Claude 修改文件前会自动备份。按两次 Esc 或说'撤销刚才的修改'即可回退。
• 权限模式：按 Shift + Tab 快速切换。

项目初始化： 运行 /init，Claude 会自动扫描代码库并生成 CLAUDE.md 文件。

CLAUDE.md 结构示例：

# My Project 一句话描述项目用途。
## Tech Stack
- Backend: Python / FastAPI
- Frontend: React + TypeScript
- Database: PostgreSQL
## Common Commands
`npm run dev` # 启动开发服务器
`pytest tests/` # 运行测试
## Code Conventions
- 使用 snake_case 命名变量
- 所有 API 需要写单元测试

最佳实践：

• 提交到版本控制，团队共享。
• 保持精简，采用'渐进式披露'原则，避免撑爆上下文窗口。
• 不要用 LLM 替代 linter，代码风格约束应交给专用工具。

4. 目录结构规范

一个完整的 Claude Code 项目通常包含以下文件和目录：

your-project/
├── CLAUDE.md              ← 团队共享指令
├── CLAUDE.local.md        ← 个人覆盖（忽略于 git）
└── .claude/
    ├── settings.json      ← 权限 + 配置（提交 git）
    ├── commands/          ← 自定义斜杠命令
    ├── rules/             ← 模块化指令文件
    ├── skills/            ← 自动调用的工作流
    └── agents/            ← 子代理角色定义

settings.json 示例：

{
  "permissions": {
    "allow": ["Bash(npm run *)", "Bash(pytest:*)"],
    "deny": ["Bash(rm -rf *)", "Bash(curl * | bash)"]
  }
}

5. 前缀匹配器

输入框的本质是统一入口，通过前缀匹配操作：

• 无前缀：自然语言给任务
• / 前缀：调用内置命令
• @ 前缀：注入文件/目录/日志作为上下文
• ! 前缀：直接执行 Bash 命令（如 ! ls -la）
• # 前缀：把内容持久写入 CLAUDE.md
• & 前缀：后台异步执行

后台异步任务： 触发方式：输入命令后按 Ctrl+B。执行后返回唯一任务 ID，可用 /tasks 管理。典型场景包括构建工具、测试套件、长耗时部署任务。

三、高级功能：Subagent 与 Plugin

1. Subagent（子代理）

Subagent 是运行在独立上下文里的专用 AI 助手，拥有独立的系统提示、上下文窗口、模型选择和工具权限。

适用场景：

• 隔离高输出任务（如全量测试套件）。
• 并行研究（如同时启动 style-checker 和 security-scanner）。
• 串联子代理（流水线模式）。

配置示例：

---
name: code-reviewer
description: Reviews code for quality and best practices
memory: user
---
You are a senior code reviewer.

生命周期钩子： 支持 SubagentStart, SubagentStop, PreToolUse, PostToolUse 四个事件，用于日志记录、验证和通知。

2. Plugin（插件）

插件是最高级别的扩展机制，用于将命令、代理、Skills 等打包分发。

最小结构：

my-plugin/
├── .claude-plugin/
│   └── plugin.json
├── commands/
├── agents/
└── skills/

常用命令：

• /plugin install：安装插件
• /plugin enable/disable：启用/禁用
• claude --plugin-dir ./my-plugin：本地测试加载

3. Skill（技能）

Agent Skills 是将专业知识固化为可复用资产的核心工具。本质是包含 SKILL.md 的模块目录。

工作原理：

1. 技能发现：AI 读取元数据判断相关性。
2. 加载核心指令：读取 SKILL.md 正文。
3. 加载资源文件：按需读取额外脚本或示例。

内置 Skills：

• /simplify：简化代码
• /debug：根因分析
• /batch：批量处理
• /loop：循环重试

四、Agent Team 协作模式

Agent Teams 让多个独立 AI 实例像真实开发团队一样协同工作。

核心组件：

1. Team Lead：不直接编码，负责任务拆解与协调。
2. Teammates：真正干活的开发者，拥有独立上下文和工具权限。
3. TaskList：共享任务板，管理状态与依赖。
4. Messaging System：成员间通信系统。

开启命令： 在 settings.json 中配置：

{"experimental":{"agentTeams":true}}

最佳实践：

• 合同优先：先定接口契约，再并行开发。
• 模型分层分配：Lead 用 Opus，开发用 Sonnet，简单任务用 Haiku。
• 精准控制任务粒度：单个任务 15-30 分钟独立完成。
• 彻底避免文件冲突：不同成员负责不同文件。
• 初始上下文拉满：创建团队时一次性告知技术栈和背景。

五、进阶使用与生态工具

1. 高质量提问模板

背景： （我现在在做什么）
目标： （我希望达到什么效果）
约束： （不能做什么 / 必须遵守什么）
输出要求： （代码 / 解释 / 步骤）

2. MCP 与 Superpowers

MCP (Model Context Protocol) 让 Claude Code 从被动接收变为主动获取信息。支持列出、查看、删除服务器配置。

Superpowers 由 Jesse Vincent 开发的开源代理技能框架，解决'玩具级代码'与'工程级代码'的鸿沟。

核心技能：

• Brainstorming：需求澄清，苏格拉底式提问。
• Writing Plans：任务拆解，原子化任务单元。
• TDD：强制红 - 绿 - 重构循环。
• Systematic Debugging：四阶段标准化调试流程。

3. 前端美化与 Remotion

Frontend Design Skill 禁止使用 AI 默认值（如 Inter 字体、紫色渐变），强调美学方向确定和专业设计细节。

Remotion 视频自动化 Remotion 是用写 React 组件的方式写视频的框架。

安装命令：

npx skills add remotion-dev/skills

原理：

1. 网页渲染 React 组件。
2. Puppeteer 截屏（每秒 30/60 帧）。
3. FFmpeg 合成 MP4。

应用场景：

• 产品宣传视频
• 数据可视化报告
• 年度总结自动生成

素材建议： 优先使用 Pexels、Pixabay、Unsplash 等免费 API 平台，注意版权合规。

六、趣味功能：宠物系统

Claude Code v2.1.89 引入了 /buddy 命令，终端里会孵化出一只 ASCII 小宠物。

交互命令：

• /pet：抚摸宠物
• /feed：喂食提升活力
• /stats：查看属性面板
• /rename：重命名

特性：

• 物种、稀有度由用户 ID 哈希值确定性生成，同一账号永远孵出同一只宠物。
• 性格属性（调试力、耐心、混乱值等）随编码行为变化。
• 仅存储 AI 生成的'灵魂'（名字、描述），核心数据每次启动重新计算。

七、OpenClaw 简介

1. 源码与初始化

OpenClaw 提供了一键初始化能力，支持 SOUL.md 配置，强调 AI 助手应具备鲜明主见，拒绝官僚化表达。

SOUL.md 示例：

You have opinions now. Strong ones. Stop hedging everything with 'it depends' — commit to a take.
Delete every rule that sounds corporate.
Never open with Great question, I'd be happy to help...

2. 创作与运营自动化

• 视频自动化：结合 Remotion 实现批量视频生成。
• 编程自动化：利用 Agent 进行代码生成与维护。
• 运营自动化：财报数据自动化处理与分析。

通过上述工具链的组合，开发者可以构建起从代码编写到内容生产的全链路自动化工作流。