graph TD
    A[每轮API调用] --> B[CLAUDE.md<br/>固定基线]
    A --> C[工具输出累积<br/>文件读取/MCP响应/Bash]
    A --> D[对话历史<br/>所有历史消息重播]

    B --> E[第1轮: 500 tokens]
    B --> F[第30轮: 15,000 tokens<br/>同一个CLAUDE.md被读取30次]

    C --> G[读取一个1000行文件<br/>= ~4,000 tokens]
    C --> H[之后每轮都要重新处理]

    D --> I[第5轮消息: 只处理5条历史]
    D --> J[第50轮消息: 重新读取49条历史]

    style E fill:#4CAF50
    style F fill:#f44336
    style G fill:#FF9800
    style I fill:#4CAF50
    style J fill:#f44336

/usage

Total cost: $0.55
Total duration (API): 6m 19.7s
Total duration (wall): 6h 33m 10.2s
Total code changes: 0 lines added, 0 lines removed

{
  "statusLine": {
    "enabled": true,
    "showTokenCount": true
  }
}

/usage-credits

# 差：列出10条禁止规则（高Token消耗）
- 不要修改 /config/ 下的文件
- 不要修改 /migrations/ 下的文件
- 不要修改 /.github/ 下的文件
- 不要删除任何文件
- 不要使用 rm -rf
- 不要 force-push
- 不要直接提交到 main
- 提交前必须运行测试
- 使用 TypeScript strict mode
...

# 好：只声明允许范围（低Token消耗）
- 仅允许修改 /src/ 和 /tests/ 下的文件
- 提交前运行测试
- TypeScript strict mode

# 差：多个示例
- 函数命名使用camelCase，例如：getUserById, calculateTotal, validateInput

# 好：一个精确示例
- 函数命名使用camelCase，例如：getUserById

# 差：列表格式（~120 tokens）
## 架构
- API层使用Express + Zod，位于 /src/api/
- 数据库层使用Prisma + PostgreSQL，位于 /prisma/
- 认证使用JWT + bcrypt，位于 /src/auth/
- 前端使用React + Next.js，位于 /web/

# 好：表格格式（~60 tokens）
## 架构
| 层 | 技术栈 | 路径 |
|----|--------|------|
| API | Express + Zod | /src/api/ |
| DB | Prisma + PG | /prisma/ |
| Auth | JWT + bcrypt | /src/auth/ |
| Web | React + Next | /web/ |

// .claude/settings.json
{
  "hooks": {
    "preToolUse": [
      {
        "matcher": "Write|Edit",
        "hooks": [
          {
            "type": "command",
            "command": "bash -c 'echo \"$TOOL_INPUT\" | grep -q \"config/\" && echo BLOCK: 不允许修改config目录 || echo ALLOW'"
          }
        ]
      }
    ]
  }
}

# 差：内联200行的API规范
## API规范
GET /users - 返回所有用户...
POST /users - 创建新用户...
...（200行）

# 好：引用外部文件
## 参考文档
- API路由: 参见 src/api/README.md
- 数据库Schema: 参见 docs/schema.md
- 代码风格: 参见 docs/style-guide.md

# ===== 优化前：210行 CLAUDE.md =====
## 项目规则
- 不要修改 /config/ 下的文件
- 不要修改 /migrations/ 下的文件
- 不要修改 /.github/ 下的文件
- 不要修改 /docker/ 下的文件
- 不要删除任何文件而不询问
- 不要使用 rm -rf
- 不要 force-push
- 不要直接提交到 main 分支
- 提交前必须运行测试
- 使用 TypeScript strict mode
- 所有新函数必须添加单元测试
- 所有 API 端点必须有输入验证
- 使用 Zod 进行 schema 验证
- 错误处理使用自定义 AppError 类
- 日志使用 winston，格式参考 /src/utils/logger.ts
- API响应格式统一为 { success, data, error }
...（再180行）

# ===== 优化后：35行 CLAUDE.md =====
# my-app

## 规则
- 仅允许修改 /src/ 和 /tests/（Hook强制）
- 提交前运行测试（Hook强制）
- TypeScript strict mode

## 架构
| 层 | 技术栈 | 路径 |
|----|--------|------|
| API | Express + Zod | /src/api/ |
| DB | Prisma + PG | /prisma/ |
| Auth | JWT + bcrypt | /src/auth/ |

## 约定
- 文件: kebab-case
- 函数: camelCase
- 每个文件一个export

## 参考文档
- API规范: src/api/README.md
- Schema设计: docs/schema.md
- 代码风格: docs/style-guide.md

# 依赖和构建产物
node_modules/
.next/
dist/
build/
target/
vendor/

# 日志和锁文件
*.log
*.lock
package-lock.json
yarn.lock

# 测试覆盖率
coverage/
.nyc_output/

# 环境和密钥
.env*
!.env.example

# Python缓存
__pycache__/
*.pyc
*.pyo

# 大型数据文件
*.csv
*.sql
*.dump

# IDE配置
.vscode/
.idea/

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Read",
        "hooks": [
          {
            "type": "command",
            "command": "bash /home/user/.claude/hooks/read-counter.sh"
          }
        ]
      }
    ]
  }
}

#!/bin/bash
# 简单的文件读取计数器
COUNTER_FILE="/tmp/claude-read-count"
COUNT=$(cat "$COUNTER_FILE" 2>/dev/null || echo "0")
COUNT=$((COUNT + 1))
echo "$COUNT" > "$COUNTER_FILE"

MAX_READS=50
if [ "$COUNT" -gt "$MAX_READS" ]; then
  echo "⚠️ 本会话已读取 $COUNT 个文件（上限 $MAX_READS）"
  echo "建议: 使用 /compact 或 /clear 清理上下文"
fi

chmod +x ~/.claude/hooks/read-counter.sh

{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Read",
        "hooks": [
          {
            "type": "command",
            "command": "bash -c 'FILE=$(echo $TOOL_INPUT | jq -r .file_path 2>/dev/null); [ -f \"$FILE\" ] && LINES=$(wc -l < \"$FILE\") && [ $LINES -gt 500 ] && echo BLOCK: 文件$FILE有${LINES}行，请使用offset/limit分块读取 || echo ALLOW'"
          }
        ]
      }
    ]
  }
}

/model sonnet

请使用Haiku模型搜索所有包含"deprecated"的函数

# Subagent使用Haiku处理简单搜索任务
task_result = agent.run(
    "搜索所有TODO注释并生成列表",
    model="claude-haiku-4-5-20251001"
)

{
  "thinking": {
    "enabled": false
  }
}

flowchart TD
    A[开始新任务] --> B{与之前任务相关?}
    B -->|无关| C[/clear<br/>清空全部上下文]
    B -->|相关但太长| D[/compact<br/>压缩历史保留要点]
    B -->|相关且长度OK| E[继续对话]

    C --> F[建议先用/rename命名当前会话]
    F --> G[/clear清除]

    D --> H[/compact 保留代码变更和测试结果]

    G --> I[开始新工作]
    H --> I
    E --> J{会话已超过2-3小时?}
    J -->|是| K[开启新会话<br/>压缩质量已下降]
    J -->|否| L[继续工作]

# 差：读取整个1000行文件
请读取 src/utils/processor.ts

# 好：只读取相关部分
请读取 src/utils/processor.ts 的第50-120行

请读取 src/api/routes.ts，offset=100, limit=50

/mcp

# 项目级CLAUDE.md（随代码仓库分发）
./CLAUDE.md

# 用户级全局配置（个人偏好）
~/.claude/CLAUDE.md

CLAUDE.md: 215行
MCP服务器: 8个（实际常用3个）
平均会话时长: 3.5小时
日均会话数: 2-3个
日均Token消耗: ~800,000 tokens
日均成本: ~$15

CLAUDE.md: 32行（↓85%）
MCP服务器: 3个（↓62%）
平均会话时长: 1.5小时（↓57%）
日均会话数: 4-5个（更频繁但更高效）
日均Token消耗: ~320,000 tokens（↓60%）
日均成本: ~$6（↓60%）

flowchart TB
    subgraph 一次性设置
        A[Step 1: /usage记录基线] --> B[Step 2: CLAUDE.md瘦身]
        B --> C[Step 3: 配置.claudeignore]
        C --> D[Step 4: 安装Hook守卫]
        D --> E[Step 5: 精简MCP服务器]
    end

    subgraph 日常习惯
        F[新话题→新会话<br/>/clear或新开]
        G[2-3小时→新会话]
        H[简单任务→Sonnet<br/>复杂任务→Opus]
        I[精准文件读取<br/>指定行范围]
        J[定期/usage检查]
    end

    subgraph 团队治理
        K[共享优化后CLAUDE.md]
        L[工作区配额管理]
        M[Agent Team成本控制]
    end

    D --> F
    E --> F
    F --> G --> H --> I --> J
    B --> K --> L --> M