Claude How To：Claude Code 精通学习指南

# 代码优化
/optimize

# 代码审查
/review

# 解释代码
/explain

# 生成测试
/test

# 修复错误
/fix

# Project Context

## 技术栈
- Frontend: React 18 + TypeScript
- Backend: Node.js + Express
- Database: PostgreSQL + Redis

## 代码规范
- 使用 ESLint + Prettier
- 提交信息遵循 Conventional Commits
- 所有 API 返回统一格式 { success, data, error }

# 启动会话
claude

# 直接执行命令
claude -p "Explain this code"

# 指定项目
claude --project ./my-project

# 查看帮助
claude --help

name: code-review
description: Perform comprehensive code review
triggers:
  - "/review"
  - "/code-review"
tools:
  - read
  - grep
  - bash
instructions: |
  Review code for:
  1. Logic errors
  2. Security vulnerabilities
  3. Performance issues
  4. Style consistency

// hooks/pre-tool-use.ts
import { HookRegistry } from '@claude-code/hooks';

export const preToolUse: HookRegistry['preToolUse'] = async (tool, input) => {
  // 检查危险操作
  if (tool.name === 'Bash' && input.command.includes('rm -rf')) {
    throw new Error('Dangerous delete operation blocked');
  }
  
  // 记录操作日志
  await logToolUse(tool.name, input);
  
  return { allowed: true };
};

# .claude/mcp.yaml
mcp_servers:
  github:
    command: npx
    args: ["-y", "@modelcontextprotocol/server-github"]
    env:
      GITHUB_TOKEN: "${GITHUB_TOKEN}"
  
  slack:
    command: npx
    args: ["-y", "@modelcontextprotocol/server-slack"]
    env:
      SLACK_BOT_TOKEN: "${SLACK_BOT_TOKEN}"

// 创建子 Agent 处理代码审查
const reviewer = await claude.spawnAgent({
  name: 'code-reviewer',
  instructions: 'You are an expert code reviewer.',
  skills: ['code-review'],
  hooks: [securityScanner],
});

// 主 Agent 协调
const task = await reviewer.review(pullRequest);
await task.waitForCompletion();
const results = await task.getResults();

security:
  read_only_mode: false
  allowed_paths:
    - /workspace/src
    - /workspace/tests
  denied_patterns:
    - "*.env"
    - "*.pem"
  tool_restrictions:
    Bash:
      max_duration: 300
      require_confirmation: true

# CLAUDE.md - 团队入职助手

## 团队信息
- 团队成员：Alice (PM), Bob (Dev), Carol (DevOps)
- 工作时间：9:00-18:00 PST
- 紧急联系：Slack #emergency

## 入职流程
1. 环境配置 → 参考 docs/setup.md
2. 代码规范 → 参考 .eslintrc.js
3. 提交流程 → 使用 /git-workflow 命令

// 安全审计子 Agent
const securityAuditor = await claude.spawnAgent({
  name: 'security-auditor',
  instructions: 'Perform security audit only. No modifications allowed.',
  skills: ['security-scan'],
  hooks: [{
    type: 'PreToolUse',
    action: (tool) => {
      if (tool.category === 'write') {
        throw new Error('Write operations forbidden in audit mode');
      }
    }
  }]
});

# 1. 克隆指南仓库
git clone https://github.com/luongnv89/claude-howto.git
cd claude-howto

# 2. 复制第一个 Slash Command
mkdir -p /path/to/your-project/.claude/commands
cp 01-slash-commands/optimize.md /path/to/your-project/.claude/commands/

# 3. 在 Claude Code 中试用
# /optimize

# 4. 设置项目 Memory
cp 02-memory/project-CLAUDE.md /path/to/your-project/CLAUDE.md

# 5. 安装一个 Skill
cp -r 03-skills/code-review ~/.claude/skills/

# Slash Commands (15 分钟)
cp 01-slash-commands/*.md ~/.claude/commands/

# 项目 Memory (15 分钟)
cp 02-memory/project-CLAUDE.md ./CLAUDE.md

# 安装 Skill (15 分钟)
cp -r 03-skills/code-review ~/.claude/skills/

# 配置 Hooks (15 分钟)
cp -r 06-hooks/* ~/.claude/hooks/

<!-- .claude/skills/my-skill/SKILL.md -->
name: my-custom-skill
description: Custom skill for project-specific tasks
version: 1.0.0

trigger:
  commands:
    - /my-skill
    - /custom

capabilities:
  tools:
    - read
    - write
    - bash
    - web_search
  
  file_patterns:
    - "*.py"
    - "*.js"
    - "*.ts"

system_prompt: |
  You are a specialized assistant for [project name].
  Focus on [specific domain or task type].
  Always follow [project-specific guidelines].

instructions: |
  1. First, read the CLAUDE.md for project context
  2. Check relevant documentation in docs/
  3. Follow the coding standards in STYLE_GUIDE.md
  4. Output results in the standard format

// .claude/hooks/notification-hook.ts
import { Hook, HookContext, HookResult } from '@claude-code/hooks';

export const postMessage: Hook = async (
  message: string,
  context: HookContext
): Promise<HookResult> => {
  // 发送通知
  await slack.notify({
    channel: '#claude-updates',
    message: `New message: ${message.substring(0, 100)}...`,
  });

  return { success: true };
};

// 自定义 MCP 服务器
import { MCPServer, Tool } from '@modelcontextprotocol/server';

const server = new MCPServer({
  name: 'my-custom-server',
  version: '1.0.0',
});

server.addTool({
  name: 'query_database',
  description: 'Execute SQL query',
  inputSchema: {
    type: 'object',
    properties: {
      query: { type: 'string' },
    },
    required: ['query'],
  },
  handler: async ({ query }) => {
    const result = await db.query(query);
    return { rows: result };
  },
});

server.listen();

<!-- 推荐的 CLAUDE.md 结构 -->

# [项目名称]

## 一句话描述
[项目是什么、解决什么问题]

## 技术栈
- Frontend: [技术]
- Backend: [技术]
- Database: [技术]
- Infrastructure: [技术]

## 代码规范
- 风格指南: [链接]
- 提交规范: [Conventional Commits]
- PR 流程: [链接]

## 架构决策
- [ ADR 链接]

## 常用命令
- 开发: `npm run dev`
- 测试: `npm test`
- 构建: `npm run build`

## 联系人
- 技术负责人: [邮箱]
- 文档维护: [邮箱]

// 生产环境 Hooks 安全配置
const secureHooks = {
  preToolUse: async (tool, input) => {
    // 白名单检查
    if (!isToolAllowed(tool.name)) {
      throw new Error(`Tool ${tool.name} is not allowed`);
    }
    
    // 危险命令确认
    if (isDangerousCommand(tool, input)) {
      const confirmed = await prompt.confirm(
        `Execute dangerous command: ${tool.name}?`
      );
      if (!confirmed) {
        throw new Error('Operation cancelled');
      }
    }
    
    return { allowed: true };
  },
  
  preMessage: async (message) => {
    // 内容过滤
    const filtered = contentFilter(message);
    return { filtered, wasModified: filtered !== message };
  },
};

# .claude/config.yaml - 性能优化配置

# 上下文管理
context:
  max_tokens: 180000
  checkpoint_threshold: 150000
  auto_checkpoint: true

# 缓存策略
cache:
  enabled: true
  provider: redis
  ttl: 7200
  max_entries: 500

# 并发控制
concurrency:
  max_parallel_tools: 5
  max_parallel_subagents: 3
  queue_timeout: 300

# 1. 立即开始（15分钟）
git clone https://github.com/luongnv89/claude-howto.git
cd claude-howto

# 2. 选择你的起点
# - 初学者：01-slash-commands
# - 中级：05-skills 或 06-hooks
# - 高级：09-advanced-features

# 3. 在 Claude Code 中运行自测
/self-assessment

# 4. 开始学习！