Перейти к содержимому

Документации нет: как правильно читать справочные материалы

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 остаётся концом оригинальной серии; ничто здесь не открывает и не закрывает её заново. *О сертификации.* В этом видео нет списка доменов экзамена, весовых коэффициентов доменов, механики экзамена и реальных экзаменационных вопросов. Создано с помощью ИИ: сценарий, иллюстрации и голос закадрового голоса были сгенерированы ИИ, а затем проверены на соответствие первоисточникам.