Управление контекстом 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.md
Linux/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 может обнаружить самостоятельно, прочитав код

Примеры

# Пример CLAUDE.md (краткий и конкретный, каждый файл не более 200 строк)

## Часто используемые команды
- Управление пакетами: всегда используйте 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.
Другие расширения