CLAUDE.md файлын 2026 жылы қалай баптауға болады: үлгі және 6 ереже

Vibe coding туралы материалдар: құралдар, мысалдар, қателер. Ailoot нұсқаулықтары.

CLAUDE.md не үшін керек және онсыз Claude жобаны неге ұмытады?#

Сейсенбі күні Claude Code-ты ашып: «Мен осы жобамен жұмыс істеп жүрмін, міне, құралдар, мынаны істеме», деп түсіндіресіз. Ол жұмыс істейді.

Бейсенбіге қарай сол чат аяқталып қалады да, бәрін қайталайсыз. Сенбіде тағы, дүйсенбіде тағы бір рет.

CLAUDE.md жоқ агентпен жұмыс істеу осылай көрінеді: әр жаңа терезе - бәрін қайта-қайта айтуға тура келетін, ештеңе білмейтін тағылымгер. Бұрын әр сессияда осындай кіріспеге 5-10 минут жұмсайтынмын. Контексті қолмен жеткізуім керек болғандықтан, промпттар ұзарып кетті. Соған қарамастан нәтиже жалпы сипатта қалды: агент менің аудиториямды, экономикамды немесе ұстанымдарымды білмеді.

Жаңартылып отыратын CLAUDE.md болса, кіріспе түсіндіру қажет болмайды. Бұрын әр чатта қайталайтын ережелердің бәрі бір файлда сақталып, әр сессияның басында автоматты түрде жүктеледі. Промпт қысқа болады: «X-ті істе», ал «Y жобасымен жұмыс істеп жүрмін, құралдарым - Z, A мен B-ні істеме, айтпақшы, C-ні де ұмытпа» емес.

Содан кейін қайталана беретін қателер жоғалады.

Агенттің әр қатесі - CLAUDE.md файлына бір жол қосуға себеп. Бір айдан кейін сізде үнемі жаңартылып тұратын «жоба конституциясы» пайда болады, ал Claude бұрынғы таныс тұзақтарға түсуін қояды.

Үшінші пайдасы да бар: агент контекстсіз жазбайды. CLAUDE.md арқылы мен Claude-ты аудитория, баға және бренд туралы ақпарат бар бумаларға бағыттаймын. Мұндай бағыттау болмаса, агент экономикамды білмей, «сапалы шешімдер» жазады, сондықтан мәтіндері дерексіз, бірсарынды әрі «басқалардікіндей» болып шығады.

CLAUDE.md деген не және Claude оны қандай ретпен оқиды?#

Anthropic ресми құжаттамасында CLAUDE.md файлын былай сипаттайды:

Claude Code CLAUDE.md файлын іздейтін төрт орын, басымдығы өсу ретімен:

Төрт файл да контекстке бір мезгілде жүктеледі. Ережелер қайшы келсе, Anthropic құжаттамасында қайсысы басым болатыны белгісіз екені тікелей айтылған; Claude олардың бірін кездейсоқ таңдауы мүмкін. Сондықтан маңызды нәрселердің бәрін жобаның CLAUDE.md файлына жинап, көшірмелерді жасамаған оңай.

Көп адам жазбайтын, бірақ көптеген түсініксіз әрекетті түсіндіретін бір техникалық жайт бар.

Басқаша айтқанда, CLAUDE.md қатаң мағынада «жүйелік промпт» емес. Ол - Claude көретін алғашқы пайдаланушы хабарламасы. Сондықтан оның ережелері заң емес, күшті ұсыныстар ғана. Ережені міндеттеу керек болса, қамтылған оқиғаға сыналған hook, кеңірек қолжетімділік шекарасына рұқсаттар не орта оқшаулауын қолданыңыз. Hook-тың автоматты орындалуы оның тексерулерін толық етпейді. hooks пен CLAUDE.md арасындағы шекараны төменде түсіндіремін.

Дайын үлгіні қолданып, минималды CLAUDE.md файлын 5 минутта қалай жазуға болады?#

Төмендегі үлгіні өзімнің ондаған жобамда сынап көрдім. Ол файлды шамамен 80-120 жол көлемінде ұстайды, бұл Anthropic ұсынған 200 жолдан төмен ұстау мақсатына сай. Бұл үлгімен агент барынша орынды нәтиже береді.

# [ЖОБАНЫҢ НЕГІЗГІ АТЫ] - жобаны шолу

Бұл құжат - жобаның картасы. Әр сессияның басында оны оқып,
қайда не барын және онымен қалай жұмыс істеу керегін түсініңіз.

## Бұл қандай жоба

**[АТЫ]** - [не екенін және кімге арналғанын бір сөйлеммен жазыңыз].
[Қандай мәселені және қалай шешетінін 1-2 сөйлеммен жазыңыз].

Толық мәлімет `business/INDEX.md` файлында.

## Әр сессияның басында оқу реті

1. `about-me/INDEX.md` - мен кіммін және қалай ойлаймын
2. `business/INDEX.md` - немен айналысамыз (өнім, аудитория, экономика)
3. `CLAUDE.md` (осы файл) - репозиторий ережелері, құралдар, навигация
4. Тапсырма аймағы: `business/`, `plans/<ағымдағы жоспар>`,
   `mastery/<сала>` ішіндегі тиісті файл немесе кодтағы функция бумасы

Қағида: 1-қабат (мен туралы) 2-қабаттан (бизнес) бұрын тұруы тегін емес.
Алдымен ойлайтын **кім**, содан кейін **не туралы** ойлайтыны.

## Репозиторий құрылымы

[ЖОБАНЫҢ АТЫ]/
├── CLAUDE.md            ← осы файл, навигация
├── about-me/            ← сіздің цифрлық бейнеңіз (қалай ойлайсыз, нені бағалайсыз)
│   └── INDEX.md
├── business/            ← бизнестің екінші миы
│   ├── INDEX.md
│   ├── audience/        ← клиент бейіні
│   ├── products/        ← өнімдер, бағалар
│   ├── goals/           ← мақсаттар, метрикалар
│   └── economics/       ← бірлік экономикасы, кіріс
├── plans/               ← техникалық жоспарлар (бір жоспар = бір функция)
├── retrospectives/      ← әр сессиядан кейінгі ой-толғаулар
└── (жоба коды)

### Қажетті ақпаратты қайдан табуға болады

| Сізге не керек | Қайдан қарау керек |
|---|---|
| Жобаны не үшін және кім үшін жасап жатырмыз | `business/INDEX.md` |
| Мақсатты клиент, мәселелері, қалаулары | `business/audience/` |
| Өнім, жоспарлар, бағалар | `business/products/` |
| Мақсаттар мен метрикалар | `business/goals/` |
| Экономика | `business/economics/` |
| Техникалық жоспарлар | `plans/` |

## Құралдар

[ҚҰРАЛДАРДЫ ЕНГІЗІҢІЗ - мысалы: Next.js 14, TypeScript, Tailwind CSS, Prisma + PostgreSQL].

## Репозиторий ережелері

1. Динамикалық деректерді (баға, күн, сан) ешқашан кодқа тікелей жазбаңыз -
   барлығын `business/` файлдарынан және LIVE маркерінен алыңыз.
2. Мен нақты бұйрық бермейінше жарияламаңыз.
3. `git push` алдында `npm run build` іске қосып, қатесіз әрі ескертусіз
   жиналатынын тексеріңіз.
4. Файлдарды `git add` арқылы атымен қосыңыз. Ешқашан `git add .` немесе `git add -A` қолданбаңыз.
5. `.env` файлын толық оқымаңыз. Айнымалыны тексеру үшін
   `grep "^VAR=" .env` қолданыңыз.

## Үлкен функциялар = `plans/` бумасындағы жоспар

Бір сағаттан ұзақ кез келген тапсырма `plans/` бумасында жоспар ретінде жазылуы керек:
1. Файл атауы: `YYYY-MM-DD-feature-name.md`.
2. Жоспарды кезеңдерге бөліңіз. Әр кезеңді `[ ]` немесе `[x]` деп белгілеңіз.
3. Жоспардың соңына іске толық асырылды ма және не қалды деген қорытынды қосыңыз.

## Функция аяқталғаннан кейінгі цикл

Әр функция аяқталғаннан кейін мына 5 қадамнан өтіңіз:
1. Қателерді табыңыз → мысалмен дәлелдеңіз → түзетіңіз.
2. Не ескерілмей қалды (шеткі жағдайлар, енгізуді тексеру, қателерді өңдеу).
3. Бұл біздің жобада шынымен мәселе ме? `business/` пен `plans/` бумаларын тексеріңіз.
4. Жаңадан қарап шығыңыз: айырманы алғаш көріп тұрғандай қайта оқыңыз.
5. Қауіпсіздікке шолу жасаңыз. Әсіресе жеке деректер мен үшінші тарап материалдарын тексеріңіз.

## Сессия соңындағы ой-толғау

`retrospectives/YYYY-MM-DD_short-name.md` файлына мыналарды жазыңыз:
1. Тапсырма қандай болды.
2. Қалай шешілді.
3. Шешілді ме - иә / жоқ / ішінара.
4. Нені жақсырақ істеуге болар еді.
5. Пайдаланушы немесе жоба туралы не білдіңіз.

## Тіл

Әрдайым пайдаланушы қалайтын тілде жауап беріңіз. Тек дефис қолданыңыз, ұзын сызықшаны қолданбаңыз.

Claude осы үлгіні жобаңыз үшін өзі толтыруы үшін оған мына промптты беріңіз. Ол контексті оқып, шаршы жақшадағы өрістерді толтырады:

Менің жобама арналған CLAUDE.md файлын осы үлгі бойынша жаса:

[ЖОҒАРЫДАҒЫ ТОЛЫҚ ҮЛГІНІ ЕНГІЗІҢІЗ]

Мына ретпен орында:

Жоба контекстін және автор ретінде мені түсіну үшін about-me/INDEX.md пен business/INDEX.md файлдарын оқы.

Осы бумалардан тапқан мәліметтерге сүйеніп, үлгідегі барлық тік жақшалы өрістерді толтыр.

Қандай да бір ақпарат жетіспесе, менен бір-бірден нақтылаушы сұрақтар қой, әр сұраққа 3-4 жауап нұсқасын бер.

Жасалған CLAUDE.md файлын 200 жолдан төмен ұстауға тырыс. Ұзын болса, қайталауды қарап, егжей-тегжейлі рәсімдерді сілтелген файлдарға көшір. Маңызды жоспарлау, ой-толғау және репозиторий ережелерін сақтап, өкілдік тапсырмаларда сына.

Маған дайын файлды көрсетіп, нені өзгерту керегін сұра.

Әрдайым пайдаланушы қалайтын тілде жауап бер.

Егер about-me/ және business/ бумалары әлі жоқ болса, уайымдамаңыз. Claude нақтылаушы сұрақтар қойып, қолда бар ақпаратқа сүйеніп минималды CLAUDE.md файлын құрастырады. Бұл бумаларды кейін, ішіне не салу керегін білгенде жасай аласыз.

CLAUDE.md файлын үнемі жаңартып отыратын 6 ереже қандай?#

1-ереже. 200 жолдан асырмаңыз

Anthropic ресми құжаттамасында мұны қысқа әрі нұсқа айтады:

Ұзын CLAUDE.md екі түрлі жолмен өзіне қарсы жұмыс істейді. Біріншіден, токендерді шығындайды. Нұсқаулары 800 жолдан тұратын файл әр терезеге жүктеліп, әр сессияда бюджетіңізден бірнеше мың токен жұмсайды. Күндік шектеуі бар Pro жазылымында бұл қолжетімді сессия санын айтарлықтай азайтады. Екіншіден, модель ережелерді елемей бастайды.

Құжаттама контекст шығынын азайтып, нұсқау орындалуын жақсартуға 200 жолдан төмен ұстауды ұсынады. Ол 201-жолда күрт істен шығуды дәлелдемейді. Нені шығаруды шешпес бұрын қажеттілікті, қайшылықтарды, жүктелген токен көлемін және нақты тапсырма нәтижесін қараңыз.

2-ереже. Әр сессияны ой-толғаумен аяқтаңыз

CLAUDE.md файлына былай жазыңыз: «Әр сессия соңында не істегеніңді және не үйренгеніңді retrospectives/YYYY-MM-DD_*.md файлына жаз». Осы жолды қосқан соң Claude әр сессияны өздігінен қорытындылап отырады; сұрап отырудың қажеті жоқ.

Ой-толғау не үшін қажет:

• Екі аптадан кейін ескі ой-толғауды ашып, неге сол жолды таңдағаныңызды еске түсіре аласыз.
• Бір айдан соң жобаға оралғанда, соңғы шешімдердің дайын картасы болады.
• Командамен жұмыс істесеңіз, әріптес ой-толғауды оқып, қоңыраусыз-ақ 2 минутта ағымдағы жағдайды түсіне алады.

3-ереже. Әр аяқталған тапсырмадан кейін коммит жасаңыз

Менің CLAUDE.md файлымда: «Әр аяқталған тапсырмадан кейін мағыналы хабарламасы бар git коммитін жаса» деп жазылған. Claude жұмысты өздігінен шағын, жеке коммиттерге бөле бастайды.

Мұның екі пайдасы бар. Біріншіден, бірдеңе бұзылса, «бүгін істегенімнің бәрін» емес, бір әрекетті кері қайтара аласыз. Екіншіден, коммит тарихы не және қандай ретпен өзгергенін көрсететін жұмыс журналына айналады.

4-ереже. business/ бумасын әрдайым қараңыз

Клиенттерге, өнімдерге немесе мәтінге қатысты тапсырмада агент алдымен business/INDEX.md файлын және ондағы тиісті файлды ашуы керек. Менің CLAUDE.md файлымда нақты былай делінген: «UI немесе мәтінмен жұмыс істегенде, алдымен business/audience/avatar.md пен business/assets/brand-guidelines.md файлдарын қара».

Бұл ереже болмаса, Claude мәтінді «сапалы веб-сайттың жалпы стилінде» жазады. Ереже болса, мәтін сіздің стиліңізге сай, клиентіңізге арналған және тыйым салынған сөздерсіз болады.

5-ереже. Агент әр қате жіберген сайын ереже қосыңыз

Бұл - CLAUDE.md файлын жаңартып отыратын басты ереже.

Нақты қателерден кейін өзімнің CLAUDE.md файлыма қосқан мысалдар:

• «Басқа біреудің WIP файлдарын ешқашан git add . арқылы коммиттемеңіз - файлдарды атымен staging-ке қосыңыз».
• «main тармағына push жасамас бұрын git log origin/main..main --oneline пәрменін тексеріңіз - нәтиже бос болмаса, push жасамаңыз».
• «Мәндерді ойдан шығармаңыз - оларды .env файлынан немесе кодтан алыңыз. Әсіресе URL, пайдаланушы аты және токендерді».

Бұл жолдардың әрқайсысы нақты оқиғаның ізі. Бірде агент әріптесінің аяқталмаған тармағын коммиттеді. Бірде мен басқа адамның push жасалмаған коммиттерін қостым. Тағы бірде агент жоқ URL-ды ойдан шығарды. Әр қате ережеге айналады, сол себепті өзіміз келтірген зиян қайталанбайды.

6-ереже. Қауіпсіздік ережелерін CLAUDE.md емес, .claude/settings.json ішіне жазыңыз

CLAUDE.md ішіне «.env файлына тиме» деп жазуға болады, бірақ бұл - өтініш қана; Claude оны бұзуы мүмкін, өйткені CLAUDE.md заң емес, пайдаланушы хабарламасы ретінде жүктеледі. Маңызды қауіпсіздік талаптары үшін .claude/settings.json қолданыңыз, онда белгілі бір командаларды қатаң блоктауға болады.

Әр жаңа жобаға қосатын бұғатталған пәрмендер тізімі:

• rm -rf (кез келген файлдарды рекурсивті өшіру).
• .env файлын толық оқу (Read .env).
• Бір пәрменде export және curl қолдану (құпияларды сыртқа шығаруы мүмкін тәсіл).
• Нақты рұқсатсыз git push --force орындау.

Басқа нұсқаулықтарды Ailoot сайтынан таба аласыз.

Белсенді бизнестегі CLAUDE.md құрылымы қандай (280 жолдық файлдың құрылысы)?#

Интернеттегі CLAUDE.md үлгілерінің көбі - әзірлеушілерге арналған техникалық үлгілер: «TypeScript қолданыңыз», «50 жолдан ұзақ тест жазбаңыз». Кәсіпкерге мұндай CLAUDE.md пайдасыз - онда бизнестің қырлары қамтылмаған.

Төменде өзім қолданып жүрген CLAUDE.md файлының құрылымы берілген. Ішкі жұмысымның сипатын ашатын нақты ережелер мен жолдарды алып тастадым. Бірақ бөлімдердің құрылымы мен логикасын кез келген жобаға қолдануға болады: өз жағдайыңызға бейімдесеңіз, жұмыс істейтін файл аласыз.

1. Жобаның қысқаша сипаттамасы (15 жол). Не істейміз, аудиториямыз кім, қандай өнімдер ұсынамыз. Маркетинг сайтына арналған қайталау емес, агент «қай бағытқа бара жатқанымызды» түсінетін қысқаша мәлімет.

2. Мен туралы (10 жол). Қалай ойлайтынымның цифрлық бейнесі - about-me/ бумасына сілтеме. Үн, құндылықтар, қағидалар, тыйым салынған сөздер. Claude «менің атымнан» мәтін жазғанда, үн сәйкес болуы үшін алдымен осы буманы оқиды.

3. Репозиторий құрылымы (20 жол). Түсіндірмелері бар ағаш: код қайда, бизнес контексті қайда, жоспарлар мен ой-толғаулар қайда. Бұл карта болмаса, Claude файлдарды әр жолы ретсіз іздейді.

4. «Қажетті ақпаратты қайдан табуға болады» кестесі (25 жол). «Сұрақ → файл» бағыттауы. Мысалы, жылжымайтын мүлік агенттігі үшін «ипотека шарттары керек → business/products/mortgage.md» немесе «жазбаларға арналған үн керек → business/assets/voice.md» деп көрсетуге болады. Бұларды өз файлдарыңызға ауыстырыңыз. Бұл кесте - CLAUDE.md файлының өзегі. Онсыз агент жауап қай файлда екенін болжайды. Ал кесте болса, бірден бастапқы дереккөзге өтеді.

5. Жобаның негізгі қағидалары (40 жол, 10-15 тармақ). Бұл бөлім біртіндеп толығып, ең көп күш талап етеді. Әр тармақ - нақты бір қатенің ізі. Мысалы, интернет-дүкенге арналған ережелер: «баға мен жеткізу мерзімін ешқашан кодқа тікелей жазба», «нақты бұйрықсыз өнімді жариялама» және «тауар сипаттамасын жарияламас бұрын бренд глоссарийіне сәйкестігін тексер». Бұл бөлім - «жоба конституциясы».

6. Операциялық жоспарлау (20 жол). «Пайдаланушының сөзі → әрекет» жұбын сәйкестендіретін триггерлер кестесі. Мысалы: «“аптаны жоспарла” десем, ops/monthly.md файлын ашып, осы аптаның файлын жаса». Осылай Claude командалардың мәнмәтінін түсінетін операциялық көмекшіге айналады.

7. Құралдар (5 жол). Технологиялар. Қысқа әрі артық сөзсіз.

8. Жариялау (15 жол). Өзгерістерді өндірістік ортаға жариялаудың қадамдық тәртібі: қай пәрмендерді қандай ретпен іске қосу және нені тексеру керек. Бұрын мұны әр жолы түсіндіретінмін. Енді Claude біледі.

9-12. Қауіпсіздік (35 жол). Төрт бөлек ішкі бөлім: .env файлын пайдалану ережелері, өндірістік дерекқорға қол жеткізу, демонстрацияларға арналған қауіпсіз пәрмендер (экран жазбалары, трансляциялар, скриншоттар - токендерді кездейсоқ жарияламау үшін) және құпияларды жаңарту ережелері.

13. plans/ бумасы (10 жол). Жоспар стандарты: файл атауы, кезең құрылымы және қорытынды блогында не жазылуы керек.

14. retrospectives/ бумасы (5 жол). Ой-толғау стандарты: үлгісі, файл атауы және мазмұны.

15. Жанды дерекқор деректері (15 жол). «Жаңа деректерді» белгілеу ережесі: файлдағы сандардың өзекті болуы керек делінсе, агент ескілерін қолданбай, дереккөзден жаңасын алады. Осылай Claude-тың кешегі сандарды қолдану қаупі жойылады.

16. Тіл (3 жол). «Әрдайым пайдаланушы қалайтын тілде жауап бер. Тек дефис қолдан, ұзын сызықшаны қолданба».

Барлығы шамамен 280 жол. Бұл ықшамдық мақсатынан асады, бірақ файлды жарамсыз етпейді. Осы мысалда ол пайдалы болып қалған; сақтау өлшенген контекстке және өкілдік тапсырма тексерулеріне тәуелді болуы керек. Кестелер мәтіннен автоматты түрде арзан токен болмайды.

/init пәрмені не істейді және неге ол жеткіліксіз?#

Anthropic құжаттамасында пәрменді былай сипаттайды:

/init жақсы орындайтын нәрселер:

• package.json, Cargo.toml және pyproject.toml файлдарынан құралдарды анықтайды.
• Құрастыру және тестілеу пәрмендерін тізімдейді.
• Бар файлдардағы конвенцияларды (.eslintrc, .prettierrc) байқайды.
• Cursor-дың (.cursorrules, .cursor/rules/) және Copilot-тың бұрыннан бар ережелерін тауып, тиісті бөліктерін қосады. CLAUDE_CODE_NEW_INIT=1 режимінде AGENTS.md файлын да табады.

/init істей алмайтын нәрселер:

• Клиентіңіздің кім екенін білмейді.
• Мәтінге арналған тыйым салынған сөздеріңізді қоспайды.
• Агент қателеріне қатысты ережелер қоспайды (өйткені қате әлі болмаған).
• Бизнес құрылымыңыз үшін «қажетті ақпаратты қайдан табуға болады» кестесін жасамайды.

Демек, дұрыс жұмыс тәртібі мынадай:

1. Claude Code-та /init іске қосыңыз

   Сіз құралдар мен пәрмендер жазылған 30-50 жолдық бастапқы CLAUDE.md аласыз. Бұл - техникалық негіз.

2. Осы мақаладағы үлгіні қосыңыз

   «5 минутта минималды CLAUDE.md» бөлімін пайдаланыңыз. Навигация, бағыттау және қағидалар бөлімдерін қосыңыз.

3. Шаршы жақшадағы өрістерді толтырыңыз

   Claude-қа «жобамды оқып, үлгіні толтыр» деген промпт беріңіз. business/ және about-me/ бумалары әлі болмаса, Claude нақтылаушы сұрақтар қояды.

4. Стресс-тест өткізіңіз

   Claude-қа: «CLAUDE.md файлымды оқып, агент ретінде мен қате түсінуіме әкелетін 10 екіұштылықты тап» деңіз. Түзетулер тізімін аласыз.

5. Содан кейін файлды күнделікті қолданыңыз

   Агент әр қате жіберген сайын бір жол қосыңыз. Бір айдан соң бизнесіңізге бейімделген, үнемі жаңаратын CLAUDE.md болады.

Төртінші қадамға арналған промпт:

Менде CLAUDE.md бар. Ертең соған сүйеніп функция жасаймын.

Міндетің - оған стресс-тест жүргізу. Сәтсіздікке ұшырауымыз мүмкін 10 себепті тап:

CLAUDE.md екіұшты болып, агент ретінде оны қате түсінуің мүмкін жерлер

ойдан мәлімет қосуға мәжбүр ететін олқылықтар

бір-біріне қайшы келетін ережелер

бір күнде істелетін жұмыстың көлемін асыра бағалайтын тұстарым

жұмыстың көлемін жете бағаламайтын тұстарым (бұл одан да жаман)

Жасырма. Қатаң сына. Бұл мәселелерді қазір, өндірістік ортада емес, тапқым келеді.
Соңында осы мәселелер туындамауы үшін нені және қалай өзгерту керегін нақты тізіп бер.

CLAUDE.md, AGENTS.md және MEMORY.md: 2026 жылы қайсысын кім оқиды?#

Жаңадан бастағандарды шатастыратын басты сұрақ: Claude Code AGENTS.md файлын оқи ма? 2026 жылғы қыркүйекке дейін жауап «жоқ» болатын: Anthropic құжаттамасы AGENTS.md файлын импорттайтын CLAUDE.md жасауды ұсынатын. 2026 жылғы 18 қыркүйекте шыққан 2.1.277 нұсқасынан бастап Claude Code AGENTS.md файлын өзі оқиды, бірақ жұмыс бумасында немесе одан жоғарыда CLAUDE.md, .claude/CLAUDE.md не CLAUDE.local.md болмаса ғана.

Жобада CLAUDE.md болса, Claude Code әдепкіде тек соны оқып, AGENTS.md файлын өткізіп жібереді. Мұны /config ішіндегі Project instructions бөлімінен өзгертуге болады: мысалы, claude-md-and-agents-md параметрі екі файлды да оқытады. Барлық нұсқада жұмыс істейтін тағы бір тәсіл бар: CLAUDE.md ішіне импорт қосу:

@AGENTS.md

## Claude Code

Басқа агенттерге қажет емес, тек Claude Code-қа арналған қосымша ережелер.

@filename синтаксисі басқа файлды импорттайды. Claude оны оқып, CLAUDE.md файлына қосып контекстке жүктейді. Claude Code AGENTS.md файлын өзі оқи алса да, импорт оны екі рет оқуға әкелмейді.

AGENTS.md қашан керек. Егер Claude Code-пен қатар Codex CLI, Cursor немесе Copilot қолдансаңыз, AGENTS.md файлын біртұтас негізгі дереккөз ретінде жасап, CLAUDE.md ішіне @AGENTS.md қосыңыз да, қажет болса Claude-қа тән ережелерді үстінен жазыңыз. Ондай ережелер болмаса, CLAUDE.md жасаудың қажеті жоқ: 2.1.277 нұсқасынан бастап Claude Code AGENTS.md файлын өзі оқиды. Тек Claude Code қолдансаңыз, AGENTS.md қажет емес, бір ғана CLAUDE.md жеткілікті. Барлық тәсілді қадам-қадамымен көру үшін бір жобада AGENTS.md және CLAUDE.md қолдану нұсқаулығын қараңыз.

MEMORY.md деген не? Жақында қосылған жаңарту бойынша Claude Code сіз туралы ескертпелерді ~/.claude/projects/<project-name>/memory/MEMORY.md файлына автоматты түрде сақтайды. Олардың ішінде сөйлесу әдеттері («пайдаланушы қысқа жауаптарды ұнатады»), жиі айтылатын тіркестер («кодтағы эмодзилерге тыйым салған») және мінез-құлық туралы байқаулар («macOS жүйесінде жұмыс істейді, zsh қолданады») болуы мүмкін.

Бұл - CLAUDE.md емес, бөлек жады жүйесі. Оны қолмен жазбайсыз; Claude әңгімелеріңізге сүйеніп өзі жазады. MEMORY.md ішінде ережеге айналуы тиіс нәрсе болса, оны CLAUDE.md файлына көшіріңіз. Қажетсіз не қате ақпарат болса, қолмен өшіре аласыз - бұл мәтіндік файл.

CLAUDE.md үшін қандай көлем пайдалы және ұзын файлды қалай тексеру керек?#

Claude Code-тың әр терезесінде контекстке бірнеше қабат жүктеледі: Anthropic жүйелік промпты (бағалау бойынша ондаған мың токен), CLAUDE.md файлыңыз, @ арқылы импортталған файлдар, MEMORY.md, ағымдағы чат тарихы және Claude ашатын файлдардың мазмұны. Мұның бәрі модельдің контекстіне сыюы керек (Sonnet үшін 200K токен, Opus үшін 1M).

CLAUDE.md үлкейген сайын ағымдағы жұмысқа орын аз қалады. 1,000 жолдық файл шамамен 8,000 токен болады және әр сессияда қайталанады. Pro жазылымында (тәжірибем бойынша, күніне шамамен 10-12 «ауыр» промпт) бұл мүмкіндігіңізді төрттен бірге қысқартады.

Шығын — бір мәселе ғана. Ұзын, қажетсіз не қайшы нұсқаулар орындалуды төмендете алады; сенімді орындалатын нұсқаулардың әмбебап саны жоқ. Маңызды ережелерді қолданатын бірнеше өкілдік тапсырманы сынап, ақауларды тіркеңіз және нысаналы түзетуден кейін әрекетті салыстырыңыз.

Файл көлеміне қатысты қарапайым ереже мынадай:

• 80–120 жол — қысқа жоба картасына ыңғайлы бастапқы аралық, кепілді орындалу ұпайы емес.
• 150–200 жол — қажеттілікті қарап, егжей-тегжейлі рәсімдерді сілтелген файлдарға шығаруды ойлауға белгі.
• 200–300 жол — токен көлемін, қайталануды және тапсырма нәтижесін тексеріңіз; жоғарыдағы 280 жолдық бизнес мысалы әлі жақсы жұмыс істеуі мүмкін.
• 400+ жол — файл жарамсыз деген дәлел емес, нысаналы шолуға салмақты себеп. Маңызды шектеулерді сақтап, сілтемелер мен ережелер істейтінін тексергеннен кейін ғана бөлшектерді шығарыңыз.

Жол саны жалғыз өзі табыс не ақауды анықтамайды. Өңдеуден кейін ойдан шығарылған орындалу пайызын бермей, сол өкілдік тапсырмаларды қайталап, маңызды ережелерді тексеріңіз.

Anthropic құжаттамасында тікелей қолдануға болатын тексеру ұсынады:

Мұны әр жолға қолданыңыз. «Бәрібір дұрыс істейтін еді» деген жауап шықса, жолды алып тастаңыз. CLAUDE.md - құжаттамаға, шешімдер тарихына немесе философияға арналған орын емес. Ол агенттің қате жібермеуі үшін қажет ережелерге ғана арналған.

CLAUDE.md файлын пайдасыз ететін 7 қате қандай?#

1-қате. «Жақсы инженер бол»

Ең жиі кездесетін қате. Адамдар CLAUDE.md ішіне жалпы тілектер жазады: «таза код жаз», «үздік тәжірибелерді қолдан», «аға инженер сияқты ойла».

Бұл сөздер ештеңені білдірмейді. Claude жалпы мағынада «таза кодты» онсыз да жазады. Мұндай жолдар шешімге әсер етпей, контекстті толтырады.

«Таза код жаз» дегенді «шегініске 2 бос орын қолдан», «TypeScript ішінде any қолданба» немесе «функциялар 30 жолдан ұзын болмасын» деп нақтылаңыз. Нақты әрі тексерілетін ереже жазыңыз.

2-қате. Claude білетін нәрсені қайталау

Тілдердің стандартты конвенцияларын сипаттау («JavaScript-те функциялар бірінші санаттағы нысандар», «TypeScript статикалық типтеуді қолданады»). npm, git немесе docker қалай жұмыс істейтінін түсіндіру.

Claude мұның бәрін оқыту кезінде үйренген. Оны CLAUDE.md ішінде қайталау ештеңе қоспайды, тек контекст орнын азайтады.

3-қате. CLAUDE.md ішіне ұзақ нұсқауларды қадам-қадамымен енгізу

«Жобаны қалай жариялау керек», «дерекқор миграциясын қалай жасау керек» немесе «жаңа компонентті қалай баптау керек» деген ұзақ нұсқаулар. Қадам-қадамымен жазылған ондаған жол.

Бұл ұзақ нұсқауларға арналған орын емес. Мұнда бір жолдық ережелер болуы керек. Ұзақ нұсқауларды skills/ бумасына (Claude Code-тың сұраныс бойынша жүктелетін бөлек тетігі) немесе docs/ ішіне салыңыз. CLAUDE.md ішінде бір жолдық сілтеме қолданыңыз: «Жаңа миграция жасағанда docs/migrations.md файлын аш».

4-қате. Кодтың автоматты анализаторы тексеріп қойған ережелер

«Нүктелі үтір қолдан», «пайдаланылмайтын импорттарды қалдырма», «var қолданба». ESLint, Prettier және Biome бұлардың бәрін анықтайды - бұлар линтерлер (кодты автоматты тексеретін құралдар).

Линтер детерминистік: іске қосылады, қатені табады және түзетеді. CLAUDE.md ішіндегі ереже ықтималдыққа тәуелді; агент оны ұмытуы мүмкін. Оны қайталаудың қажеті жоқ - линтерді баптау оңайырақ.

5-қате. Құпияларды CLAUDE.md ішінде сақтау

Мен тест тіркелгілерінің құпиясөздерін, құмсалғыштың API токендерін және аутентификациядан өткен басқару панеліне сілтемелерді көрдім. Осының бәрі git-ке коммиттелген және Anthropic моделінің контекстіне жүктелетін файлда болған.

Ешқашан олай істемеңіз. Құпиялар .gitignore ішіндегі .env файлына жатады. CLAUDE.md файлында ең көбі: «.env файлын толық оқыма; нақты айнымалыны тексеру үшін grep қолдан» деп жазыңыз.

6-қате. Алты ай бойы тазартылмаған, 500+ жолдық қоқыс алаңы

CLAUDE.md ұлғайып, docs/ ішіндегінің жартысын қайталайды, бірнеше жерде өзіне қайшы келеді, ал ешкім ішінде не барын есіне түсіре алмайды. Агент ережелердің көбін елемей бастайды. Команда «Claude нұсқауларды орындамайды» деп шағымданып, тағы ереже қосады да, жағдайды ушықтырады.

Қараусыз қалған CLAUDE.md белгілері: 300 жолдан ұзын, әртүрлі бөлімдерде қайталанатын ережелер, енді жоқ файлдарға апаратын ескірген сілтемелер және «2024 жылы мұны осылай шешіп едік, кейін ойымыздан қайттық» сияқты тарихи ескертпелер.

Шешімі: әр екі апта сайын Claude-тан Anthropic ұсынған «Бұл жолды алып тастасам, агент қате жіберер ме еді?» деген тексерумен файлды қарап шығуын сұраңыз. Жауабы «жоқ» болатындарын өшіріңіз.

7-қате. CLAUDE.md жасап, ұмытып кету

Бұл - алдыңғы қатенің кері көрінісі. Файл екі ай бұрын бір рет жасалған да, содан бері өзгермеген. Осы аралықта құралдар ауысты, жаңа бумалар қосылды, агенттер жаңа қателер жіберді. CLAUDE.md бұлардың ешқайсысын білмейді, өйткені оны ешкім жаңартпады.

Айқын белгісі: әр сессияда бір нұсқауды қайталайсыз. «X-ті істеме», «Y-ге тиме», «Z-ні ұмытпа». Егер мұны екі реттен көп қайталасаңыз, ереже сіздің басыңызда емес, CLAUDE.md ішінде болуы керек.

«Сессия соңында жаңарту» ережесімен CLAUDE.md файлын өздігінен үйренетін етуге бола ма?#

CLAUDE.md файлымда қысқа бөлім бар:

## Өздігінен үйрену

Әр сессия соңында мынаны тексер:
- Пайдаланушы немесе онымен жұмыс істеу тәсілі туралы жаңа нәрсе үйрендім бе?
- Енді жазып қою керек ережені бұздым ба?

Иә болса, `about-me/feedback/` ішінде мына пішімде файл жаса немесе жаңарт:
Ереже (бір жолдық ереже) → Неге (неге қосылды)
→ Қалай қолдану керек (қай кезде қолданылады).

Ережелерді өзім қолмен жазбаймын - «бұлай емес, себебі дұрысы осылай»,
деймін, ал сен оны файлға енгізесің.

Бұл бөлім CLAUDE.md ішіне қосылғаннан кейін Claude әр сессия соңында: «Жазып қоюға тұратын жаңа нәрсе болды ма?» деп сұрай бастады. Болса, ереженің жобасын ұсынатын, мен нақтылап, файл жасалатын.

Осылай екі ай жұмыс істегеннен кейін about-me/feedback/ ішінде екі оннан астам файлым болды - әртүрлі нақты қателерден алынған ережелер. Әр файл - Ереже → Неге → Қалай пішіміндегі бір бет. Бұл бума жеке қалауым мен тыйымдарымды сақтайтын «екінші жадқа» айналды.

Қате ережеге айналғандықтан қайталанбайды, ал ережелер жиналып, бірін-бірі нығайтады. Алты айдан кейін Claude жобамды бір ай үзілістен соң өзім есіме түсіргеннен де жақсы біледі.

CLAUDE.md ішіне құқық, маркетинг және операциялық ережелерді қалай қосуға болады?#

Көп команда үшін CLAUDE.md - таза техникалық құжат: құралдар, құрастыру пәрмендері, кодтау конвенциялары. Бұл пайдалы, бірақ құндылықтың үштен бірі ғана.

Кәсіпкер CLAUDE.md файлын жүргізсе, оған бизнеске қатысты бөлімдерді қосқан орынды. Ең маңыздысы - үшеуі:

Құқықтық ережелер (реттелетін нарықтарға арналған)

Егер реттелетін салада (қаржы, медицина, дәрі-дәрмек жарнамасы, балалар тауарлары) мәтін жарияласаңыз, тыйым салынған сөздердің заңдық маңызы бар, сондықтан олар CLAUDE.md ішінде нақты ереже ретінде жазылуы керек. Біреудің жадында да емес, редактор скриншотында да емес - агент әр сессияда көретін файлда.

Банк лицензиясы жоқ fintech жобасына мысал:

Редакциялық ескерту: Төменде нақты жобаға арналған ішкі ереженің пішімі берілген. Бұл көрсетілген терминдерді қолдануға берілген жалпы рұқсат емес: тұжырымның жарамдылығы қолданыстағы заңнама мен компания мәртебесіне байланысты.

🚨 МАҢЫЗДЫ - қаржыға қатысты сөздерді қолдануға тыйым салынады. Клиенттерге арналған материалдарда «депозит», «кепілді кіріс» немесе «инвестициялық өнім» сөздерін қолданбаңыз. Оның орнына «жинақ шоты», «күтілетін кіріс» және «өзгермелі мөлшерлемелі өнім» деп жазыңыз. Мұның себебі - осы жобада қаржы қызметтерінің жарнамасына қолданылатын құқықтық талаптар.

CLAUDE.md ішіндегі бұл блок қарапайым нәрсе істейді: Claude-тан клиенттерге арналған мәтін жазуды сұраған сайын, агент оны осы тыйымдармен салыстырады. Ереже болмаса, тыйым салынған сөздер әр үшінші науқанда кездеседі. Ереже болса, олардың бар екенін ұмытасыз.

Осы тәсілді мына салаларда да қолдануға болады:

• Медициналық жобалар (бірдеңені «емдейді» немесе «жазып жібереді» деген уәждерге жол бермеу).
• Дәрі-дәрмек жарнамасы («ең тиімді» деген уәждерге жол бермеу; міндетті ескертулерді қосу).
• Өз жарнама ережелері бар кез келген реттелетін сала.

Маркетинг стилі мен мәтін пішімі

Егер тұрақты түрде мәтін жарияласаңыз (әлеуметтік желілер, ақпараттық хаттар, сайттар), пішімді CLAUDE.md ішінде бір абзацпен сипаттаған жөн. Мессенджер арнасын жүргізетін блогер не агенттік былай жаза алады:

Арна жазбаларын жазғанда style/posts.md файлын қараңыз. Арнада рұқсат етілген пішімдеу белгілерін қолданыңыз және «қауіпті» арнайы таңбалардан аулақ болыңыз. Соңында мына конвенцияға сай UTM белгісі бар әрекетке шақыру қосыңыз: utm_source=<channel>&utm_medium=<type>&utm_campaign=<slug>.

Бұрын Claude жазбаларды «маркетинг сайтының жалпы стилінде» жазатын. Енді пішіміңізді ұстанады, UTM белгілерін қолданады және мәтіннің AI жазғаны аңғарылмайды.

Операциялық әдеттер

Триггерлер кестесі. Белгілі бір тіркесті айтқанда, агент қай файлдарды ашып, не істеу керегін біледі. Апта сайын жоспар құратын командаға арналған мысал:

«Аптаны жоспарла» → ops/monthly.md файлын аш, сол бумада YYYY-WNN.md файлын жаса және ops/backlog.md ішіндегі тапсырмаларды тиісті күндерге бөл. «Кезекте не бар?» → ops/backlog.md файлын оқып, тізім түрінде көрсет. «Аптаны жап» → ағымдағы апта файлының «Апта қорытындысы» бөлімін толтыр.

Осындай кестелермен Claude «код жазатын көмекшіден» бизнес күн тәртібін білетін «операторға» айналады. Әр дүйсенбіде «аптаны жоспарлайық» деймін, ал Claude қажетті файлдарды ашып, айлық мақсаттарды оқып, тапсырмаларды қалай бөлуге болатынын ұсынады.

CLAUDE.md файлын 12 тармақты тексеру тізімімен 5 минутта қалай тексеруге болады?#

1. Көлемі. Файл ықшам ба, шамамен 200 жолды өту/өтпеу шегі емес, шолу мақсаты деп қарайсыз ба?
2. Атауы. Бас әріптермен дәл CLAUDE.md деп атала ма, claude.md емес пе?
3. Орналасуы. Жоба түбірінде немесе ./.claude/CLAUDE.md ішінде ме?
4. Жоба сипаттамасы. Алғашқы 5 жолдан жобаның не екенін және кімге арналғанын түсінуге бола ма?
5. Құралдар. Технологиялар нақты әрі артық сөзсіз көрсетілген бе?
6. Құрылым. Түсіндірмелері бар репозиторий сызбасы бар ма?
7. Бағыттау. Жауапты қайдан табуға болатынын көрсететін «сұрақ → файл» кестесі бар ма?
8. Қағидалар. «Ешқашан» және «әрдайым» деп басталатын ережелері бар бөлім бар ма?
9. Нақтылық. Әр ережені тексеруге бола ма? («Әдемі жаз» емес, «2 бос орын қолдан».)
10. Өзін-өзі жаңарту. «Сессия соңында нені қосу керегін тексер» деген ереже бар ма?
11. Ой-толғау. «Сессия қорытындысын retrospectives/ ішінде жаз» деген ереже бар ма?
12. Қауіпсіздік. Маңызды тыйымдар (.env, rm -rf) .claude/settings.json ішінде де бар ма?

«Жоқ» деген жауабыңыз бесеуден көп болса, Claude-ты ашып, оған мына промптты беріңіз:

CLAUDE.md файлымды оқып, төмендегі тексеру тізімімен салыстыр. Әр тармақ бойынша: иә / жоқ / ішінара деп жауап беріп, нақты нені түзету керегін айт.

Тексеру тізімі:

Тапсырмаға жеткілікті ықшам; шамамен 200 жолда қарап шығу, қатаң шек деп санамау

Жоба сипаттамасы алғашқы 5 жолда

Құралдар нақты көрсетілген

Репозиторий құрылымының сызбасы бар

«Сұрақ → файл» кестесі бар

Қағидалар бөлімі ережелермен берілген

Әр ереже нақты әрі тексерілетін

«Сессия соңында жаңарт» ережесі бар

«Сессия соңында ой-толғау жаса» ережесі бар

Маңызды тыйымдар .claude/settings.json ішінде бар

Әртүрлі бөлімдерде бір ереже қайталанбайды

Енді жоқ файлдарға апаратын сілтемелер жоқ

Тексеруден кейін файлды қолданыста ұстайтын нақты өзгерістер тізімін бер.

CLAUDE.md-тен кейін нені қолданған жөн: Plan Mode, Skills әлде субагенттер ме?#

CLAUDE.md - іргетас. Ол жұмыс істеген соң, бірін-бірі нығайтатын Claude Code-тың үш механизмін қоса аласыз.

Plan Mode. Claude алдымен өзгерістер жоспарын құрып, сіздің мақұлдауыңызды күтетін, содан кейін ғана жұмысқа кірісетін режим. Оны Shift+Tab немесе /plan пәрменімен қосыңыз. Ол vibe coding-тегі басты мәселені шешеді: «Claude-тан бір нәрсені түзетуді сұрасам, ол жобаның жартысын қайта жазып шықты». Plan Mode-та бұл болмайды - агент файлдарға тимей тұрып, жоспарды көресіз.

Skills. .claude/skills/ бумасындағы белгілі бір тапсырма түріне арналған білімді қамтитын жеке .md файлдары. Мысалы, «дерекқор миграциясын қалай жазу керек» Skill-інде нақты рәсім, үлгі және мысалдар болады. Бұл білім CLAUDE.md ішінде жоқ, себебі тым көлемді. Claude «миграция жаз» деген тапсырма алғанда, тиісті Skill-ті жүктеп, соны орындайды.

Субагенттер. Тапсырмаға көп контекст қажет болса (мысалы, үлкен функцияны тексеру), Claude өзіне арналған таза контексте жеке субагентті іске қоса алады. Субагент жұмысты орындап, нәтижесін қайтарады, ал негізгі чаттың контекстін толтырмайды.

Үш механизм де CLAUDE.md файлын жұмысқа кірісу нүктесі ретінде қолданады: жұмысын бастарда жобаның контекстін түсіну үшін оны оқиды. Сондықтан үнемі жаңаратын CLAUDE.md болмаса, бұл функциялар да дұрыс жұмыс істемейді. Алдымен іргетас, содан кейін үстіңгі қабаттар.

Келесі қадам. Жоба түбірінде CLAUDE.md файлын жасап, осы мақаланың басындағы үлгіні көшіріңіз де, промпттың көмегімен шаршы жақшадағы өрістерді толтырыңыз. Содан кейін файлды қолданыңыз: агенттің әр қатесін бір жаңа жолға айналдырыңыз. Екі-үш аптадан кейін CLAUDE.md «жазып, ұмытып кеткен құжат» емес, Claude әр сессияда қарап отыратын файлға айналады.

Егер CLAUDE.md айналасында толық құрылым жасағыңыз келсе - екінші миға арналған business/ бумасы, цифрлық бейнеңізге арналған about-me/ бумасы, негізгі Skills және бапталған Plan Mode - осы мақаладағы қадамдар мен мысалдарды пайдаланыңыз. Ailoot нұсқаулықтары.

Ailoot-пен жалғастыру.