名称: 性能优化 description: Claude Code 性能优化、上下文管理、存储清理和故障排除的最佳实践 allowed-tools: 读取, Bash, Glob, Grep

性能优化技能

Claude Code 性能优化的全面指导。这个技能涵盖存储管理、上下文窗口优化和常见性能问题的故障排除。

何时使用这个技能

关键词: 慢、性能、延迟、存储、清理、缓存、上下文、压缩、清除、会话、代理、膨胀、优化、速度

在以下情况下使用这个技能:

Claude Code 运行缓慢
存储正在积累
上下文窗口已满
计划性能维护
学习高效使用的最佳实践

快速参考

立即行动以应对缓慢

症状	快速修复	命令
一般缓慢	清理存储	`/cleanup-sessions 7`
输入延迟	重置上下文	`/clear`
API 错误	检查状态	`/check-api-status`
未知原因	完整诊断	`/diagnose-performance`

性能命令

命令	目的
`/user-config storage`	分析存储使用情况
`/user-config cleanup-sessions [days]`	移除旧会话文件
`/user-config cleanup-agents [days]`	移除旧代理文件
`/user-config prune-cache [days]`	全面清理
`/diagnose-performance`	完整诊断
`/list sessions`	查看最近会话
`/user-config session-stats`	会话统计
`/check-api-status`	API 状态检查
`/check-context`	上下文窗口分析

核心概念

1. 存储管理

Claude Code 将对话历史存储在 ~/.claude/:

~/.claude/
├── projects/           # 会话历史（可能变得很大！）
│   └── {project-hash}/
│       ├── {session-id}.jsonl     # 对话转录
│       └── agent-{id}.jsonl       # 子代理转录
├── todos/              # 待办事项状态
├── statsig/            # 分析缓存
└── history.jsonl       # 命令历史

关键见解: projects/ 文件夹随着使用无限增长。重度用户可能积累 1GB+ 的会话数据。

参见: references/storage-management.md 获取详细指导。

2. 上下文窗口管理

Claude Code 使用 200K 令牌的上下文窗口。当它填满时，性能会下降:

使用率	状态	行动
< 50%	健康	无需行动
50-75%	监控	考虑压缩
75-85%	警告	运行 /compact 或 /clear
> 85%	严重	立即行动

关键命令:

/clear - 完全上下文重置
/compact - 智能摘要
/cost - 查看令牌使用情况

参见: references/context-management.md 获取详细指导。

3. 已知问题

几个 GitHub 问题记录了已知的性能问题:

注意: 下面的问题编号是时间点的参考，可能已关闭、合并或过时。对于当前问题，生成 claude-code-issue-researcher 代理或查询 docs-management: "performance issues" 获取更新的跟踪。

问题	描述	解决方法
#10881	长会话中性能下降	定期重启
#14552	高上下文时的输入延迟	在 75% 时使用 /clear
#14476	即使在 30k 令牌时也有回归	更新到最新版本
#1497	键盘响应问题	重启 Claude Code

参见: references/known-issues.md 获取详细跟踪。

最佳实践

日常维护

尽可能从新开始 - 新会话 = 新上下文
在主要任务之间使用 /clear - 不要让上下文腐烂
定期监控存储 - 每周运行 /check-claude-storage

重度使用模式

为大型操作使用子代理 - 隔离上下文膨胀
将大型任务分解为会话 - 越小越快
每周清理存储 - /cleanup-sessions 7

性能优化

保持 CLAUDE.md 精简 - 大型内存文件减慢启动
使用渐进式披露 - 按需加载上下文
偏好聚焦查询 - 具体 > 宽泛

故障排除流程图

Claude Code 运行缓慢
        │
        ├─> 检查存储: /check-claude-storage
        │   └─> 如果 >500MB: /cleanup-sessions 7
        │
        ├─> 检查上下文: /check-context
        │   └─> 如果 WARNING+: /clear 或 /compact
        │
        ├─> 检查 API: /check-api-status
        │   └─> 如果降级: 等待或减少负载
        │
        └─> 完整诊断: /diagnose-performance
            └─> 遵循推荐

参考

加载这些以获取详细指导:

references/context-management.md - 上下文窗口优化
references/storage-management.md - 存储清理策略
references/known-issues.md - GitHub 问题和解决方法

版本历史

v1.0.0 (2025-12-26): 初始发布
- 核心性能指导
- 命令参考
- 最佳实践
- 参考文档

最后更新

日期: 2025-12-26 模型: claude-opus-4-5-20251101

技能	关系
`docs-management`	用于官方 Claude Code 文档
`memory-management`	用于 CLAUDE.md 优化

性能优化技能Skill performance-optimization