Документации нет: как правильно читать справочные материалы
Tim TEN
0:00 / 0:00
Документации нет: как правильно читать справочные материалы
15 просмотров · 23 ч назад
Tim TEN
3,43 тыс. подписчиков
15 просмотров · 23 ч назад
Третий бонусный эпизод, после четырнадцати видеоуроков, на которых строилась эта серия. Видео 14 по-прежнему является финалом; ничто здесь его не заменяет.
Этот эпизод посвящен двум страницам, которые люди пролистывают, а не читают: справочнику настроек Claude Code
и справочнику CLI. Аргумент заключается в том, что справочная страница — это не просто длинное руководство. Она
отвечает на три вопроса, на которые руководство структурно не может ответить — и все три касаются границ, а не
того, как что-либо сделать.
*Где это может находиться?* Никто не говорит вам, сколько всего настроек, поэтому мы посчитали: индекс
содержит 234 строки, а страница содержит 234 ключевых заголовка. Это наше число, а не число страницы — см. закрепленный комментарий. Индекс имеет четыре столбца, и четвертый — это «Область действия». Страница определяет каждое значение
в одном предложении, которое полностью цитируется в видео. «Любой файл» означает все четыре файла настроек.
Все остальные значения означают меньше четырех. Подсчет в столбце «Область действия» от 28 сентября 2026 г.: 156
ключей относятся к категории «Любой файл», а 43 — к категории «Управляемые», то есть они вступают в силу только с того файла, который развертывает организация. Один из этих 43 — claudeMd, который внедряет инструкции в стиле CLAUDE.md
из управляемых настроек и, как говорится на странице, «загружает текст в качестве записи в управляемой памяти перед файлами CLAUDE.md пользователя и проекта».
*Что превосходит его по эффективности в одном запуске?* Откройте любой отдельный ключ, и вы увидите поле, которое большинство читателей пропускают:
«Переопределения для каждой сессии». В нем указан флаг командной строки, который переопределяет этот ключ для одной сессии — и этот флаг находится на другой странице. Чтение двух справочных страниц как одного документа — это наше, а не их мнение; ни на одной из страниц это не указано как правило, и видео это подтверждает на экране.
*С каких это пор?* Точная фраза «Требуется Claude Code v2.1.x» встречается 55 раз на странице настроек,
в 44 разных ключах, охватывая 29 различных версий, а не группируясь в одном
релизе. (На странице также используются другие формулировки ограничений, которые этот диапазон намеренно исключает.) Организация может
установить свой собственный минимальный уровень с помощью requiredMinimumVersion, который, как отмечается на странице, «запускается только при запуске,
поэтому уже запущенная сессия продолжается».
И то, чего вам никогда не дадут в руководстве: некрологи. В справочнике CLI описан параметр
--enable-auto-mode, запись в котором начинается со слов «Удалено в v2.1.111». Нахождение в справочнике не означает
то же самое, что доступность.
**Также есть предостережения**, потому что именно в справочнике находятся предостережения. Правило запрета, которое гласит:
Bash(curl *) выглядит безупречно. На странице указано, что правило запрета Bash «соответствует команде, как её написал Клод», поэтому это правило не останавливает /usr/bin/curl.
**Два оригинальных практических вопроса**, написанных для этого видео, с раскрытым ответом и объяснением
самого заманчивого неправильного ответа. Ещё два вопроса в примечаниях к видео ниже.
*О источниках.* Обе страницы находятся на code.claude.com — на одном ресурсе, никогда не смешиваясь с платформой разработчика Claude или SDK агента. Каждое утверждение содержит заголовок страницы, адрес сайта и дату проверки.
Цитаты приведены дословно, и каждая вырезанная часть отмечена. Три вопроса наши и отображаются на
экране; оба практических сценария придуманы и помечены. Подсчеты ведутся по именованной таблице на
именованной странице в указанную дату, и данные с двух страниц никогда не суммируются.
*Одна вещь намеренно опущена.* На странице настроек находится таблица из восьми правил того, как
Claude Code объединяет ключи из разных источников. Это действительно интересно, и этого нет в этом видео, потому что в нём описывается одно нестандартное значение одного ключа, доступного только для управляемых ресурсов, для которого также требуется определённая версия. Версия этой таблицы с частичной областью видимости была бы хуже, чем её отсутствие.
*Это бонусный эпизод.* Видео 14 остаётся концом оригинальной серии; ничто здесь не открывает и не закрывает её заново.
*О сертификации.* В этом видео нет списка доменов экзамена, весовых коэффициентов доменов, механики экзамена и реальных экзаменационных вопросов.
Создано с помощью ИИ: сценарий, иллюстрации и голос закадрового голоса были сгенерированы ИИ, а затем проверены на соответствие первоисточникам.