Ваша настройка Claude Code неполная без этого

AAI LABS
컴퓨터/소프트웨어재택/원격 근무AI/미래기술

Transcript

00:00:00У Claude Code сейчас так много функций, что за ними действительно трудно уследить.
00:00:04Даже при том, что всё доступно в командном меню, многое остаётся не сразу
00:00:08очевидным.
00:00:09Большинство проблем, с которыми вы сталкиваетесь при использовании Claude Code, на самом деле имеют встроенные
00:00:13решения.
00:00:14Они просто запрятаны в конфигурационных файлах и переменных окружения, о которых почти никто не говорит.
00:00:18Мы изучили всё это и составили список скрытых настроек и флагов, которые вам стоит
00:00:22активировать прямо сейчас.
00:00:23Для проблем, у которых нет встроенного решения в Claude, мы также нашли несколько отличных
00:00:27open-source решений.
00:00:28Если вы когда-либо запускали команду insights или использовали Claude с флагом resume, вы могли
00:00:32заметить, что все отображаемые диалоги ограничены только одним месяцем, даже
00:00:37если вы пользуетесь Claude гораздо дольше.
00:00:39И если вам нужно вернуться к тем сессиям или вы хотите получить аналитику за
00:00:42более длительный период, то теперь, когда Opus 4.6 поддерживает контекстное окно в 1 миллион токенов, вы не
00:00:48сможете этого сделать, потому что Claude Code не хранит их в системе дольше
00:00:52месяца.
00:00:53Этот месяц — стандартный срок хранения данных, заданный в конфигурациях Claude,
00:00:57но это не значит, что вы не можете изменить эти настройки, чтобы хранить данные дольше.
00:01:01У Claude на самом деле есть настройка для этого.
00:01:02В основной папке .claud есть файл settings.json.
00:01:06Мы будем использовать этот файл для многих других настроек на протяжении всего видео.
00:01:09Именно так вы можете изменить многие настройки по умолчанию в Claude Code.
00:01:12Вы можете добавить поле cleanup period days с любым желаемым количеством дней.
00:01:16Так что, если вы установите 365, он сможет хранить историю переписки за целый год.
00:01:22А установив значение на ноль, вы прикажете ему не хранить диалоги вообще, а значит,
00:01:26вы не сможете извлечь информацию или просмотреть прошлые ссылки.
00:01:30Ещё одна вещь, которую вы можете сделать: внутри папки .claud вашего проекта можно настроить правила,
00:01:35специфичные для конкретных путей.
00:01:36Они загружаются в контекст, когда агент пытается изменить определённый файл.
00:01:40Эти правила срабатывают при операциях чтения и загружаются, когда шаблон пути совпадает
00:01:44с читаемым файлом.
00:01:45Они содержат все инструкции, которым необходимо следовать при работе с этим файлом.
00:01:49Обычно люди добавляют это в основной файл claud.md.
00:01:52Они сваливают все инструкции, касающиеся разных аспектов приложения, в одно место.
00:01:57Хотя сейчас нам не нужно беспокоиться о контексте, разделение ответственности всё же полезно,
00:02:01когда ваше приложение становится слишком большим.
00:02:03Сваливание всего в кучу иногда приводит к тому, что Claude игнорирует ваши инструкции, потому что
00:02:07файл стал слишком объемным и перегруженным, и Claude не понимает, на чём именно
00:02:11нужно сосредоточиться.
00:02:12Например, если он работает над фронтендом, ему нужно загрузить только инструкции для
00:02:17React-компонентов, а не все сразу.
00:02:19Это помогает агенту оставаться более сфокусированным.
00:02:21Как вы уже знаете, Claude Code может выполнять bash-команды и читать их вывод.
00:02:25Но в зависимости от команды, этот вывод может быть огромным.
00:02:28Anthropic установила лимит на количество символов, которые Claude может прочитать из вывода любой
00:02:33команды, и этот лимит составляет 30 000 символов.
00:02:35Всё, что сверх этого, обрезается, и Claude этого никогда не увидит.
00:02:38Так что, к примеру, если вы запустите тесты и они выведут тысячи строк результатов,
00:02:42Claude прочитает только установленные 30 000 символов этого вывода.
00:02:46То же самое касается логов сборки или выполнения миграций базы данных.
00:02:50При любой команде, выдающей много данных в терминал, Claude получает лишь 30 000 символов.
00:02:54Чтобы это исправить, в settings.json есть параметр, который управляет количеством символов,
00:02:59которые Claude Code загружает из терминала в своё контекстное окно.
00:03:03Лимит в 30к был установлен из-за старых моделей с контекстом в 200к, где нельзя было
00:03:08позволить себе загружать больше.
00:03:09Но опять же, с новым окном в 1 миллион токенов это больше не проблема.
00:03:13Вы можете увеличить это значение до 150 000, чтобы весь вывод загружался полностью
00:03:18и Claude мог прочитать всё как следует.
00:03:20Если вы работаете над проектом, в котором много субагентов, адаптированных под
00:03:24выполнение своих задач, то для конкретной задачи мы обычно
00:03:29явно просим Claude в промпте использовать именно этого агента.
00:03:33Но если вы хотите быстро передать работу конкретному агенту, вы можете запустить Claude
00:03:37в режиме субагента.
00:03:38Вам просто нужно использовать флаг agent и ввести имя субагента, от лица которого вы хотите
00:03:42запустить Claude.
00:03:43Теперь вы можете делегировать задачи напрямую и использовать его возможности и инструменты без
00:03:47лишних затрат времени на то, чтобы Claude сначала загрузил этого субагента, а затем выполнил задачу.
00:03:51Вы уже знаете, что можно настроить модель и конфигурацию инструментов MCP при настройке
00:03:57субагентов, но есть ещё много других параметров, которые можно добавить.
00:04:00Например, субагенты по умолчанию не наследуют навыки (skills), но если использовать флаг skill,
00:04:04вы можете заставить агента наследовать навык, созданный специально для этого субагента.
00:04:08Это означает, что он действительно сможет использовать этот навык для выполнения своих задач.
00:04:11Помимо навыков, есть ещё один флаг под названием effort (усилие).
00:04:14Если вы не знали, effort определяет, сколько токенов и мыслительной мощности агент тратит
00:04:18при выполнении задач.
00:04:19Некоторым агентам по умолчанию не требуется много усилий, так что вы можете менять это в зависимости от задачи.
00:04:23В дополнение к effort, внутри субагента можно настроить хуки (hooks), специфичные
00:04:28для рабочего процесса именно этого агента.
00:04:29Также можно указать, должен ли агент всегда работать в фоновом режиме, используя флаг
00:04:33background.
00:04:34Установите true, если хотите, чтобы агент работал полностью в фоне, не мешая
00:04:38основному агенту, или false, если хотите, чтобы он всегда был на виду.
00:04:42Вы также можете запускать субагентов изолированно в отдельном рабочем дереве, задав параметр
00:04:47isolation в описании агента.
00:04:49Изолированные агенты получают временную копию рабочего дерева, что даёт им простор для внесения
00:04:53серьёзных изменений без риска для основной кодовой базы.
00:04:55Если агент не вносит изменений, рабочее дерево очищается автоматически.
00:04:59Если же изменения есть, возвращается путь к рабочему дереву и ветка для слияния и проверки.
00:05:03Такая схема лучше всего подходит для экспериментов с подходами, которые могут сломать основной код.
00:05:08Наконец, вы можете контролировать, каких агентов разрешено порождать данному агенту, добавив разрешённые
00:05:12имена агентов в раздел tools конфигурации этого агента.
00:05:16Это ограничивает порождение новых агентов, чтобы они не создавались без нужды, предотвращая
00:05:20ситуации, когда один агент выходит из-под контроля и бесконечно плодит других.
00:05:24По умолчанию, когда Claude читает файл, он считывает только 25к токенов.
00:05:28Но с тех пор как контекстное окно увеличилось до 1 миллиона токенов, 25к — это слишком мало,
00:05:34и это не позволяет Claude использовать свой потенциал на полную.
00:05:36Вы можете изменить это в settings.json, установив этот флаг на 100к или более.
00:05:41Но есть ещё один нюанс.
00:05:42Независимо от размера контекстного окна, Claude читает только 2000 строк, и он даже
00:05:47не осознаёт, что пропустил остальные строки, поэтому никогда не возвращается, чтобы дочитать файл.
00:05:51Anthropic не позволяет менять этот лимит.
00:05:53Но есть обходной путь.
00:05:54Вы можете добавить инструкцию в файл claud.md, чтобы при чтении больших файлов
00:05:59Claude сначала проверял количество строк.
00:06:01Если в файле более 2000 строк, он использует параметры offset и limit, чтобы прочитать весь файл
00:06:06полностью, ничего не пропуская в середине.
00:06:08Мы также можем настроить хук, который срабатывает при каждом выполнении команды чтения.
00:06:12Этот хук проверяет количество строк в файле, и если их больше 2000, он заставляет агента
00:06:16следовать инструкции в claud.md, используя такие команды, как HEAD, чтобы гарантировать, что Claude прочитает
00:06:21всё до конца.
00:06:22Как вы знаете, Claude Code автоматически запускает сжатие (compact), когда контекстное окно заполнено на
00:06:2795%.
00:06:28Но даже с миллионным контекстным окном агенту на самом деле не стоит ждать,
00:06:32пока оно заполнится на 95%.
00:06:35Качество ответов обычно начинает снижаться, когда окно заполняется до 70%.
00:06:40Это подходящее время для автоматического сжатия, если только вам не нужен
00:06:44полный миллион токенов контекста.
00:06:45Чтобы это изменить, нужно просто добавить флаг в settings.json и установить значение
00:06:50auto-compact percentage override на нужный вам процент.
00:06:53Мы установили у себя 75%.
00:06:55С этой настройкой, когда контекстное окно достигнет 75%, оно автоматически сожмётся,
00:07:00сохраняя качество работы агента.
00:07:02Но прежде чем перейти к следующим функциям, пару слов от нашего спонсора — Make.com.
00:07:06Мы все знаем, что главный риск работы с ИИ — это эффект "чёрного ящика".
00:07:09Вы внедряете агентов, но не можете проверить их решения.
00:07:12Новые агенты от Make полностью меняют это.
00:07:14Их визуальная платформа сочетает no-code и ИИ для запуска агентов, управляющих вашим бизнесом.
00:07:19Вы можете создавать интеллектуальных агентов прямо на их визуальном холсте.
00:07:22Просто задайте агенту цель, и благодаря более чем 3000 нативных интеграций он возьмёт на себя
00:07:27сложные решения.
00:07:29Помимо агентов, платформа полна других возможностей.
00:07:31Вы получаете готовые шаблоны для быстрого старта, MCP для безопасных соединений и функцию
00:07:36Knowledge (знания) для обоснованных ответов.
00:07:38Панель рассуждений позволяет видеть, контролировать и доверять каждому шагу ИИ.
00:07:42Плюс, с Make Grid ваш мониторинг и аналитика собраны на одной централизованной карте.
00:07:46Перестаньте делать рутинную работу вручную и создавайте эффективные процессы, экономящие время.
00:07:52Перейдите по ссылке в закреплённом комментарии, чтобы получить бесплатный месяц тарифа Pro и попробовать
00:07:56Make уже сегодня.
00:07:57Многие из вас могут знать об этом, но Agent Teams всё ещё находится в экспериментальном режиме, поэтому
00:08:01не все о нём слышали.
00:08:03В Agent Teams есть один лидер команды и несколько участников, каждый из которых является отдельной
00:08:07сессией Claude, запущенной и контролируемой лидером.
00:08:10Лидер команды отвечает за координацию всей задачи между всеми участниками.
00:08:15Это отличается от обычных субагентов, потому что субагенты не могут общаться
00:08:19друг с другом.
00:08:20В то время как в команде агентов каждый участник может общаться с остальными и
00:08:24делиться информацией.
00:08:25Мы сняли об этом отдельное видео, где подробно разбираем функции и то, как
00:08:29использовать их максимально эффективно.
00:08:32Также, если вам нравится наш контент, не забудьте нажать кнопку поддержки, это помогает
00:08:36нам создавать больше таких видео и охватывать больше людей.
00:08:40Если вы управляете несколькими конфигурациями для разных видов работ, есть open-source
00:08:44инструмент Claude CTX, который позволяет быстро переключаться между профилями,
00:08:49раздельно управлять настройками клиентов, а также правами доступа и инструментами
00:08:54в одном пространстве.
00:08:55Команды для установки доступны для всех операционных систем.
00:08:58На Mac можно использовать brew install, а на других системах можно установить,
00:09:02склонировав репозиторий.
00:09:03Инструмент управляет вашими settings.json, claud.md, MCP-серверами и бэкапами, отслеживая
00:09:08профили через папку profiles внутри основной папки .claud.
00:09:12Эта папка содержит подпапку для каждого профиля со своими файлами settings.json и
00:09:17claud.md, оптимизированными под конкретные задачи.
00:09:21Каждый файл настроек содержит только те разрешения, которые нужны для этого профиля, чтобы ничего
00:09:26не смешивалось.
00:09:27Переключение профилей очень простое.
00:09:29Проверить текущий профиль можно флагом C, а чтобы переключиться, введите claud ctx
00:09:34и название нужного профиля.
00:09:35При переключении создаётся бэкап текущего рабочего состояния в папке backup,
00:09:39так что у вас всегда есть запись о предыдущем профиле.
00:09:42Так вы можете держать несколько профилей полностью изолированными, и Claude будет работать
00:09:47ровно с теми правами, которые ему нужны.
00:09:50Ресурсы из всех наших прошлых видео доступны в AI Labs Pro.
00:09:54Шаблоны, навыки и куча других штук, которые можно просто подключить к своим проектам.
00:09:58Если наша работа приносит вам пользу и вы хотите поддержать канал, это лучший
00:10:02способ это сделать.
00:10:03Ссылка находится в описании.
00:10:04Если вас раздражает, когда Claude указывает себя соавтором в GitHub-коммитах, для этого
00:10:09тоже есть решение.
00:10:10В settings.json добавьте ключ attribution и оставьте поля commit и PR пустыми.
00:10:15После этого, когда вы попросите Claude сделать пуш в GitHub, он не будет указывать себя соавтором.
00:10:18Также можно задать кастомную строку, чтобы в коммите отображалось любое выбранное вами имя автора.
00:10:23По умолчанию Claude Code добавляет себя в соавторы каждого коммита, а значит,
00:10:28он появляется в графике контрибьюторов вашего репозитория.
00:10:30Также Claude Code отправляет аналитические данные в Statsig, где отслеживаются паттерны использования
00:10:35и операционные данные, такие как задержка и надёжность.
00:10:37Эти данные используются для A/B тестирования функций и общей аналитики.
00:10:41Он также отправляет данные в Sentry для логирования ошибок, позволяя Anthropic диагностировать
00:10:45сбои и баги в продакшене.
00:10:47Но если вы хотите отказаться от этого, можно добавить три переменные в основной settings.json.
00:10:52Они отключают телеметрию, отчёты об ошибках и отображение обратной связи.
00:10:55С этими настройками Claude Code перестанет отправлять ваши данные вовне, сохраняя приватность.
00:10:59Но в Claude Code также есть отдельный CLI-флаг для отключения второстепенного трафика,
00:11:04который, на первый взгляд, делает то же самое.
00:11:06Разница в том, что этот флаг также блокирует автообновления, что вам, скорее всего, не нужно.
00:11:11Так что лучше полагаться на те три настройки, так как они дают тот же уровень приватности,
00:11:15не отрезая вас от обновлений.
00:11:17Многие также не знают о функции prompt stashing (откладывание промпта) в Claude Code.
00:11:20Если вы пишете промпт и понимаете, что сначала нужно отправить Claude Code другую задачу,
00:11:24вы можете нажать Ctrl + S, чтобы "спрятать" текущий текст.
00:11:28После этого вы можете напечатать и отправить новую задачу, а ваш отложенный промпт
00:11:31автоматически вернётся в поле ввода.
00:11:33Многие из вас уже используют хуки, но внутри них также можно использовать коды выхода,
00:11:37которые говорят Claude, следует ли продолжать выполнение, заблокировать его или игнорировать.
00:11:41Существует три основных типа кодов выхода.
00:11:44Код выхода 0 означает, что запуск прошёл успешно и назначенная задача
00:11:48выполнена корректно.
00:11:49Чаще всего его вывод не вставляется в контекст и служит просто индикатором того,
00:11:54что всё сделано правильно.
00:11:55Любой другой код выхода, кроме 0 и 2, отображается в режиме verbose и является неблокирующим.
00:12:01Это значит, что это сообщения об ошибках, но Claude не считает их достаточно серьёзными,
00:12:05чтобы остановить работу.
00:12:06Но самый важный — код выхода 2, который существенно влияет на рабочие процессы.
00:12:10Когда мы используем код выхода 2 с любым инструментом, сообщение об ошибке возвращается к Claude,
00:12:15и он вынужден отреагировать на это сообщение.
00:12:17К примеру, часто бывает, что вы хотите использовать определённую библиотеку, но Claude
00:12:21предлагает другую из-за своих заученных паттернов.
00:12:24Чтобы это предотвратить, можно настроить хук, который будет запускаться перед каждой bash-командой.
00:12:28Он проверяет, совпадает ли команда, которую хочет использовать Claude, с той библиотекой, которую вы не хотите,
00:12:33как в моём случае с pip, выводит сообщение о запрете использования pip, велит использовать
00:12:37uvicorn и завершается с кодом 2.
00:12:41Теперь, когда Claude попытается установить что-то через pip, он будет вынужден вместо этого
00:12:45использовать uvicorn.
00:12:46Эти хуки с кодами выхода лежат в основе ralfloops, которые
00:12:50стали очень популярны некоторое время назад.
00:12:52Мы также делали о них подробное видео, которое вы можете найти на нашем канале.
00:12:56Они используют тот же механизм кодов выхода и хуков, чтобы заставлять Claude продолжать итерации,
00:13:01пока критерии завершения задачи не будут полностью выполнены.
00:13:03Это гарантирует, что Claude не будет филонить и помечать недоделанные задачи как выполненные.
00:13:08Такие хуки помогают в создании множества похожих рабочих процессов.
00:13:11На этом мы заканчиваем наше видео.
00:13:13Если вы хотите поддержать канал и помочь нам выпускать больше подобных роликов,
00:13:17вы можете сделать это с помощью кнопки Super Thanks ниже.
00:13:19Как всегда, спасибо за просмотр, и увидимся в следующем видео.

Key Takeaway

Максимальная эффективность Claude Code достигается через тонкую настройку конфигурационных файлов и использование скрытых флагов, которые позволяют обойти стандартные ограничения контекста и полностью контролировать поведение агентов.

Highlights

Настройка файла settings.json для увеличения срока хранения истории диалогов и лимитов вывода терминала.

Использование специфических правил для путей и разделение ответственности в файле claud.md для улучшения фокуса ИИ.

Увеличение лимитов контекстного окна до 1 миллиона токенов и обход ограничения в 2000 строк при чтении файлов.

Оптимизация работы субагентов с помощью флагов agent, skill, effort и режима изоляции для безопасных экспериментов.

Управление автоматическим сжатием (compact) контекста при достижении 70-75% заполнения для сохранения качества ответов.

Конфиденциальность и отключение телеметрии, а также управление атрибуцией в коммитах GitHub.

Использование кодов выхода (особенно кода 2) в хуках для строгого контроля поведения Claude и предотвращения ошибок.

Timeline

Оптимизация хранения данных и лимитов терминала

Автор объясняет, что стандартные настройки Claude Code ограничивают историю диалогов одним месяцем, но это можно изменить в файле settings.json. Добавление параметра cleanup period days позволяет хранить переписку годами или вовсе её отключить. Также рассматривается критическая проблема обрезки вывода терминала на уровне 30 000 символов, что мешает анализу больших логов или тестов. Для решения предлагается увеличить лимит в настройках до 150 000 символов, используя возможности нового контекстного окна в 1 миллион токенов. Это позволяет Claude видеть полную картину выполнения команд без потери важных деталей в середине вывода.

Продвинутое управление субагентами и их навыками

В этом разделе описывается работа с субагентами в режиме прямой делегации задач через флаг agent. Спикер подчеркивает важность передачи конкретных навыков (skills) и настройки уровня усилий (effort) для каждого отдельного помощника. Особое внимание уделяется параметру isolation, который создает временную копию рабочего дерева для безопасного тестирования кода. Также объясняется, как ограничить список разрешенных агентов в разделе tools, чтобы избежать бесконечного порождения новых процессов. Эти меры делают работу с ИИ-агентами более структурированной, безопасной и предсказуемой в больших проектах.

Работа с большими файлами и управление контекстом

Автор раскрывает скрытую проблему: Claude по умолчанию считывает только 25 000 токенов и 2000 строк кода, часто игнорируя остальное содержимое. Для обхода предлагается использовать специальные инструкции в claud.md и команды типа HEAD с параметрами offset и limit. Кроме того, обсуждается механизм автоматического сжатия контекста, который срабатывает при заполнении окна на 95%. Спикер рекомендует переопределить этот параметр до 75% в settings.json, так как качество ответов падает задолго до полного заполнения памяти. Такая настройка гарантирует, что агент всегда будет сохранять высокую точность рассуждений при работе со сложной кодовой базой.

Интеграции, визуальные агенты и инструмент Claude CTX

Раздел начинается с обзора платформы Make.com, которая позволяет визуализировать работу ИИ-агентов и избегать эффекта "черного ящика". Далее автор переходит к Agent Teams — экспериментальному режиму, где лидер координирует группу агентов, способных общаться между собой. Для тех, кто работает с разными клиентами, представлен open-source инструмент Claude CTX, упрощающий переключение между профилями настроек. Инструмент автоматически создает бэкапы и изолирует файлы claud.md и settings.json для каждого проекта. Это предотвращает путаницу в правах доступа и позволяет быстро адаптировать среду под конкретные технические задачи.

Приватность, атрибуция и контроль логики через хуки

Финальная часть посвящена вопросам приватности и строгого контроля за действиями Claude. Описывается способ отключения телеметрии и удаления ИИ из списка соавторов в коммитах GitHub через правки в settings.json. Ключевым моментом является использование кодов выхода в хуках, где код 2 заставляет Claude реагировать на ошибки и следовать установленным правилам. Это позволяет блокировать использование нежелательных библиотек и заставлять модель выполнять итерации до полного достижения цели. В завершение упоминается концепция ralfloops, которая использует эти механизмы для создания надежных и автономных рабочих процессов.

Community Posts

View all posts