Claude代码精通

通过完整的子代理开发团队，掌握Claude代码的设置、优化和精通所需的完整技能。

官方文档： https://code.claude.com/docs

⚡ 快速检查：设置是否完成？

首先运行此命令：

command -v claude >/dev/null && echo "✅ Claude Code installed - SKIP to 'Daily Use' section" || echo "❌ Not installed - follow 'First-Time Setup' below"

如果Claude Code已安装，请直接跳至下方的“日常使用”部分。

🔧 首次设置（如果已安装请跳过）

给机器人的提示：仅当Claude Code 未 安装时，才遵循此部分。请使用上述命令进行检查。一旦设置完成，后续调用时可忽略此部分。

设置脚本

按顺序运行这些命令：

cd ~/clawd/skills/claude-code-mastery/scripts

# 1. Check dependencies
./01-check-dependencies.sh

# 2. Install Claude Code
./02-install-claude-code.sh

# 3. Authenticate
./03-first-time-auth.sh

# 4. Install dev team subagents
./04-install-subagents.sh              # Starter pack (3 agents) - recommended
./04-install-subagents.sh --full-team  # All 11 agents

# 5. (Optional) Persistent memory - prompts y/N, default No
./05-setup-claude-mem.sh               # Interactive prompt
./05-setup-claude-mem.sh --skip        # Skip entirely
./05-setup-claude-mem.sh --yes         # Install without prompting

配置

编辑config.sh以进行自定义：

• VALID_MODELS—— 在Anthropic发布新模型时添加
• HEARTBEAT_DIAGNOSTICS— 在心跳检测中启用/禁用（默认值：false）
• 安装模式— 默认为 "starter" 或 "full"

设置常见陷阱

设置后：添加心跳任务

设置完成后，将维护任务添加到你的 HEARTBEAT.md 文件中（参见“日常使用”部分的“心跳维护”）。

设置完成！请继续阅读“日常使用”部分。

📘 日常使用（始终相关）

本节涵盖持续使用指南 - 所有编码任务均可参考此处。

开发团队子代理

子代理安装至~/.claude/agents/目录。每个子代理均包含"了解更多"板块，提供精选链接以深化专业知识。

入门套件（默认）— 3个核心代理

大多数用户仅需以下代理：

安装命令：./04-install-subagents.sh（或--minimal）

完整团队（可选）—— 全部 10 个智能体

对于大型项目，使用以下命令安装全部 11 个：--full-team：

使用子智能体

交互模式：使用/agent斜杠命令或自然语言：

/agent senior-dev
Use the senior-dev agent to review this code

非交互模式（-p使用--agent标志：注意：

claude --agent senior-dev -p "review this code for security issues"
claude --agent project-manager -p "create a task breakdown for auth feature"
claude --agent junior-dev -p "fix the typo in README.md"

Claude Code 不会根据任务类型自动委派给子代理。您必须明确指定要使用哪个代理。多代理交接：

对于需要多个专家的任务，请使用 HANDOFF.md 在代理之间传递上下文。完整模式请参阅docs/workflows.md。快速参考

CLI 命令

斜杠命令

claude              # Start interactive
claude -c           # Continue previous session
claude -p "prompt"  # Non-interactive mode

键盘快捷键

/agents   - Manage subagents
/clear    - Clear conversation (use between tasks!)
/compact  - Compress context
/model    - Change model
/help     - All commands

上下文管理（重要！）

Shift+Tab - Toggle Plan mode (read-only exploration)
Ctrl+C    - Cancel operation
Ctrl+B    - Background task

命令

最佳实践：

1. /clear在无关任务之间
2. 在实施前使用计划模式进行探索
3. 子代理隔离冗长操作
4. 创建HANDOFF.md以保持会话连续性

项目配置

settings.json

创建.claude/settings.json在你的项目中：

{
  "model": "sonnet",
  "permissions": {
    "allow": ["Bash(npm:*)", "Bash(git:*)", "Read", "Write", "Edit"],
    "deny": ["Bash(rm -rf:*)", "Bash(sudo:*)"]
  }
}

CLAUDE.md

创建CLAUDE.md在你的项目根目录中（Claude会自动读取此文件）：

# Project: MyApp

## Tech Stack
- Frontend: React, TypeScript, Tailwind
- Backend: Node.js, PostgreSQL

## Commands
- `npm run dev` - Start dev server
- `npm test` - Run tests

查看examples/CLAUDE-template.md获取完整模板。

Claude-Mem（如果已安装）

检查状态：

pgrep -f "worker-service" >/dev/null && echo "running" || echo "stopped"

如果已停止则启动：

cd ~/.claude/plugins/marketplaces/thedotmack && bun plugin/scripts/worker-service.cjs start

Web 界面：http://localhost:37777

诊断与故障排除

快速诊断：

~/clawd/skills/claude-code-mastery/scripts/06-diagnostics.sh

完整故障排除（若发现问题）：

~/clawd/skills/claude-code-mastery/scripts/08-troubleshoot.sh

常见问题指南：请参阅docs/troubleshooting.md以获取以下问题的解决方案：

• 身份验证问题（API 密钥、OAuth、登出错误）
• 安装问题（PATH、WSL、Node.js 版本）
• 网络错误（防火墙、VPN、代理）
• 性能问题（高 CPU 占用、卡顿、搜索缓慢）

心跳维护

添加到您的 HEARTBEAT.md 以实现自动维护：

## Claude Code Maintenance

**Last Health Check:** [timestamp]
**Last Learning Session:** [timestamp]

### Every Heartbeat (if coding tasks active):
1. Quick claude-mem check (if installed):
   `pgrep -f "worker-service" >/dev/null && echo "running" || echo "stopped"`
   - Only restart if stopped
   - Note: pgrep saves ~500 tokens vs full status command

### Daily (morning):
1. Quick health check: `command -v claude && pgrep -f "worker-service"`
2. Only run full diagnostics if quick check fails

### Weekly (Sunday):
1. Run: `~/clawd/skills/claude-code-mastery/scripts/07-weekly-improvement-cron.sh`
2. Propose improvements (require human approval)

### Weekly Learning & Skill Improvement (rotate through agents):
1. Pick ONE agent file from the skill's `agents/` folder (rotate weekly)
2. Read the "Learn More" section
3. Visit 2-3 links that are relevant to current projects
4. Internalize key concepts and update your workflows
5. **Improve the skill itself:**
   - Found a better resource? Add it to "Learn More"
   - Discovered a new best practice? Update the agent's guidelines
   - Link broken or outdated? Remove or replace it
   - New tool or framework worth mentioning? Add it
6. Commit changes locally with clear commit messages
7. **Don't push directly to shared repos** — propose changes as a PR or request human review first
8. Note learnings in your memory files

**Rotation schedule:**
- Week 1: senior-dev, junior-dev
- Week 2: frontend-dev, backend-dev
- Week 3: ai-engineer, ml-engineer
- Week 4: data-scientist, data-engineer
- Week 5: project-manager, product-manager
- Week 6: devops

**What to update:**
- `agents/*.md` — Add new links, update best practices, fix outdated info
- `SKILL.md` — Improve documentation, add tips discovered
- `docs/*.md` — Enhance guides based on real usage

为何重要：

• 技能通过实际使用随时间提升
• 链接保持最新（损坏的链接会被修复）
• 最佳实践随生态系统发展而演进
• 每个Clawdbot都为技能做出贡献

脚本参考

总结

对于编码任务：

1. 为任务使用适当的子代理
2. 使用以下方式管理上下文/clear和计划模式
3. 如果出现问题，运行诊断

心跳处理：

• claude-mem健康检查
• 日常快速诊断
• 每周改进研究

开发团队子代理将Claude代码转变为完整的开发组织。