Управление контекстом Claude Code
Управление контекстом — ключевой навык для эффективного использования Claude Code.
В официальной документации прямо сказано:"Контекстное окно — самый важный ресурс Claude Code"По мере заполнения контекста производительность модели постепенно снижается (так называемый context rot) — это ключевая проблема, с которой нужно активно бороться при использовании Claude Code.
В этой главе подробно объясняется, как использовать файлы инструкций CLAUDE.md, систему автоматической памяти и команды оптимизации контекстного окна, чтобы поддерживать эффективность Claude в длительных сессиях и между сессиями.
Основы контекстного окна
1. Что содержит контекстное окно
Размер контекстного окна Claude Code составляет1,000,000 токенов (1 миллион токенов)Оно содержит всё, что Claude "видит" в текущей сессии:
| Источник контента | Момент загрузки | Использование токенов |
|---|---|---|
| Системный промпт (Руководство по поведению Claude Code) | Загружается при каждом запуске сессии | Фиксированное использование |
| Файл CLAUDE.md | Полностью загружается при запуске | Зависит от размера файла |
| Автоматическая память | Загружается при запуске (первые 200 строк или 25KB) | Имеет ограничение |
| История диалога | Накапливается | Непрерывно увеличивается по ходу сессии |
| Результаты инструментов (чтение файлов, вывод команд и т. д.) | Добавляются после каждого вызова инструмента | Логи/большие файлы очень быстро расходуют токены |
| Имена инструментов MCP, описания Skills и т. д. | Загружаются при запуске | Средняя |
2. Гниение контекста
В официальной документации прямо сказано: по мере заполнения контекстапроизводительность LLM снизится, потому что внимание распределяется по большему числу токенов, и старый, нерелевантный контент начинает мешать текущей задаче. Конкретные симптомы включают:
- Claude становится противоречивым и забывает ранее согласованные решения
- Ответы становятся расплывчатыми и общими, с меньшим количеством деталей
- Повторяет один и тот же вопрос, хотя на него уже был дан ответ
- Исправляет одну и ту же проблему более двух раз в одной сессии
Если вышеуказанные симптомы возникают, это означает, что контекст уже «загрязнён». В этот момент следует проактивно использовать/compactили/clearчтобы справиться с этим, а не продолжать исправлять в рамках той же сессии.
Используйте/contextкоманду для просмотра подробного анализа использования текущего контекста в любое время:
/context
Она перечисляет использование токенов по категориям (системный промпт, CLAUDE.md, файлы памяти, история сессии и т. д.) и даёт рекомендации по оптимизации. Рекомендуется проверять один раз перед началом важных задач.
Файл инструкций CLAUDE.md
CLAUDE.md — это основной файл в Claude Code, в котором записаны статические инструкции и соглашения проекта. В начале каждой сессии Claude автоматически загружает его в контекстное окно.
1. Место хранения и область действия
CLAUDE.md поддерживает несколько местоположений,более конкретные местоположения имеют более высокий приоритет:
| Область действия | Путь к файлу | Сценарий использования | Сделать коммит в git? |
|---|---|---|---|
| На уровне организации | macOS: /Library/Application Support/ClaudeCode/CLAUDE.mdLinux/WSL: /etc/claude-code/CLAUDE.md |
Корпоративные стандарты кодирования, требования соответствия | Централизованно управляется ИТ-отделом |
| Уровень проекта | ./CLAUDE.mdили./.claude/CLAUDE.md |
Архитектура проекта, стандарты кодирования, рабочие процессы | Да, общий для команды |
| Пользовательский уровень | ~/.claude/CLAUDE.md |
Личные предпочтения в кодировании, применяются ко всем проектам | Нет, личное и приватное |
| Локально, приватно | ./CLAUDE.local.md(добавить в .gitignore) |
Личная конфигурация для конкретного проекта, не коммитится в git | Нет, добавить в .gitignore |
CLAUDE.local.mdЭто официально рекомендуемый способ для личной приватной конфигурации: URL-адреса песочницы, локальные тестовые учётные записи, личные привычки отладки и другое содержимое, которым не следует делиться, должны размещаться здесь, а неCLAUDE.mdв. Run/initпри выборе опции "Personal" он автоматически добавит файл в.gitignore。
2. Создание CLAUDE.md
Выполните следующую команду, и Claude автоматически проанализирует проект и создаст начальный CLAUDE.md:
/init
Если CLAUDE.md уже существует,/initон предложит улучшения, а не перезапишет его напрямую. После генерации вручную добавьте содержимое, которое Claude не может обнаружить автоматически (например, файлы, которые нельзя изменять, особые ограничения и т. д.).
Вы также можете использовать в сеансе#горячую клавишу, чтобы быстро добавить память в CLAUDE.md:
# 所有 API 错误响应必须使用 { code, message } 格式
Нажмите#после ввода содержимого и нажатия Enter Claude запишет его в CLAUDE.md соответствующего уровня и сохранит как постоянную инструкцию.
3. Требования к содержимому CLAUDE.md
Официальное требование состоит в том, чтобы каждый файл CLAUDE.mdсодержал не более 200 строк. Чем больше файл, тем больше стартовых токенов он потребляет, и тем ниже становится степень соблюдения требований Claude. Вот рекомендации по содержимому:
Следует включить:
- Часто используемые команды для сборки, тестирования и развёртывания
- Стиль кода: соглашения об именовании, отступы, запрещённые шаблоны
- Ключевые ограничения: "всегда используйте pnpm", "не изменяйте директорию migrations/"
- Описание архитектуры проекта: назначение основных директорий
Не следует включать:
- Многошаговые операционные рабочие процессы (должны быть помещены в файл Skills)
- Правила, относящиеся только к определённой части кодовой базы (следует использовать
.claude/rules/ограничение области по путям) - Информация, которую Claude может обнаружить самостоятельно, прочитав код
Примеры
## Часто используемые команды
- Управление пакетами: всегда используйте pnpm, не используйте npm или yarn
- Запуск тестов: pnpm test:watch
- Сборка: pnpm build
## Стиль кода
- Строгий режим TypeScript, `any` не разрешён
- Файлы компонентов используют именование PascalCase (например, UserProfile.tsx)
- Метки времени в базе данных единообразно используют формат UTC
## Ограничения
- Прямое изменение существующих файлов в каталоге prisma/migrations/ запрещено
- .env.local содержит настоящие секреты; чтение или вывод содержимого файла запрещены
- API-эндпоинты единообразно управляются в каталоге src/api/; не выполняйте запросы напрямую в других местах
4. Правила с областью действия на основе пути (.claude/rules/)
Для более крупных проектов вы можете использовать.claude/rules/каталог, чтобы разделить инструкции на мелкозернистые правила, применяемые по пути к файлу, избегая того, чтобы все правила сваливались в корневой CLAUDE.md и расходовали стартовые токены:
.claude/
└── rules/
├── api.md # 只对 src/api/**/*.ts 文件生效
├── frontend.md # 只对 src/components/**/*.tsx 文件生效
└── testing.md # 只对 *.test.ts 文件生效
Правила с областью действия по пути загружаются только когда Claude читает файлы в соответствующем каталоге; они не занимают весь контекст при запуске.
Автоматическая память
Автоматическая память — это межсессионная система памяти, встроенная в Claude Code v2.1.59 и выше.Она включена по умолчаниюи не требует настройки. Она позволяет Claude автономно записывать информацию, обнаруженную во время работы, такую как команды сборки, опыт отладки и предпочтения в стиле кода.
1. Как это работает
- Claude не записывает память в каждой сессии; он оценивает, стоит ли сохранять информацию (будет ли она полезна в будущих разговорах).
- Память изолирована по пути git-репозитория и хранится в
~/.claude/projects/<项目路径>/memory/ - Все рабочие деревья одного и того же репозитория совместно используют одну автоматическую память.
- При записи памяти терминал показывает "Writing memory"; при последующем извлечении он показывает "Recalled memory".
2. Просмотр и редактирование памяти (/memory)
Используйте/memoryкоманда для просмотра и редактирования всего содержимого памяти, включая CLAUDE.md разных уровней и автоматическую память:
/memory
В редакторе можно удалить неточные записи или использовать переключатель Auto memory, чтобы отключить автоматическую память. Также можно временно отключить её с помощью переменных среды:
CLAUDE_CODE_DISABLE_AUTO_MEMORY=1 claude
3. Как проактивно заставить Claude запоминать содержимое
В диалоге можно напрямую попросить Claude записать в память:
记住:我们的 API 测试需要本地运行一个 Redis 实例
以后请记住:处理错误时,统一返回 { code, message } 结构
Если вы хотите повысить его до обязательного правила, а не просто сохранить как предпочтение в памяти, можно сказать: "Write this rule into CLAUDE.md", и Claude запишет его в соответствующий файл CLAUDE.md.
Команды оптимизации контекстного окна
1. Автосжатие
Claude Code автоматически запускает сжатие, когдаконтекст приближается к лимиту(примерно при 75% использования), суммируя историю диалога в дайджест и продолжая работу. Однако официальная рекомендация — не ждать автосжатия; вместо этогопроактивно запускать его вручную при 60~70%.Это позволяет избежать прерывания в середине важных задач, а ручное сжатие позволяет управлять тем, какое содержимое сохраняется, с помощью инструкций.
2. Сжатие контекста (/compact)
Вручную сжать историю диалога, суммируя длинные сессии в краткий дайджест, чтобы продолжить работу:
/compact
/compactПоддерживается передача пользовательских инструкций, чтобы управлять тем, какому содержимому отдаётся приоритет во время сжатия:
/compact Focus on the API changes
/compact 保留认证流程的架构决策,丢弃调试过程中的无效尝试
Сжатие — это операция с потерями. Во время сжатия Claude находится в состоянии наиболее заполненного контекста и самой слабой производительности. Если вы не дадите инструкции, он может отбросить содержимое, которое вы считаете важным.Проактивно выполняйте сжатие сразу после важных решений и используйте инструкции, чтобы указать, что сохранить.Это работает намного лучше, чем ожидание автосжатия.
3. Очистка контекста (/clear)
Очищает всю историю диалога при переключении на совершенно новую задачу:
/clear
После очистки CLAUDE.md и auto memory не затрагиваются и по-прежнему будут загружаться в новых сессиях. Официальная рекомендация:Если вы исправляли одну и ту же проблему более двух раз в рамках одной сессии, просто выполните /clear и начните заново с более точным запросом, указав ограничения, которые вы усвоили.— Чистая сессия с более удачным запросом почти всегда лучше, чем продолжать исправлять в загрязнённом контексте.
4. Откат к контрольной точке (/rewind)
Claude Code автоматически создаёт контрольную точку перед каждым изменением файла. Дважды щёлкнитеEscили выполните/rewindчтобы открыть меню отката и выбрать контрольную точку для восстановления:
/rewind
(或双击 Esc 键)
В меню отката можно выбрать следующие действия:
| Действие | Эффект | Сценарий использования |
|---|---|---|
| Восстановить диалог + код | Откатывает историю диалога и изменения файлов, полностью восстанавливая состояние. | Когда Claude отклонился от задачи, а изменения проблемные; отмените всё. |
| Восстановить только диалог | Откатывает историю диалога, сохраняет изменения файлов. | Когда вы хотите попробовать другой подход, но сохранить изменения кода. |
| Восстановить только код | Восстанавливает файлы к состоянию контрольной точки, сохраняет диалог. | Когда код сломан, но анализ в диалоге всё ещё ценен. |
| Суммировать отсюда | Сжимает диалог после контрольной точки в сводку, сохраняя полную историю до неё. | Когда вы просто хотите очистить избыточный диалог в последующей части, сохранив полный предыдущий контекст. |
Контрольные точки сохраняются между сеансами — вы всё ещё можете откатиться к предыдущим контрольным точкам после закрытия терминала. Это не замена git, но это удобнее, чем ручной git stash в исследовательских экспериментах.
5. Быстрые вопросы без загрязнения контекста (/btw)
Если вам нужно быстро уточнить небольшую деталь, но вы не хотите, чтобы вопросы и ответы попадали в историю диалога (расходуя контекст), используйте/btw:
/btw 这个项目的 TypeScript 版本是多少?
Ответ будет отображаться в плавающем слое, и ни вопрос, ни ответ не попадут в историю диалога. Подходит для поиска настроек, номеров версий и другой разовой информации, которую не нужно сохранять.
Команды управления сессиями
| Команда | Функция | Сценарий использования |
|---|---|---|
/context |
Просмотр подробного анализа использования токенов для каждой части контекста | Определить, какая часть израсходовала слишком много токенов |
/compact [指令] |
Сжать историю разговора в сводку с возможностью указать, что сохранить | Проактивно сжимать, когда контекст заполнен на 60~70% |
/clear |
Очистить всю историю разговора, сохранив CLAUDE.md и | Переключиться на новую задачу или когда контекст сильно загрязнён |
/rewind(или дважды нажмите Esc) |
Открыть меню контрольных точек, чтобы выбрать восстановление разговора/кода/обоих или продолжить с определённой сводки | Claude сбился с пути, нужно откатиться и повторить попытку |
/memory |
Просматривать и редактировать содержимое CLAUDE.md и автоматической памяти | Проверить, точна ли память, удалить устаревшие записи |
/btw |
Быстрый вопрос, ответ не попадает в историю диалога | Искать мелкие детали, не засоряя контекст |
/init |
Проанализировать проект и создать или улучшить CLAUDE.md | Первое использование в новом проекте или когда в проекте произошли крупные изменения |
#(сочетание клавиш) |
Быстро добавить постоянную инструкцию в CLAUDE.md | Записывать соглашения или договорённости в любое время |
claude --continue |
Продолжить последнюю сессию | Продолжить работу после повторного открытия терминала |
claude --resume |
Выбрать сессию из списка истории для продолжения | Возобновить конкретную задачу, начатую несколько дней назад |
Распространённые проблемы и решения
Проблема 1: Claude не соблюдает правила в CLAUDE.md
- Проверьте, не слишком ли велик CLAUDE.md (процент соблюдения падает, когда он превышает 200 строк)
- Замените расплывчатые формулировки на конкретные инструкции: не пишите "пиши чистый код", пишите "используй отступ в 2 пробела"
- использовать
/memoryПроверьте конфликтующие записи авто-памяти - Рассмотрите использование
.claude/rules/Разделите правила по путям к файлам, чтобы уменьшить объём загрузки каждый раз
Проблема 2: Claude начинает противоречить сам себе и "забывает" предыдущие решения
- Это типичный симптом деградации контекста. Не продолжайте исправлять в той же сессии
- Запустите
/compact 保留关键决策, или напрямую/clearзатем перезапустите с резюме - Используйте для важных выводов
#Запишите в CLAUDE.md с помощью сочетания клавиш, чтобы это продолжало действовать в следующей сессии
Проблема 3: ключевая информация теряется после /compact
- Передавайте конкретные инструкции при сжатии:
/compact 保留认证流程的架构决策和已确认的 API 格式 - Запишите самые важные выводы в CLAUDE.md перед сжатием
- Неудачные попытки отладки не стоит сохранять; можно сжимать более агрессивно или использовать /clear
Проблема 4: как продолжить работу с прошлого раза после закрытия терминала
- Используйте
claude --continueПродолжить последнюю сессию - Используйте
claude --resumeВыберите конкретную сессию из списка истории - использовать
/renameДавайте важным сессиям описательные имена (например, "oauth-migration"), чтобы их было легче найти позже
Проблема 5: большая задача создаёт много вывода инструментов. Как избежать переполнения контекста
- Используйте субагентов для делегирования: основной диалог получает только сводку, а промежуточный вывод остаётся в независимом контексте субагента
- Например:
Use sub-agents to analyze all log files, identify performance bottlenecks, and only report the conclusions to me.