Made on
Tilda
Каждый запуск Claude Code начинается с чистого листа: вчерашний разговор он не помнит. Чтобы не объяснять одно и то же каждое утро, правила пишут один раз в файл CLAUDE.md — и Claude читает его сам при каждом старте в этой папке.
Every Claude Code session starts from a blank page: it doesn't remember yesterday's conversation. To avoid explaining the same things every morning, you write the rules once in a CLAUDE.md file — and Claude reads it by itself every time it starts in that folder.
Помните из урока 15-01: Claude — умный новичок, который ничего не знает о компании. Теперь представьте, что этот новичок каждое утро приходит с полной потерей памяти. Что вы сделаете? Положите ему на стол памятку: кто вы, что нельзя трогать, где лежат файлы, как сдавать работу. Он прочитает её первым делом — и весь день будет работать по вашим правилам.
Recall lesson 15-01: Claude is a smart newcomer who knows nothing about the company. Now imagine this newcomer arrives every morning with total memory loss. What do you do? Leave a note on their desk: who you are, what not to touch, where files live, how to hand in work. They read it first thing — and work by your rules all day.
C:\Program Files\ClaudeCode\CLAUDE.mdКладёт IT. Действует для всех на этом компьютере, отключить нельзя.Placed by IT. Applies to everyone on the computer and can't be excluded.%USERPROFILE%\.claude\CLAUDE.mdВаши привычки для всех папок: язык, единицы, стиль ответа.Your habits for all folders: language, units, answer style..\CLAUDE.mdВ папке проекта. Общий для всех, кто работает с этой папкой.In the project folder. Shared by everyone who works in it..\CLAUDE.local.mdВаши личные заметки к этому проекту, коллегам не передаётся.Your private notes for this project, not shared.| Как Claude читаетHow Claude reads them | Что это значит для васWhat it means for you |
|---|---|
| При запуске — CLAUDE.md из папки, где вы запустили, и из всех папок вышеAt launch — CLAUDE.md from the folder you started in and every folder above it | Общие правила отдела — в верхней папке, правила отчёта — в его папкеTeam-wide rules go in the top folder, report rules in the report's folder |
| Файлы складываются, а не заменяют друг друга; ближний к вам читается последнимFiles are combined, not replaced; the one closest to you is read last | Противоречия опасны: Claude может выбрать любое из двух правилContradictions are risky: Claude may pick either rule |
| CLAUDE.md во вложенных папках — когда Claude начинает работать с файлами тамCLAUDE.md in subfolders — once Claude starts working with files there | Правило для одной подпапки не засоряет остальную работуA rule for one subfolder doesn't clutter the rest |
Проверить, какие файлы Claude прочитал, — команда /context, список «Memory files».
To check which files Claude loaded, run /context and look at "Memory files".
| CLAUDE.md | Авто-памятьAuto memory | |
|---|---|---|
| Кто пишетWho writes | ВыYou | Claude самClaude itself |
| Что тамWhat's inside | Правила и инструкцииRules and instructions | Выводы из ваших поправокLessons from your corrections |
| Когда читаетсяWhen it loads | Каждая сессия, целикомEvery session, in full | Каждая сессия: оглавление MEMORY.md, первые 200 строкEvery session: the MEMORY.md index, first 200 lines |
| Как попастьHow to add | «Добавь это в CLAUDE.md» или правка через /memory"Add this to CLAUDE.md" or edit via /memory | «Запомни, что…»"Remember that…" |
Авто-память включена по умолчанию и хранится только на вашем компьютере. Выключить или открыть её папку — тоже через /memory.
Auto memory is on by default and stays on your computer only. Switch it off or open its folder — also via /memory.
Так, чтобы можно было проверить. Не «аккуратно с файлами», а «исходные выгрузки в папке Данные только читать».
Checkable. Not "be careful with files" but "source exports in the Data folder are read-only".
До 200 строк. Длинный файл занимает место на «рабочем столе» (урок 15-05) и соблюдается хуже.
Under 200 lines. A long file takes up "desk space" (lesson 15-05) and is followed less well.
Заголовки и пункты, а не сплошной текст.
Headings and bullets, not walls of text.
Раз в месяц перечитайте и уберите устаревшее.
Reread monthly and remove what's outdated.
Когда дописывать: Claude второй раз сделал ту же ошибку; вы снова набираете ту же поправку; новому коллеге понадобилось бы то же объяснение.
When to add: Claude makes the same mistake a second time; you type the same correction again; a new colleague would need the same explanation.
Чего не писать: длинные пошаговые процедуры (их место — в навыке, урок 15-28), пароли и ключи — никогда.
What not to write: long step-by-step procedures (they belong in a skill, lesson 15-28); passwords and keys — never.
| БлокBlock | Пример строкиSample line |
|---|---|
| 1. Кто я и как со мной говорить1. Who I am and how to talk to me | «Я экономист, не программист. Отвечай по-русски, коротко, без жаргона»."I'm an analyst, not a programmer. Answer in English, briefly, no jargon." |
| 2. Жёсткие запреты2. Hard rules | «Исходные файлы только читать. Результат — новым файлом рядом»."Source files are read-only. Results go in a new file next to them." |
| 3. Рабочий цикл3. Work cycle | «Понять источник → сверить с эталоном → правка → пересборка → проверка → обновить описание»."Understand the source → reconcile with the reference → change → rebuild → check → update the docs." |
| 4. Где лежат файлы4. Where files live | «Выгрузки — в .\Данные, результаты — в .\Отчёты. Пути только относительные, без имени компьютера»."Exports in .\Data, results in .\Reports. Relative paths only, no computer name." |
| 5. Единицы и формат5. Units and format | «Суммы — в тысячах тенге, одна единица на всю таблицу. В Excel числа числами»."Amounts in thousand tenge, one unit per table. In Excel, numbers as numbers." |
| 6. Когда спрашивать6. When to ask | «Если непонятно — спроси, не угадывай. Вопросы — по одному»."If unclear — ask, don't guess. One question at a time." |
Правило «не скачивать заново то, что уже скачано» полезно, если Claude тянет данные из медленной системы: исторические месяцы не меняются, обновлять нужно только текущий.
The rule "don't re-download what's already downloaded" helps when Claude pulls data from a slow system: past months don't change, only the current one needs refreshing.
# CLAUDE.md — Финансы, отчёт план/факт («Долина напитков»)
## Кто я и как со мной работать
- Я экономист отдела финансов, не программист. Пиши по-русски, коротко.
- Термины (план, факт, отклонение, YTD) не переводи.
- Если задача непонятна — спроси. Вопросы задавай по одному.
## Жёсткие запреты
- Файлы в .\Данные — только читать. Ничего в них не менять и не удалять.
- Результат — всегда новым файлом в .\Отчёты, имя: Отчёт_план_факт_ГГГГ-ММ.xlsx
- Никаких абсолютных путей и имён компьютера в скриптах.
- Месяцы, которые уже скачаны, заново не скачивать. Обновлять только текущий.
## Где что лежит
- .\Данные\план.xlsx — бюджет на год, лист «План», тыс. тенге
- .\Данные\факт_ММ.xlsx — факт месяца из учётной системы
- .\Отчёты\ — готовые отчёты
- .\Скрипты\ — скрипты сборки; запуск — Собрать.bat
## Единицы и формат
- Суммы — в тысячах тенге, одна единица на всю таблицу. Не в миллионах.
- Отклонение = факт − план; в % — к плану, один знак после запятой.
- В Excel числа — числами, без заливок. Итоги — формулами.
## Рабочий цикл
1. Открой источник, покажи листы и колонки. Структуру не додумывай.
2. Сверь итог с листом «Итого» в план.xlsx до того, как строить отчёт.
3. Сделай правку → пересобери (Собрать.bat) → проверь итог ещё раз.
4. Коротко напиши, что изменилось, и обнови README.md.
## Проверка перед сдачей
- Итог отчёта = итог источника (расхождение 0).
- Отклонения больше 10 % — с комментарием причины или пометкой «уточнить». # CLAUDE.md — Finance, plan/actual report (Valley Beverages)
## Who I am and how to work with me
- I'm a finance analyst, not a programmer. Write in English, briefly.
- Don't translate terms (plan, actual, variance, YTD).
- If the task is unclear — ask. One question at a time.
## Hard rules
- Files in .\Data are read-only. Never change or delete them.
- Results always go in a new file in .\Reports, name: PlanActual_YYYY-MM.xlsx
- No absolute paths or computer names in scripts.
- Don't re-download months already downloaded. Refresh only the current one.
## Where things are
- .\Data\plan.xlsx — annual budget, sheet "Plan", thousand tenge
- .\Data\actual_MM.xlsx — monthly actuals from the accounting system
- .\Reports\ — finished reports
- .\Scripts\ — build scripts; run Build.bat
## Units and format
- Amounts in thousand tenge, one unit per table. Not millions.
- Variance = actual − plan; in % — against plan, one decimal.
- In Excel, numbers as numbers, no fills. Totals as formulas.
## Work cycle
1. Open the source, show sheets and columns. Don't guess the structure.
2. Reconcile the total with the "Total" sheet in plan.xlsx before building the report.
3. Make the change → rebuild (Build.bat) → check the total again.
4. Briefly say what changed and update README.md.
## Check before handing in
- Report total = source total (difference 0).
- Variances above 10% — with a reason or a "to clarify" note. 35 строк. Каждую можно проверить: да или нет.
35 lines. Each one can be checked: yes or no.
Отметьте строки, которые подходят вашей работе. Справа соберётся черновик — скопируйте его и допишите свои папки и единицы.
Tick the lines that fit your work. A draft builds on the right — copy it and add your folders and units.
… … /init. Claude осмотрит папку и предложит черновик. Если CLAUDE.md уже есть, /init предложит улучшения, а не перезапишет файл. Create a practice folder, put 2–3 of your files in it, start Claude Code there and type /init. Claude looks through the folder and proposes a draft. If a CLAUDE.md already exists, /init suggests improvements rather than overwriting it./memory, откройте CLAUDE.md проекта и вставьте черновик из конструктора. Уберите всё, что нельзя проверить. Type /memory, open the project CLAUDE.md and paste the draft from the builder. Remove anything that can't be checked.Перескажи в 5 пунктах, какие правила работы в этой папке ты знаешь из CLAUDE.md. Затем найди в моём CLAUDE.md правила, которые нельзя проверить или которые противоречат друг другу, и предложи, как их переписать. Сам файл пока не меняй.
List in 5 points the working rules for this folder that you know from CLAUDE.md. Then find rules in my CLAUDE.md that can't be checked or that contradict each other, and suggest how to rewrite them. Don't change the file yet.
| ОшибкаMistake | Как правильноDo this instead |
|---|---|
| Общие слова: «будь внимателен»Vague words: "be careful" | Проверяемое правило: что именно, где, какA checkable rule: what exactly, where, how |
| Файл на 500 строкA 500-line file | До 200 строк; процедуры — в навык (15-28)Under 200 lines; procedures go in a skill (15-28) |
| Пароль или ключ в CLAUDE.mdA password or key in CLAUDE.md | Никогда. Файл читают все, кто работает с папкойNever. Everyone working in the folder reads it |
| Путь вида C:\Users\Иванов\…A path like C:\Users\Smith\… | Относительный путь .\Данные — работает у любого коллегиA relative path .\Data — works for any colleague |
| Надеяться, что CLAUDE.md «запретит» опасноеRelying on CLAUDE.md to "forbid" danger | Жёсткий запрет — настройками разрешений (15-29)Hard blocks — via permission settings (15-29) |